Skip to content

description: "Turn any book, PDF or EPUB into a structured agent skill for Claude Code, GitHub Copilot CLI, Amp, Codex, Hermes Agent, OpenCode, and OpenClaw. Named frameworks and decision rules, loaded on demand."seo_title: "book-to-skill - Turn Any Book Into an AI Agent Skill" hide: - navigation - toc

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, Amp, Codex, Hermes Agent, OpenCode, and OpenClaw through the open Agent Skills standard.

Install

As an agent skill (gives you the /book-to-skill command in Claude Code, Copilot CLI, Amp, Codex, Hermes Agent, OpenCode, or OpenClaw): 

npx skills add virgiliojr94/book-to-skill
# or manually:
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):

# not on PyPI yet — pip takes it from the repository
pip install "book-to-skill[pdf,epub,docx] @ git+https://github.com/virgiliojr94/book-to-skill.git"
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.