Skip to content

book-to-skill

Turn any book or document into a structured, on-demand agent skill — named frameworks, decision rules, and anti-patterns. Structure, not a summary.

Get started Skill reference GitHub

Why book-to-skill

  • Multi-format

    PDF, EPUB, DOCX, HTML, Markdown, RTF, MOBI/AZW (via Calibre). Extraction runs locally with graceful stdlib fallbacks — no upload, no lock-in.

  • Structure, not summaries

    Named frameworks, mental models, decision rules, and anti-patterns — the author's toolkit, captured with their exact terms, not a book report.

  • On-demand chapters

    Per-chapter files load only when the topic is relevant, so a 200-page book costs tokens proportional to the question, not the page count.

  • Multi-agent

    One SKILL.md runs on Claude Code, GitHub Copilot CLI, and Amp through the open Agent Skills standard.

Install

As an agent skill (gives you the /book-to-skill command in Claude Code, Copilot CLI, Amp):

git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill
# then, in your agent session:
/book-to-skill /path/to/book.pdf [skill-name]

As a standalone CLI (just the text extractor, optional):

pip install "book-to-skill[pdf,epub,docx]"
book-to-skill /path/to/book.pdf --mode text

Learn more

  • Architecture

    How the deterministic extractor and the spec-driven generator fit together.

  • Performance

    The measured Discovery Loop Tax and real per-conversion token cost.

  • Skill Reference

    The full SKILL.md spec: every step, depth budget, and quality rule.

  • Sponsor

    book-to-skill is free and MIT. Sponsoring funds reviews, releases, and fixes.