用途：把已存在于磁盘上的书面资料编译成智能体可按需加载的技能知识库，提取结构而非摘要，产出常驻核心、逐章文件与索引。
主要能力：生成 SKILL.md（核心框架、章节索引、主题索引，常驻小于 4000 tokens）、chapters/chNN-*.md（每章一份摘要，800–3000 tokens，按需加载）、glossary.md（术语表，小于 1500 tokens）、patterns.md（技术与设计模式及权衡，小于 2000 tokens）、cheatsheet.md（决策规则、阈值、权衡矩阵，小于 1200 tokens）。支持五种模式：完整转换（默认）、仅分析、基于分析生成、更新/合并、打包为插件。
使用方式：脚本位于 scripts/，仅依赖标准库。先运行 extract_document.py 提取全文与元数据，再用 token_budget_estimator.py 做成本预估并等待批准，随后生成章节与支撑文件，最后用 book_skill_validator.py 校验、token_budget_estimator.py 检查预算，可选 skill_plugin_emitter.py 打包为插件。示例命令：python3 "$SKILL_ROOT/scripts/extract_document.py" <paths> --mode text --workdir "$WORKDIR"；python3 "$SKILL_ROOT/scripts/book_skill_validator.py" "$SKILLS_HOME/$SLUG"。各工具支持 --help、--sample、--output json，extract_document.py --check 可报告已安装的提取器。
适用场景：内部文档、品牌体系、标准、规范、研究集群、RFC 文件夹等值得反复查阅的资料。
限制：不得转换用户无法出示的来源，禁止网络抓取书籍或凭记忆重建；超过约 50k tokens 时须用 grep/sed 探测而非整体读入；生成技能为不可信文本，加载前须校验；生成的前言仅含 name 与 description，不得授予工具权限；受版权作品的编译笔记属个人学习笔记，再分发需有明确依据；每个技能须声明未覆盖范围。完整流程见 references/conversion_workflow.md。