ClaudeMap

agent-skill-sync

扫描、分级并同步 Codex、Claude Code、Copilot、Gemini、Cursor、OpenCode 之间的 SKILL.md 技能库——每个 skill 给出 A/B/C/D 的诚实判定。

SDK 与工具skillssyncinventoryclimulti-agent

agent-skill-sync(命令名 skillsync)用来收拾散落在各家 agent 工具链里的技能库。它扫描所有源根目录——~/.codex/skills 及其 marketplace 插件缓存、~/.claude/skills、~/.copilot/skills、~/.gemini/skills、~/.cursor/skills、~/.config/opencode/skills——用自带的零依赖 YAML 子集解析器读 frontmatter,把每个 skill 归入四档迁移分类:A 可直接迁移,B 可迁移但缺外部依赖(现场探测 PATH、环境变量或配置路径),C 绑着别家 agent 的约定、需要改写,D 绑定源平台私有运行时、不值得迁。每个判定都附带理由,与目标目录的差分标记为 identical、drifted 或 missing。生成的 INDEX.md 与稳定的 inventory.json 给你的 agent 一份「永远是真的」本地工具复用索引。同步机制从构造上就防御:先 --dry-run 出计划,--force 会把漂移副本备份到 .skillsync-backup/、永不删除,.venv/、.env、node_modules/、__pycache__/ 永远不会被带走。零依赖——纯 Python 3.11+ 标准库——PyPI 包名 agent-skill-sync。

它做什么

  • 每个 skill 给出 A/B/C/D 四档迁移判定——可迁移、缺依赖、需改写、平台私有——每行都写明理由与缺失的依赖
  • 自动发现六个常见源根(Codex skills + marketplace 插件缓存、Claude Code、Copilot、Gemini、Cursor、OpenCode),可用 skillsync.toml 扩展
  • skillsync index 生成 INDEX.md + inventory.json,让手写的工具复用索引不再腐烂;check 把上游变化与上次快照做差分
  • 同步从构造上就安全:先 dry-run 出计划、强制更新先备份、永不删除、密钥与虚拟环境不进副本

什么时候用

同时用 Claude Code 和 Codex、Cursor、OpenCode 的开发者:skills 已经多到各处副本不一致、版本半新不旧——想先有一份总账和迁移方案,再动手复制。

如何上手

pipx install agent-skill-sync

skillsync status                 # 我有哪些 skill、各自什么状态
skillsync scan                   # 每个技能一行:档位、同步状态、缺失依赖
skillsync scan --category B      # 只看缺依赖的
skillsync index --out ./output --lang zh
skillsync check                  # 与上次快照做差分
skillsync sync --dry-run         # 永远先出计划
skillsync sync --categories A    # 只复制可迁移档

注意事项

默认同步目标是 ~/.workbuddy/skills——真正同步前要先在 skillsync.toml 里改成你自己的目标目录。分级是启发式且刻意保守的,D 档(平台私有运行时)永不迁移;把标签当第一遍筛查,不是终审。marketplace 插件缓存以 plugin:name 限定名呈现,撞名一眼可见。frontmatter 解析器只实现 skill 文件用到的 YAML 子集——遇到罕见写法会告警而不是崩溃。需要 Python 3.11+。MIT。

代码仓库

kina-cmd/agent-skill-sync

收录日期

地图上的相关资源

  • Harness Bridge

    SDK / 工具

    一个本地启动器:让 Claude Code 与其他七种编码 harness 直连任意 OpenAI / Anthropic / Responses 兼容端点——不改任何一行配置文件。

    • launcher
    • local-models
    • cli
    • menu-bar
  • Claude for Siri

    SDK / 工具

    用你已登录的 Claude Code 账号回答 macOS Spotlight 与 Siri 的提问——一个实验性的 macOS 27 模型委派提供者。

    • macos
    • siri
    • spotlight
    • model-delegation
  • 把十个 AI 编程助手的本地聊天记录提取成统一 JSONL——微调、分析,或赶在本地数据库被清空前备份多年的对话。纯标准库实现。

    • cli
    • data-export
    • jsonl
    • backup