关于 skill-manager
用于编写和审查 Claude、Codex 或 Cursor 技能的指南,提供确认触发条件、选择平台、编写指令和检查描述的简明流程。
主要功能
- 01平台选择指引
- 02确认触发条件的流程
- 03Frontmatter 与正文结构
- 04逐行审查技能内容
- 05技能描述检查命令
适用场景
- 01创建个人技能
- 02使技能适配目标平台
- 03删除冗余技能指令
- 04检查技能描述
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ melvynx/ aiblueprint --skill skill-manager安装后在 Claude Code 中输入/skill-manager确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlassets/codex-icon.svgreferences/claude-code.mdcodex.mdcursor.mddescription-recommandation.mdskill-writing-glossary.mdscripts/inspect-description.tssetup-codex-icons.ts详细介绍
按照 $analyze、$plan、$implement、$code-review 和 $verify 的写法编写技能。
目标
- 专注一项任务。使用祈使句。每一行都要改变行为。
- 正文控制在约 40 行以内,除非任务确实涉及多个分支。
- 描述为 50–300 个字符:先写能力,再写
Use when和触发词。 - 不写 README、变更日志或理论。不要重述模型默认行为。
- 仅在正文无法涵盖平台或架构细节时使用参考资料。注明文件名及何时打开。
- 仅面向用户的工作流:
disable-model-invocation: true。
编写
- 与用户确认 2–3 个触发提示词。
- 选择平台。根据路径设置默认值:
.claude→ Claude、.agents→ Codex、.cursor→ Cursor。不明确时询问。 - 先写 frontmatter,再写正文:检查 → 执行 → 返回 → 停止。
- 在技能根目录下运行
bun ~/.agents/skills/skill-manager/scripts/inspect-description.ts。
个人技能存放在 ~/.agents/skills/<name>/。平台目录结构和 frontmatter 参见:claude-code.md、codex.md、cursor.md。描述规则参见:description-recommandation.md。
审查
逐行检查:删除这一行会改变行为吗?删除无效、重复和过时的规则。明确正向目标;仅在硬性防护规则中保留禁止事项。
在线调研:使用 $find-docs 查找最新技术文档;使用 $exa-search 进行更广泛的网络调研。
创建或重命名个人技能图标后,运行 bun ~/.agents/scripts/sync-codex-profile-icons.ts --install。兼容性说明:~/.claude/skills 和 ~/.codex/skills 是指向 ~/.agents/skills 的符号链接。不要为 ~/.cursor/skills 创建符号链接。
评论
支持 Markdown