如何把你的book-to-skill技能发布到GitHub：npx skills add跨宿主安装完整教程

如何把你的book-to-skill技能发布到GitHubnpx skills add跨宿主安装完整教程【免费下载链接】book-to-skillTurn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.项目地址: https://gitcode.com/GitHub_Trending/bo/book-to-skillbook-to-skill 是一款免费开源的书籍转 AI Agent 技能工具能把任何技术书籍PDF、EPUB、DOCX、Markdown 等提炼成结构化的 Agent Skill随查随用、按需加载章节。生成技能后你还能把它一键发布到自己的 GitHub 仓库——之后在任何支持的宿主Claude Code、GitHub Copilot CLI、Amp、Hermes Agent 等里用一条npx skills add命令即可安装。本教程带你走完本地生成 → 发布 → 跨宿主安装 → 更新维护的完整流程。生成技能之前先认识产物长什么样在宿主会话中运行一次转换/book-to-skill ~/books/my-book.pdf my-book转换完成后你的技能目录如~/.claude/skills/my-book/里会生成一套文件文件作用SKILL.md核心框架 章节/主题索引约 4,000 tokenschapters/ch01-*.md每章一个文件按需加载不占常驻预算glossary.md术语表按字母排序并标注出处章节patterns.md技术、算法与设计模式清单cheatsheet.md决策表与速查规则更多输入方式文件夹、glob、多文件合并见 docs/usage.md。前置步骤安装 book-to-skill 转换器跨宿主安装的前提是先让转换器在你的机器上跑起来。它遵循开放的 Agent Skills 标准安装一次、多宿主通用。方式一git clone 到对应宿主目录推荐新手git clone https://gitcode.com/GitHub_Trending/bo/book-to-skill ~/.claude/skills/book-to-skill不同宿主对应的技能目录如下宿主 Agent个人技能目录GitHub Copilot CLI~/.copilot/skills/Claude Code~/.claude/skills/Amp / OpenAI Codex跨 Agent~/.agents/skills/Hermes Agent$HERMES_HOME/skills/category/各宿主的完整安装方式与可选解析器说明见 docs/install.md。一键发布把技能推上 GitHub技能生成后你只需对 Agent 说publish它就会按 SKILL.md 的 Step 11 流程自动完成发布检查ghCLI是否已安装并登录未装会提示你先安装登录单独询问可见性——Private or public repository?默认按private创建执行git init→ 提交 →gh repo create 仓库名 --private --source . --push创建仓库并推送。三个值得了解的安全设计 可见性门禁仓库可见性是一个独立的封闭式问题只有你的回答恰好是单词public才会创建公开仓库。这本书是公有领域的之类的句子描述的是书籍版权不会导致仓库被公开该规则由 tests/test_publish_visibility_gate.py 回归测试锁定版权闸门由第三方版权书籍生成的技能必须保持私有只有你自己的写作、开放许可内容或你明确确认有公开授权的内容才可以设为 public发布前扫描发布前会先运行 tools/scan_generated_skill.py 安全扫描未通过则停止发布。没有ghCLI走手动路径在 GitHub 网页端新建一个私有空仓库然后在技能目录执行git init -b main git add -A git commit -m Add my-book skill git remote add origin 你的仓库地址 git push -u origin main跨宿主安装一条 npx skills add 命令发布的技能目录就是skillsCLI 能直接识别的标准结构根级SKILL.md无需任何改造。在任何一台机器上执行npx skills add 用户名/仓库名 --skill 技能slugCLI 会自动解析仓库、识别根目录的SKILL.md把完整技能含 scripts/extract.py 提取脚本与 tools/ 工具安装进你选择的宿主的技能目录。安装后验证宿主生效方式GitHub Copilot CLI/skills reload然后/skills list查看Claude Code / Amp重启会话Hermes Agent开启新会话装好后就能直接使用了/my-book # 加载核心框架 /my-book replication # 按主题定位相关章节 /my-book ch05 # 直接读第 5 章后续更新让发布的技能持续进化 技能不是一次性产物。往同一个技能目录再喂新材料就会触发Update/Fold-in模式新章节自动续编号术语表、模式清单、主SKILL.md索引全部增量合并流程见 docs/usage.md。由于本地技能文件夹就是远端仓库的 git 工作副本更新完成后 Agent 会主动询问是否提交并推送——推上去后其他机器重新执行npx skills add即可拿到最新版。常见问题 FAQ发布技能收费吗不收费只是在你自己的 GitHub 账号下创建仓库并推送 Markdown 文件。私有仓库别人装不了怎么办可以把私有仓库设为公开反之则不可逆但请记住版权闸门——第三方版权书生成的技能建议保持私有仅限团队内有权限的人访问。技能太大加载慢吗不会。章节文件按需加载只有你问到对应主题时才会读取常驻开销只有SKILL.md的约 4,000 tokens。更多细节可查阅 docs/faq.md 与 docs/how-it-works.md。【免费下载链接】book-to-skillTurn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.项目地址: https://gitcode.com/GitHub_Trending/bo/book-to-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考