当你有多个 AI 编码 Agent:Skillshare 一条命令同步所有技能库
如果你同时使用 Claude Code、Codex、Cursor、OpenClaw 等多个 AI 编码工具,一定遇到过这个问题:在 Claude Code 里精心调教了一个技能(skill),切换到 Codex 或 Cursor 时却找不到它——只能重新创建或手动复制。随着 AI 编码工具越来越多,这种”技能碎片化”问题越来越严重。
Skillshare 正是为了解决这个问题而生的开源工具。它用一个统一的技能源目录,通过一条 skillshare sync 命令,将技能同步到 60 多个 AI 编码工具中。目前该项目在 GitHub 上已有 2300+ Star,采用 MIT 许可证,使用 Go 语言编写。
为什么需要 Skillshare
每个 AI 编码 CLI 工具都有自己的技能目录。Claude Code 的技能放在 ~/.claude/skills/,Codex 放在 ~/.codex/skills/,Cursor 又是另一个位置。你在一个工具中创建或修改了技能后,其他工具完全不知情。
传统做法无非几种:
- 手动复制:在多个目录之间来回复制文件,容易遗漏
- 各自维护:每个工具装各自的技能,重复劳动
- 脚本同步:自己写脚本做软链接,但各工具对技能格式支持不一
Skillshare 的方案很简单:将 ~/.config/skillshare/skills/ 作为统一的技能源,然后用软链接(macOS/Linux)或 NTFS Junctions(Windows)同步到各个目标工具。编辑源目录中的技能文件后,运行 skillshare sync 即可同步到所有目标。
| 对比维度 | 传统做法(逐个安装) | Skillshare |
|---|---|---|
| 技能来源 | 各自独立复制 | 单一源 → 软链接同步 |
| 换新机器 | 重新逐个安装 | git clone 配置 + sync |
| 安全检查 | 无 | 内置 audit,安装时自动扫描 |
| Web 面板 | 无 | skillshare ui |
| 运行时依赖 | Node.js + npm | 无(单一 Go 二进制) |
安装与快速上手
安装
Skillshare 的安装非常简单,一行命令搞定:
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh brew install skillshare skillshare upgrade
Windows 用户可以用 PowerShell:
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
快速开始
安装完成后,只需两步即可开始使用:
skillshare init skillshare sync
skillshare init 会自动检测你已安装的 Claude Code、Codex、OpenClaw、Cursor 等工具,并为它们创建对应的目标配置。之后你只需要在 ~/.config/skillshare/skills/ 目录中放你的技能文件,然后运行 skillshare sync 就可以了。
简写别名
如果你经常使用,可以添加别名:
alias ss='skillshare'
核心功能详解
从 Git 仓库安装/更新技能
Skillshare 支持直接从 GitHub、GitLab、Bitbucket、Azure DevOps 等 Git 托管平台安装技能包:
skillshare install github.com/reponame/skills skillshare update --all skillshare target claude --mode copy skillshare sync
安全管理
Skillshare 内置了安全审计功能,可以在技能到达你的 AI 编码 Agent 之前扫描潜在风险:
skillshare audit
这个功能在安装新技能时自动执行,确保来自第三方的技能不会对你的开发环境造成危害。
项目级技能(Project Skills)
团队协作场景下,你可以在项目仓库中维护项目专有技能:
skillshare init -p && skillshare sync
项目模式会在仓库中创建 .skillshare/ 目录,其中的技能会随着代码一起提交到 Git 仓库,团队成员 clone 后只需运行 skillshare sync 即可获得相同的技能集。
代理(Agents)同步
除了技能,Skillshare 还支持同步自定义的 Agent 配置:
skillshare sync agents skillshare sync --all
额外资源(Extras)
如果你需要管理规则、命令、提示词等非技能文件,Skillshare 的 extras 功能可以帮你:
skillshare extras init rules skillshare sync --all skillshare extras collect rules
本地版本管理
不想推送到远程仓库?Skillshare 支持本地 checkpoint:
skillshare commit -m "更新代码审查技能" skillshare commit --dry-run # 预览将要提交的变更
Shell 自动补全
Skillshare 支持 bash、zsh、fish、powershell、nushell 的自动补全:
skillshare completion bash --install
细粒度过滤
你还可以通过 .skillignore 文件精确控制哪些技能同步到哪些目标:
echo "internal-skills/" >> ~/.config/skillshare/.skillignore
或者在 SKILL.md 的元数据中指定 targets 字段,以及在每个目标配置中设置 include/exclude 规则。
Web 仪表盘
除了 CLI 操作,Skillshare 还提供了一个 Web 面板,方便可视化查看和管理技能:
skillshare ui
Web 界面中你可以浏览已安装的技能列表、查看安全审计结果、管理目标配置,适合不习惯命令行的团队成员使用。
适用场景
个人开发者:如果你同时使用 Claude Code 和 Codex,Skillshare 可以让你在一个地方编辑技能,两个工具同时生效。编辑源文件后运行 skillshare sync,变更立刻同步到所有目标(软链接模式下甚至不需要运行 sync——编辑即同步)。
团队协作:通过项目模式,团队成员共享同一套技能配置,新人加入时只需 git clone + skillshare sync,无需逐个安装技能。组织级技能可以通过 Git 仓库统一管理,修改后全员自动同步。
CI/CD 流水线:Skillshare 提供了 GitHub Actions,可以在 CI 环境中自动同步技能:
- uses: runkids/setup-skillshare@v1
with:
source: ./skills
- run: skillshare sync
与同类工具对比
相比传统的逐个安装方式,Skillshare 的核心优势在于:
- 单一事实源:所有技能只有一个来源,不存在多份副本不同步的问题
- 零运行时依赖:Go 编译的单一二进制,不需要 Node.js 或其他运行时
- 内置安全审计:安装和更新时自动扫描,及时发现提示注入等威胁
- 跨平台一致体验:macOS、Linux、Windows 统一使用方式
总结
如果你正在多个 AI 编码 Agent 之间切换工作,Skillshare 能从根本上解决技能碎片化的问题。它的安装简单、功能完善、社区活跃,是管理 AI 编码工具技能集的理想选择。从个人使用到团队协作,从命令行到 Web 面板,Skillshare 提供了一套完整的技能管理方案。
相关链接