Agent Skill
Book To Skill skill
book-to-skillvirgiliojr94/book-to-skillSKILL.md
Converts books and documents (PDF, EPUB, DOCX, HTML, Markdown, plain text, RTF, MOBI/AZW with Calibre) into structured agent skills, extracting frameworks, mental models, principles, techniques, and anti-patterns. Use when the user wants to study a document through GitHub Copilot CLI, Amp, Claude Code, Hermes Agent, OpenCode, or OpenClaw, apply an author's frameworks while working, or build a reusable knowledge base from a file.
always on
104 tokname + description
once used
13,512 tokSKILL.md body
bundled files
11 scripts
repo stars
36kGitHub
Install the Book To Skill skill
Skills CLI (Claude Code, Codex, Cursor and others)
npx skills add https://github.com/virgiliojr94/book-to-skill --skill book-to-skill
Claude Code, by hand (all projects)
git clone --depth 1 https://github.com/virgiliojr94/book-to-skill.git /tmp/book-to-skill mkdir -p ~/.claude/skills cp -R /tmp/book-to-skill ~/.claude/skills/book-to-skill
For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.
What it costs your context
Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.
| When | What loads | Cost |
|---|---|---|
| Every session | Name and description | 104 tok |
| When the agent uses it | The SKILL.md instructions | 13,512 tok |
| Only if opened | 1 bundled files (1 KB) | varies |
Until it is used, book-to-skill costs about 13× less than the median MCP server we measured (1,362 tokens on every turn). Skills vs MCP study
Checks
- Ships scripts the agent can run. Read them before installing.
- The instructions are over 5,000 tokens, the Agent Skills specification's guideline for SKILL.md.
- The instructions are over 500 lines; the specification suggests moving detail into reference files.
Checked 2026-10-22 · method
What's inside
The headings of its SKILL.md. Read the full file on GitHub.
- Book-to-Skill Converter
- Philosophy
- Modes of Operation
- 1. Full Conversion (Default)
- 2. Analyze Only
- 3. Generate from Prior Analysis
- 4. Update / Fold-in (Existing Skill)
- Skill Locations
- Step 0 — Out-of-scope check
- Step 1 — Validate input
- Step 1.5 — Identify content type
- Step 2 — Extract text from the source documents
- Step 2.5 — Pre-flight cost estimate
- Step 2.6 — REPL-style access for large books (> 50k tokens)
- Step 3 — Analyze book structure
- Step 4 — Ask purpose (Full Conversion only)
- Step 5 — Determine skill name
- Step 6 — Create skill directory structure
- Step 7 — Generate chapter summaries
- Step 8 — Generate supporting files
- glossary.md
- patterns.md
- cheatsheet.md
- Step 9 — Generate the master SKILL.md