cc-skills

集中管理 Claude Code / Codex / Hermes 的 skills。

原则

• 唯一真源：~/Documents/Projects/cc-skills/skills/
• 创建和修改只发生在这里，其他地方是副本或软链
• 全局目标：~/.claude/skills（rsync）、~/.codex/skills（软链）、~/.hermes/skills/custom（rsync）
• 项目目标：见 projects.json，按项目只推需要的 skill 到 <项目路径>/.claude/skills
• ~/.agents/skills、Codex .system、Hermes 内置分类均不处理
• 远程机器同步暂不支持

常用命令

分发全部（全局 + 项目）：
node --experimental-strip-types scripts/sync.ts

只推全局：
node --experimental-strip-types scripts/sync.ts --target global

只推项目：
node --experimental-strip-types scripts/sync.ts --target project

只推某个 skill：
node --experimental-strip-types scripts/sync.ts --only macos-ocr

先预览不执行：
node --experimental-strip-types scripts/sync.ts --dry-run

回滚到执行前状态：
node --experimental-strip-types scripts/restore.ts

备份在执行迁移前生成于 ~/.cc-skills-rollback/，restore.ts 按其中的 manifest.json 恢复。

新建 skill

在任意 agent 中触发 create-skill：

• Claude Code：/create-skill global my-skill 描述 或 /create-skill project my-skill 描述
• Codex / Hermes：直接说“用 create-skill 建一个 my-skill”

统一流程：在中央仓库生成 skills/<name>/ -> 按 scope 登记或分发 -> 自动运行 sync -> 测试。

SKILL.md 约定

• name、description 必需；task 型加 disable-model-invocation: true，reference 型不加
• Hermes 兼容字段：version、author、license、metadata.hermes.tags、related_skills
• 正文不超过 500 行，大内容放 reference.md，脚本用相对路径
• 模板参考 skills/create-skill/examples/skill-template.md

参考文献

• 我是这么管理 Skills 的（云谦和他的朋友们）：https://mp.weixin.qq.com/s/EBfw2AVhqOvUAaCFkfXXkw
• create-skill 参考实现（sorrycc/skills）：https://github.com/sorrycc/skills/tree/master/skills/create-skill