skill-hub 是面向 AI 编程工具的 skill 生命周期管理工具。它用 Git 仓库管理可复用的 Prompt、脚本和工作流说明，并把这些 skill 分发到项目工作区或本机全局 agent skills 目录。
- 管理多个 skill 仓库，支持查看、搜索、同步和切换默认归档仓库。
- 在项目中启用 skill，并应用到标准目录
.agents/skills/。 - 检查项目 skill 是否与来源仓库一致，识别基于旧版本发生的本地修改，并刷新
Outdated的本地副本。 - 将项目中改进过的 skill 反馈回默认仓库；当工作区版本低于仓库版本时会先阻断反馈，避免旧副本覆盖高版本仓库内容。
- 将托管 skill 启用到本机全局 agent skills 目录，服务 Codex、OpenCode、Claude 等工具。
- 支持已有 skill 登记、批量导入、验证、重复副本检测、路径可移植性审计和刷新审计报告。
- 支持本地
serve模式，为 CLI 和 Web 管理提供统一的本机执行入口。 - 支持从 GitHub Releases 检测和升级已安装的
skill-hub。
推荐使用一键安装脚本：
curl -s https://raw.githubusercontent.com/muidea/skill-hub/master/scripts/install-latest.sh | bash安装后检查版本：
skill-hub --version已安装用户可检测和升级到最新 Release：
skill-hub upgrade --check
skill-hub upgrade --yes更多安装方式、环境变量和故障排查见 INSTALLATION.md。
在需要使用 skill 的项目目录中初始化：
skill-hub init同步仓库并查找可用 skill：
skill-hub repo sync --json
skill-hub list
skill-hub search git启用并应用 skill：
skill-hub use --pattern git-expert
skill-hub apply
skill-hub status只刷新一个已启用 skill：
skill-hub apply --pattern git-expert
skill-hub status --pattern git-expert将项目中的改进反馈回默认仓库：
skill-hub feedback --pattern git-expert --dry-run
skill-hub feedback --pattern git-expert --force
skill-hub push --dry-run --jsonfeedback 只用于标准项目工作区 .agents/skills/<id>。发布包内置或其他批量 skill 目录使用 import --archive --archive-only 归档，不要手工复制到 ~/.skill-hub/repositories/.../skills。
如果 status 显示 ModifiedAgainstOutdatedRepo，先执行 skill-hub apply --pattern <id> 刷新到仓库高版本，再把必要修改迁移到新版本后反馈。
如果希望某个 skill 对本机 agent 全局可用，可以使用 --global：
skill-hub use --pattern git-expert --global --agent codex
skill-hub status --global
skill-hub apply --global --dry-run
skill-hub apply --globaluse --global 只记录期望状态，apply --global 才会刷新本机 agent 全局 skills 目录。
创建新 skill：
skill-hub create my-skill
skill-hub validate --pattern my-skill --links
skill-hub feedback --pattern my-skill --force登记已有项目 skill：
skill-hub register existing-skill
skill-hub validate --pattern existing-skill --fix批量导入和归档：
skill-hub import .agents/skills --fix-frontmatter --archive --force
skill-hub import agent-skills --archive --archive-only --force
skill-hub repo rebuild-index检查重复副本和路径可移植性：
skill-hub dedupe . --canonical .agents/skills --json
skill-hub lint . --paths --project-root "$PWD" --json启动本地服务：
skill-hub serve历史版本变更请查看 GitHub Releases。仓库内可能保留用于发布流程的版本说明文档，但 README 只维护长期有效的入口文档。
MIT License，详见 LICENSE。