skill-loop

在多个 AI 助手工具之间自动同步技能（Skills）。

Languages / 语言

• English
• 中文说明

问题

您可能安装了 40 多个 AI 编程助手，每个助手都有自己的技能目录：

| 工具 | 默认技能目录 | |------|-------------| | Claude Code | ~/.claude/skills/ | | Codex | ~/.codex/skills/ | | Cursor | ~/.cursor/skills/ | | Gemini | ~/.gemini/skills/ |

当您创建或更新某项技能时，必须手动将它复制到每一个助手中。这不仅繁琐，而且容易出错。

解决方案

skill-loop 采用 星型拓扑（Hub-Spoke） 模型，默认以 符号链接（Symlinks） 作为同步机制：

~/skills-hub/              ← Git 仓库，唯一事实源
└── skills/                ← 全局技能（同步分发到所有工具中）

~/.claude/skills/check@  → 软链接 → ~/skills-hub/skills/check
~/.gemini/skills/check@  → 软链接 → ~/skills-hub/skills/check

只需在 Hub 仓库中修改一次，所有工具的技能均会实时同步生效。

安装

npm install -g skill-loop
# 或者
pnpm add -g skill-loop

快速上手

# 1. 初始化您的技能仓库 (Hub)
skill-loop init

# 2. 录入一项新技能
skill-loop add ./my-skill

# 3. 检查各 Agent 工具的同步状态
skill-loop status

# 4. 同步分发到所有工具
skill-loop sync

# 5. 把 claude 中的所有 skills 同步到 hub 并且同步给所有的 agent
skill-loop onboard claude

常用命令

| 命令 | 描述 | |---------|-------------| | init | 初始化 ~/skills-hub 技能仓库并自动导入已有技能，可过滤不需要导入的 skill 目录 | | add <path> | 往 Hub 中添加一个技能并同步到各个 Agent 工具 | | remove <skill> | 从 Hub 及所有 Agent 工具中物理移除某项技能 | | list | 交互式浏览 Hub 中的所有技能（按 ESC 可返回/退出） | | status | 展现所有 Agent 工具目录下的技能同步状态 | | sync | 全量同步状态（补齐缺失的软链/拷贝，修复损坏链接） | | onboard [tool] [skill] | 将 Agent 本地开发的物理技能收录进 Hub（默认作为全局技能），支持交互式勾选，并自动联动触发 sync 分发至所有已启用工具。 |

onboard 命令的智能参数

| 用法 | 行为 | |------|------| | skill-loop onboard | 自动扫描所有已启用工具目录下的全部本地技能，并弹出复选框让您挑选收录 | | skill-loop onboard claude | 只扫描并交互式收录 Claude Code 里的本地技能 | | skill-loop onboard my-skill | 若 my-skill 不是工具名，则在所有工具目录下搜索并直接收录该技能 | | skill-loop onboard claude my-skill | 精准直接收录：指定工具 + 指定技能 |

安全裁剪 (Prune)

运行 skill-loop sync --prune 可以查找并交互式删除本地那些未被 Hub 托管的多余技能。它会展示候选列表，并在用户输入 y 确认后才进行安全清除。

同步模式

| 模式 | 机制 | 适用场景 | |------|------|---------| | symlink（默认） | 符号链接 | 支持 symlink 的工具，零延迟同步 | | copy | 文件拷贝 | 不支持符号链接的环境（如旧版 Cursor） |

可在 .skills-sync.toml 中为不同工具分别配置：

[[tools]]
name = "cursor"
skillsDir = "~/.cursor/skills"
mode = "copy"  # 拷贝模式

配置

Hub 目录下的 .skills-sync.toml 配置规范示例：

version = "1"

[hub]
path = "~/skills-hub"
autoCommit = true

[sync]
defaultMode = "symlink"
prune = false

[[tools]]
name = "claude"
skillsDir = "~/.claude/skills"
enabled = true

内部开发

pnpm install
pnpm test
pnpm build
pnpm lint

项目结构

src/
├── cli.ts              # 命令行入口 (Commander)
├── types.ts            # TypeScript 核心类型定义
├── commands/           # 具体子命令实现
│   ├── init.ts
│   ├── add.ts
│   ├── remove.ts
│   ├── list.ts
│   ├── status.ts
│   ├── sync.ts
│   └── onboard.ts
├── config/             # 配置管理
│   ├── loader.ts
│   └── schema.ts
├── sync/               # 同步引擎核心
│   ├── operations.ts   # 软链/拷贝/删除底层文件系统操作
│   └── status.ts       # 状态检查评估器
├── utils/
│   └── skill-meta.ts   # SKILL.md 解析
└── discovery.ts        # Agent 工具自动发现引擎

License

MIT