Personal內容創作v1.0by virgiliojr94低風險 · 唯讀／無對外

book-to-skill

把任何技術書變成 Claude 可隨時調用的 Skill

Personal KBPDFEPUBClaude

Book-to-skill 是個個人用的知識庫編譯器：把任何技術書透過 extract.py 轉成純文字，再由 Claude 合成一份結構化 SKILL.md，最後用 /book-to-skill slash command 按章節載入。整本書變成你 Claude 工作流裡的可調用知識——不需要 RAG、不需要塞爆 context。

作者: virgiliojr94（第三方）
授權: MIT
本質: Python 抽取腳本 + Claude 合成 SKILL.md
網路: 零對外連線
產出: 結構化 SKILL.md + 章節按需載入
來源: github.com/virgiliojr94/book-to-skill

01Why you need it

為什麼需要它？

整本書 → 一個可調用的 Skill

不用整本貼進 context、不用 RAG。把任何技術書整理成 Claude 看得懂的結構化知識，需要時才載對應章節。

Claude 自己讀，自己寫 SKILL.md

extract.py 只負責把 PDF/EPUB/DOCX 變成純文字，剩下的章節切分、摘要、metadata 全部交給 Claude 在你本機合成。

按需載入，不爆 context

/book-to-skill <file> <topic> 只把符合 topic 的章節塞進對話，主檔保持精簡。一本 500 頁的書也吃得下。

完全離線、可離線審

整個流程不發任何網路請求；subprocess 只呼叫 pdftotext / pandoc 這類本地工具，沒有任意指令執行的攻擊面。

02How it runs

四步驟流程

STEP 01

extract

把 PDF/EPUB/DOCX 轉成純文字檔，保留章節標記。

STEP 02

synthesize

Claude 讀全文，產生 SKILL.md：description、章節索引、關鍵概念。

STEP 03

preload

把 SKILL.md 放進 .claude/skills/，描述命中時自動載入主檔。

STEP 04

slash command

/book-to-skill <file> <topic> 按需把對應章節注入對話。

範例

/book-to-skill ddd.pdf "aggregate root design"

03Use cases

適合這樣用

把 DDD、Designing Data-Intensive Applications 變成可隨時諮詢的架構顧問

把公司內部 SOP / Runbook 轉成新人 onboarding skill

把產品文件 / API 規格書變成 Claude 寫程式時的查詢索引

把同主題的多本書整理成同一個 skill，避免重複載入

04Security review

安全性評估

放心之處

✓零網路請求：整個流程在本機完成，沒有遙測、沒有外部 API。
✓subprocess 安全：只呼叫 pdftotext / pandoc 這類已知工具，輸入經 sanitize，無 shell injection。
✓唯一寫入點：/tmp 暫存 + Skill 自身目錄，不會碰你其他檔案。
✓程式碼短小：一支 Python 腳本 + 一份 prompt，可在 10 分鐘內審完。

該留意之處

⚠輸入信任問題：風險主要來自你丟進去的書本檔案本身（惡意 PDF 解析漏洞），請用乾淨來源。
⚠Claude 合成品質受原文影響：掃描版 PDF 或 OCR 品質差的書，產出的 SKILL.md 會不準。
⚠個人用 Skill：作者非組織級維護，更新節奏取決於個人；自用為主，勿盲目分享給團隊。

結論

低風險、個人取向。完全離線、寫入範圍受控、程式碼短小好審。主要風險是你自己提供的檔案，而不是工具本身。

05Install

安裝方式

手動放置

git clone https://github.com/virgiliojr94/book-to-skill ~/.claude/skills/book-to-skill

clone 完即可使用。建議先 review 一次 extract.py 與 SKILL.md，再開始餵書。

← 探索更多 Skills

為什麼 需要它？