skillreg

本地 AI Agent Skill 管理工具

English

skillreg 用来管理本地 AI Agent Skills。你可以把任意项目里写好的 SKILL.md 注册到统一 workspace，再同步到 Claude、Codex、CodeBuddy 或 ~/.agents/skills 等 agent skill 目录。

能力

• CLI：创建/切换 workspace，注册/转换 skill，管理 targets/projects，执行 sync，查看 diff，启动 dashboard。
• Skill：内置 skillreg-skill，让 agent 在任意项目里识别本地 SKILL.md 并注册到当前 workspace。
• Dashboard：提供图形入口，可导入 skill、切换 workspace、管理同步目标、查看 Diff、按项目组批量同步、查看仓库状态/依赖图/Git 记录。

安装与使用

uv tool install skillreg
skillreg workspace create ~/my-skills
skillreg register /path/to/my-skill
skillreg target add ~/.codex/skills
skillreg sync execute --target ~/.codex/skills
skillreg dashboard open

Dashboard 默认打开：

http://127.0.0.1:28787

常用命令：

skillreg config
skillreg workspace create <path>
skillreg workspace current
skillreg workspace switch <path>
skillreg register <path> [--force] [--name name]
skillreg list
skillreg convert <name>
skillreg target list
skillreg target add <path>
skillreg sync status
skillreg sync execute --target <path> [--skill name]
skillreg project create --name <name> --target <path>
skillreg sync execute --project <name>
skillreg diff <skill> --target <path>
skillreg submodule list
skillreg dashboard start
skillreg dashboard status
skillreg dashboard stop
skillreg dashboard open --no-browser

开发

git clone https://github.com/fcraft/skillreg.git
cd skillreg
uv sync --extra dev
scripts/install-git-hooks.sh
uv run pytest -q
uv run --with ruff ruff check src/ tests/ scripts/

版本号由 pyproject.toml、src/skillreg/__init__.py 和内置 skillreg-skill 共同校验。安装 git hook 后，在 main 分支提交时会自动 bump x.y.z 版本：feat: 提交使 y + 1，其他提交使 z + 1，并把 x 固定为 1。

本地发版：

scripts/release.sh

脚本会读取当前版本，创建并推送 v<version> tag，随后由 GitHub Actions 发布到 GitHub Release 和 PyPI。

Contributors

Trend

License

MIT