Local AI Skills Library 本地 AI Skills 中央库

Skillcaddy

One AISkills directory as the source of truth. Symlink what you need into any project or user-level scope — for Claude Code, Codex, OpenCode, Pi, and Hermes.

一个 AISkills 目录作为单一事实来源。按需 symlink 到任意项目或用户级作用域——同时服务 Claude Code、Codex、OpenCode、Pi 与 Hermes。

Get started 开始使用 View on GitHub 在 GitHub 查看

Node.js ≥ 20 Small dependency footprint 轻量依赖

Web + TUI Browser or terminal 浏览器或终端

v0.27.0 MIT License MIT 协议

Skillcaddy: load skills on demand instead of carrying every skill everywhere

Load skills on demand. Travel light. Grow fast.

按需加载 skills。轻装上路，快速成长。

The problem 问题

Skills drift when every project keeps its own copy. 每个项目各自拷贝 skill，版本迟早会漂移。

If you use multiple AI coding agents across repos, the same skill ends up in three places, slightly different each time. New projects mean more copies. Upstream updates never land.

当你在多个仓库里同时用 AI 编码 Agent，同一个 skill 会散落在三处，各自略微不同。新开项目就要再拷一遍；上游更新也跟不上。

Copy-paste drift

复制即漂移

The same skill lives in three repos, each a week behind the others.

同一个 skill 出现在三个 repo 里，彼此落后一周。

New project tax

新项目税

Every new repo starts with “which skills do I copy this time?”

每次新开仓库都要问：这次该拷哪些 skills？

Agent path chaos

Agent 路径混乱

Claude Code wants `.claude/skills`; others want `.agents/skills`.

Claude Code 要 `.claude/skills`，其他工具要 `.agents/skills`。

How it works 工作原理

One library. Explicit project, global, or Hermes links. 一个中央库。明确的项目、全局或 Hermes 链接。

Skillcaddy never copies skill files into projects. Enable creates an explicit project, shared Agents, or Hermes symlink; disable only removes that symlink. Sources stay safe.

Skillcaddy 从不把 skill 文件复制进项目。启用就是创建明确作用域的项目、全局 Agents 或 Hermes 软链接；禁用只删链接，源文件始终安全。

Collect sources

汇总来源

Aggregate official, github, personal, archived, and repo-bundled skills under one AISkills root.

把 official / github / personal / archived 与仓库内 skills 汇总到同一个 AISkills 根目录。

~/AISkills/
official/ github/
personal/ archived/

Enable by symlink

软链接启用

Point `/.agents/skills/`, `~/.agents/skills/`, or `~/.hermes/skills/` at the library skill.

把 `/.agents/skills/`、`~/.agents/skills/` 或 `~/.hermes/skills/` 指到库中 skill。

~/AISkills/github/…/tdd

.agents/skills/tdd project

~/.agents/skills/tdd global

~/.hermes/skills/tdd hermes

Sync Claude Code

同步 Claude Code

Project links can sync into `.claude/skills/`; global and Hermes enablement remain independent.

项目链接可同步到 `.claude/skills/`；全局和 Hermes 启用彼此独立。

.claude/skills/tdd
→ .agents/skills/tdd

Features 能力

Built for multi-agent workflows. 为多 Agent 工作流而建。

Claude Code Codex OpenCode Pi

One source of truth

单一事实来源

All skills live in your library. Projects only hold symlinks; verified library images carry sources and user-level enablements.

所有 skill 住在库里；项目里只保留软链接，经过验证的库镜像可携带来源与用户级启用状态。

Safe by default

安全默认

Disable removes only the symlink. Archived skills need explicit naming.

禁用只删软链接；archived 必须显式点名才启用。

Web manager

Web 管理器

Browse four enabled channel slots, search across project/global/Hermes entries, edit notes/tags, and review diagnostics in the browser.

在浏览器中浏览四个已启用通道、跨项目/全局/Hermes 搜索条目、编辑备注/标签，并查看诊断建议。

Terminal UI

终端 UI

Full keyboard-driven manager for headless or terminal-first workflows.

完整键盘驱动管理器，适合终端优先或无头环境。

Sidecar metadata

Sidecar 元数据

Notes, tags, and autoEnable live outside upstream skill repos.

备注、标签与 autoEnable 存在源仓库之外，不污染上游。

Diagnostics

诊断建议

Detect broken links, unmanaged entries, shadows, and duplicate names.

检测断链、未管理条目、别名遮蔽与库内重名。

Install 安装

One command. No build step. 一条命令装好。
无需构建。

Skillcaddy ships on npm and Homebrew. Run it once with npx, install it globally, or build it from a clone.

Skillcaddy 已发布到 npm 与 Homebrew。可用 npx 免安装试跑，也可全局安装，或克隆仓库从源码运行。

Web manager at 127.0.0.1:4173 Web 管理器默认 127.0.0.1:4173
From a clone, link the CLI once: npm run install:cli 克隆形态可一次挂载全局命令：npm run install:cli
Library stays in ~/.skillcaddy/library — reinstalls never touch your skills 原件库固定在 ~/.skillcaddy/library，重装升级不动已有 skill
Needs Node.js >= 20; macOS / Linux native, Windows needs Developer Mode 需要 Node.js >= 20；macOS / Linux 原生支持，Windows 需开启开发者模式

Open repository 打开仓库 Read the docs 阅读文档

terminal

# one-shot run — installs nothing
npx skillcaddy

# persistent global command
npm install -g skillcaddy
skillcaddy start ~/code/my-project

# Homebrew
brew install chenweil/tap/skillcaddy

# one-line installer
curl -fsSL https://raw.githubusercontent.com/chenweil/skillcaddy/main/scripts/install.sh | bash

# or build from source
git clone https://github.com/chenweil/skillcaddy.git
cd skillcaddy && npm install && npm start

# optional: install manager skill globally
npm run install:manager

Platforms 平台

Symlinks, done carefully. 认真对待软链接。

Directory symlinks are native on macOS and Linux. On Windows, enable Developer Mode or run with elevated privileges.

macOS 与 Linux 原生支持目录软链接。Windows 需开启开发者模式，或以提升权限运行。

Platform平台	Status状态	Notes说明
macOS	Supported支持	Native directory symlinks原生目录软链接
Linux	Supported支持	Native directory symlinks原生目录软链接
Windows	Setup required需额外配置	Developer Mode or Admin for `fs.symlink`需开发者模式或管理员权限以使用 `fs.symlink`

Next step 下一步

Stop carrying every skill into every project. 别再把全部 skill 背进每个项目。

Keep the library central. Enable only what the project needs. Update sources once, everywhere.

库集中管理，项目按需启用。源只更新一次，处处生效。

Star on GitHub 在 GitHub 点 Star Install commands 安装命令