book-to-skill
book-to-skill 是由 Virgilio Jr 开发的开源工具与智能体技能,旨在将厚重的技术专著、长篇文档目录或行业规范提炼为高度结构化的标准化 Agent Skill。面对几百页的 PDF,传统做法往往是全量塞入大模型上下文,导致智能体在每轮对话中反复检索目录和回溯上下文,产生高达数十倍的“探索循环税”(Discovery Loop Tax)。book-to-skill 则在初始阶段一次性完成深度解构与规约沉淀。
生成的技能包严格遵循开放的 Agent Skills 标准:核心为一个约 4,000 token 的主 `SKILL.md` 文件(记录核心心智模型与章节索引),辅以独立的章节细则(`chapters/*.md`)、术语表(`glossary.md`)、设计模式集(`patterns.md`)和决策速查表(`cheatsheet.md`)。关键在于,具体章节仅在提问涉及该主题时才被智能体按需读取,实测单次专业问答可节省 24 至 51 倍的 Token 消耗,且彻底避免了由于大文档注意力分散引起的幻觉问题。
该工具支持 PDF、EPUB、DOCX、Markdown、MOBI 等多种格式输入,支持通过 `npx skills add virgiliojr94/book-to-skill` 在 Claude Code、Codex、GitHub Copilot CLI 等环境中运行。需要注意的是,初始提炼环节需要对全书各章进行多轮深度解析,对长篇专著的首批转换耗时较长且 Token 成本显著。此外,排版复杂的多栏扫描件或低清 OCR 图文可能会出现断句碎片化或格式畸变。
功能特性
为什么选择它
权衡点
维护状况检查
- 最近提交
- 2026-11-03
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 0
- 最新发布
- v1.4.0 (2026-08-10)
- 未关闭 issue
- 27
- 近期 issue 至少有一条评论的比例
- 2/13
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #309 Proposal: slim down the installed skill payload (split runtime files from dev/site files)4 条评论 · 2026-10-27
- #169 The generator's own SKILL.md is 7k tokens with zero references — 52% of it loads before the run knows it can proceed2 条评论 · 2026-08-15
- #128 PDF: `pdftotext -layout` interleaves columns on multi-column documents, and the word-based token estimate hides the 26x size blowup3 条评论 · 2026-08-10
- #263 [bug] BeautifulSoup HTML/EPUB extraction inserts newlines inside inline headings and code tokens1 条评论 · 2026-10-01
- #259 [bug] Interrupted-run reuse accepts missing or corrupted extracted text1 条评论 · 2026-09-30
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
兼容性
快速开始
使用场景
同类工具
评论
暂无评论,来发表第一条吧