Your local AI skill manager.
SKBro 是一个本地优先、零服务依赖的 AI Skill 管理工具，用来创建、安装、搜索、使用、更新和分享 Skill。
- 支持完整 Skill 目录和单个 Markdown 文件；
- 支持本地目录、ZIP、HTTP URL 和 Git 仓库；
- 支持软链接和复制两种项目使用方式；
- 内置 Codex、Claude 和通用项目目录；
- 可以把 Skill 打包成 ZIP 分享；
- 本地 JSON 存储，无账号、数据库或后台服务；
- 核心只使用 Python 标准库。
需要 Python 3.10 或更高版本。
推荐使用：
pipx install skbro或：
uv tool install skbropipx install "git+https://github.com/AuCf/skbro.git"git clone https://github.com/AuCf/skbro.git
cd skbro
pipx install .开发时也可以直接运行：
python -m skbro --help验证安装：
skbro --version
skbro --help更新或卸载：
pipx upgrade skbro
pipx uninstall skbro创建一个 Skill：
skbro create api-reviewer \
--description "Review API designs" \
--tags api,review生成：
api-reviewer/
├── SKILL.md
└── skill.json
安装并用于当前项目：
skbro add ./api-reviewer
skbro use api-reviewer默认位置：
.skills/api-reviewer/
用于 Codex 或 Claude：
skbro use api-reviewer --target codex
skbro use api-reviewer --target claude# 本地目录或 Markdown
skbro add ./my-skill
skbro add ./my-skill.md --name my-skill
# ZIP
skbro add ./my-skill-1.0.0.zip
# HTTP URL
skbro add https://example.com/my-skill-1.0.0.zip
# Git
skbro add https://github.com/example/my-skill.git
skbro add https://github.com/example/my-skill.git --ref v1.0.0skbro list
skbro search API
skbro info api-reviewer
skbro status
skbro update api-reviewer
skbro unuse api-reviewer
skbro remove api-reviewer
skbro doctor不指定名称时，skbro update 会更新所有有来源记录的 Skill。
默认使用软链接。中央 Skill 更新后，项目立即生效：
skbro update api-reviewerWindows 无法创建软链接，或希望项目保留完整副本时：
skbro use api-reviewer --copy复制模式更新后需要同步：
skbro status
skbro sync api-reviewer如果项目副本被人工修改，sync 和 unuse 会拒绝覆盖或删除；确认放弃修改时使用 --force。
skbro pack api-reviewer会生成：
api-reviewer-0.1.0.zip
对方安装：
skbro add ./api-reviewer-0.1.0.zip也可以把 Skill 目录放进独立 Git 仓库分享。
最小格式：
my-skill/
└── SKILL.md
推荐格式：
my-skill/
├── SKILL.md
├── skill.json
├── scripts/
├── references/
└── assets/
skill.json 示例：
{
"schema_version": 1,
"name": "api-reviewer",
"version": "1.0.0",
"description": "Review API designs",
"note": "用于检查接口一致性、安全性和可维护性",
"tags": ["api", "review"],
"author": "Your Name",
"license": "MIT",
"entry": "SKILL.md"
}skbro config
skbro config set link_mode copy
skbro config set default_target codex
skbro config set target.cursor .cursor/skills默认数据目录：
~/.skbro/
├── config.json
├── registry.json
└── skills/
测试或多环境使用时，可设置 SKBRO_HOME。
skm命令继续作为兼容别名；SKM_HOME环境变量继续可用；- 已存在
~/.skill_manager时会继续使用，不会丢失原数据； register/link/unlink旧命令继续可用；- 旧版单 Markdown registry 可以继续读取。
python -B -m unittest discover -s tests -v测试覆盖本地生命周期、旧版兼容、Markdown 转换、ZIP/HTTP/Git 安装、更新同步、修改保护、路径安全和健康检查。