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 GitHubSupported 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
| File | Purpose | Size |
|---|---|---|
SKILL.md | Core mental models + chapter index | ~4,000 tokens |
chapters/ch01-*.md | One file per chapter, loaded on demand | ~1,000 tokens each |
glossary.md | Key terms with chapter refs | ~1,500 tokens |
patterns.md | Techniques, algorithms, design patterns | ~2,000 tokens |
cheatsheet.md | Decision 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