用途：按 $analyze、$plan、$implement、$code-review、$verify 的写法来编写技能，帮助创建、编辑、审计或精简 Claude、Codex、Cursor 的技能与规则文件，涉及 SKILL.md、.cursor/rules、AGENTS.md、frontmatter、references、scripts 等。
主要能力与写作规范：一个技能只做一件事，用祈使句，每行都应改变行为；正文一般控制在约 40 行以内，除非任务确实多分支；description 为 50–300 字符，先写能力，再写 Use when 与触发词；不写 README、changelog 或理论，不重复模型默认行为；references 仅用于正文放不下的平台或 schema 细节，并注明文件名与打开时机；仅用户使用的工作流设置 disable-model-invocation: true。
使用方式：先与用户确认 2–3 个触发提示词；选择平台，默认按路径判断（.claude → Claude，.agents → Codex，.cursor → Cursor），不明确时询问；先写 frontmatter，再写正文，结构为 inspect → act → return → stop；在技能根目录运行 bun ~/.agents/skills/skill-manager/scripts/inspect-description.ts。个人技能位于 ~/.agents/skills/<name>/；平台布局与 frontmatter 见 claude-code.md、codex.md、cursor.md，description 规则见 description-recommandation.md。
审计：逐行判断删除后是否改变行为，删除无效、重复和过时规则；陈述正向目标，仅将禁止项保留为硬性护栏。在线研究可用 $find-docs 查当前技术文档，用 $exa-search 做更广泛的网络研究。
限制与兼容：创建或重命名个人技能图标后，运行 bun ~/.agents/scripts/sync-codex-profile-icons.ts --install。~/.claude/skills 与 ~/.codex/skills 符号链接到 ~/.agents/skills，不要为 ~/.cursor/skills 建立符号链接。