<p align="center"> <img src="docs/assets/banner.webp" alt="Booklin, the book-to-skill wizard, holding an open book whose pages scatter into sparkles that settle into an ordered grid" width="100%"> </p>

<h1 align="center">book-to-skill</h1>

<p align="center"> <strong>Turn any technical book, document folder, or collection of sources into a unified agent skill — ready to study, reference, and use while you work in GitHub Copilot CLI, Amp, or Claude Code.</strong> </p>

<p align="center"> <img src="https://img.shields.io/badge/Agent_Skills-Open_Standard-blueviolet?style=for-the-badge" alt="Agent Skills standard"> <img src="https://img.shields.io/badge/PDF%20%E2%80%A2%20EPUB%20%E2%80%A2%20DOCX%20%E2%80%A2%20MD%20%E2%80%A2%20HTML%20%E2%80%A2%20RTF%20%E2%80%A2%20MOBI-supported-green?style=for-the-badge" alt="Formats supported"> <img src="https://img.shields.io/badge/License-MIT-blue?style=for-the-badge" alt="MIT License"> </p>

<p align="center"> <a href="#-why">Why</a> · <a href="#-what-it-generates">What it generates</a> · <a href="#-beyond-books">Beyond books</a> · <a href="docs/how-it-works.md">How it works</a> · <a href="docs/usage.md">Usage</a> · <a href="#-install">Install</a> · <a href="docs/faq.md">FAQ</a> · <a href="docs/performance.md">Performance</a> · <a href="CHANGELOG.md">Changelog</a> </p>

<p align="center"> <strong>24×–51× fewer tokens than dumping the book into context</strong> to answer one question, measured on real books. </p>

<p align="center"> <code>pip install -e .</code><br> <code>book-to-skill install</code><br> <code>book-to-skill &lt;path-to-book.pdf&gt;</code> </p>

**How it works, in 3 steps:**

1. **Point** it at a file, folder, or glob — `book-to-skill ./my-book.pdf` 2. **It distills** the book into a skill — frameworks, decision rules, anti-patterns, and per-chapter files. Structure, not a summary. 3. **Your agent loads it on demand** — ask `/my-book replication` and it reads the right chapter and answers