Agent Skills › anomalyco/hex › hex-personal-commands

hex-personal-commands

GitHub

用于配置 Hex 语音应用的个性化文本转换规则,通过编辑 hex.config.ts 定义纯函数转换逻辑,支持校验与错误排查。

skills/hex-personal-commands/SKILL.md anomalyco/hex

Trigger Scenarios

用户想要添加或修改 Hex 语音应用的自定义文本转换规则 用户需要配置 Hex 的个人化转录后处理逻辑

Install

npx skills add anomalyco/hex --skill hex-personal-commands -g -y
More Options

Use without installing

npx skills use anomalyco/hex@hex-personal-commands

指定 Agent (Claude Code)

npx skills add anomalyco/hex --skill hex-personal-commands -a claude-code -g -y

安装 repo 全部 skill

npx skills add anomalyco/hex --all -g -y

预览 repo 内 skill

npx skills add anomalyco/hex --list

SKILL.md

Frontmatter
{
    "name": "hex-personal-commands",
    "license": "MIT",
    "description": "Configure Hex personal deterministic transcript transformations in `~\/.config\/hex\/hex.config.ts`. Use when the user wants to add or change custom text transformations for the Hex voice app."
}

Hex Personal Transformations

This skill targets current Hex (dev builds now, and the next stable release). Hex 2.3.1 uses an older runtime; its matching skill installs with npx skills add anomalyco/hex#app-v2.3.1 --skill hex-personal-commands.

Hex runs ~/.config/hex/hex.config.ts itself, in an embedded JavaScript engine. There is no package to install and no build step.

  1. Check for ~/.config/hex/hex.config.ts (or hex.config.js). If it is missing, ask the user to open Hex's Modes pane and choose Create Config, or run hex commands init if the hex CLI is available.
  2. Read ~/.config/hex/AGENTS.md for the current API and limits, and hex.d.ts for exact types. Hex owns both and rewrites them; do not edit them.
  3. Edit only the config and files it imports. Scripts are plain TypeScript or JavaScript: they can import @hex/commands and files in the folder, not npm packages, Effect, or Node APIs, and they have no filesystem, network, or timer access. Enums, namespaces, and constructor parameter properties are rejected.
  4. Use defineHexConfig from @hex/commands and declare pure transformations entries ({ id, name, description?, transform(text, context) }).
  5. Transformations must be selected in the mode's Transformations section. They run after mode corrections and optional AI rewriting, not for meetings.
  6. Run hex commands check (macOS) after editing. It loads the config as Hex does and prints what it registers or the error with file, line, and column. Optionally type-check with npx -y -p typescript tsc in ~/.config/hex. A running Hex reloads the config on save and shows load errors in Modes' Transformations section. If hex reports commands check as an unrecognized subcommand, stop: the user is on an older Hex (such as 2.3.1). Tell them to install the matching skill with npx skills add anomalyco/hex#app-v2.3.1 --skill hex-personal-commands, or to switch to the dev build (https://github.com/anomalyco/hex#downloads).

Completion criterion: the requested behavior is represented in the config, hex commands check succeeds (or, without the CLI, the reload succeeded in Hex), and any verification gap is reported.

Version History

  • 49de3e1 Current 2026-11-07 08:55

Dependencies

  • suggested anomalyco/hex#app-v2.3.1

Metadata

Files
0
Version
49de3e1
Hash
119fa71a
Indexed
2026-11-07 08:55

trang chủ - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-08 03:34
浙ICP备14020137号-1