book-to-skillGitHub
SKILL.mdREADMEReleasesPerformanceSecurity

SKILL.md

Converts books and documents into structured agent skills

The skill definition extracts frameworks, mental models, principles, techniques, and anti-patterns. Structure, not a book report, for Copilot CLI, Amp, or Claude Code.

View source on GitHub

Supported formats

Point /book-to-skill at a file, folder, glob, or list of paths. Supported document formats include:

  • PDF, EPUB, DOCX, HTML / HTM
  • TXT, Markdown, reStructuredText, AsciiDoc
  • RTF, MOBI / AZW / AZW3 (via Calibre)

Philosophy

Books contain crystallized expertise. This converter turns that into a toolkit the agent can reuse:

  • Named frameworks with clear application
  • Actionable principles that guide decisions
  • Techniques as step by step methods
  • Anti-patterns, what to avoid and why
  • Voice calibration for how the author thinks

Preserve the author's precision. “The 5 Whys” is not interchangeable with “ask why multiple times.”

Modes of operation

1. Full conversion (default)

Provide one or more document paths. The skill runs the full pipeline and writes SKILL.md, chapters/, glossary, patterns, and cheatsheet.

2. Analyze only

Ask to analyze first. You get a structured extraction report without writing skill files.

3. Generate from prior analysis

Feed existing analysis notes and skip straight to skill generation.

4. Update / fold in

Merge new sources into an existing skill folder, keeping indexes and glossaries in sync as material lands.

Content type choice

Before extraction, the skill asks whether sources are:

  • Technical code, tables, formulas to Docling (about 1.5s per page)
  • Text heavy mostly prose to the fastest suitable extractor

What gets generated

FilePurposeSize
SKILL.mdCore mental models + chapter index~4,000 tokens
chapters/ch01-*.mdOne file per chapter, loaded on demand~1,000 tokens each
glossary.mdKey terms with chapter refs~1,500 tokens
patterns.mdTechniques, algorithms, design patterns~2,000 tokens
cheatsheet.mdDecision tables and quick reference rules~1,000 tokens

See install and usage

The README walks through cloning into your skills folder, the standalone CLI, and example commands.

Open README