book-to-skill
Skill1 starsChanged 9 days agoMITView on GitHub
Turn a book you already own into a structured Claude skill, a short index plus one file per chapter, loaded only when needed, instead of holding the whole book in context at once. Also works for training material or a policy document, your own organisation's, not a book. Use when you want an AI assistant to consult a specific book, course, or policy repeatedly without paying the token cost of the whole thing every time. Do not use this to reproduce or share a book's content publicly; the output is for your own private use, built from a copy you already have the right to read.
19 other projects use a version of this.
Adopted by
Most recently taken up by
- darkweb19/skillstheir own version, first seen Nov 8, 2026
- JustinTSmith/ai-operator-skillstheir own version, first seen Oct 11, 2026
- c-ibarra/ObsidianKnowledgeCuratortheir own version, first seen Oct 9, 2026
- SanHsien/book-to-skilltheir own version, first seen Sep 27, 2026
- johnwick020213/skilltheir own version, first seen Sep 21, 2026
- johnwick020213/skillstheir own version, first seen Sep 21, 2026
Other versions19 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 19
- virgiliojr94/book-to-skill★ 37ksame name
- apple-ouyang/book-to-skill★ 148same name
- markoblogo/abvx-agent-skills★ 16same name
- carpatia77/sop-extractor★ 11same name
- CashewTeam/Con11-AI-Skills★ 8same name
- huntsyea/thinking-skills★ 4same name
- Linearl/reasonix_skill_repo★ 3same name
- 13531276085a-create/claude-skills★ 1same name
- lyh843/AgentSkills★ 1same name
- SanHsien/book-to-skill★ 1same name
9 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 17 edited versions we read keep these.
4
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 49
Never treat this output as something to share, publish, or sell.
- Distinctive: line 50
If a section's actual content is thin or repetitive, say so rather than padding the file to look complete
- Distinctive: line 51
Keep the index short; if it is creeping past 100 lines, move detail into a section file instead
- Distinctive: line 56
Do not produce this output when:
“Common” is measured: kept by at least 6 in 10 of the 17 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Turn a Book Into a Skill
You do not need to install anything to try this once. The lines between the dashes at the very top are just this file's label; leave them in. On GitHub, copy this using the Raw button near the top of the page rather than selecting the rendered text, so the tables and links below paste in cleanly. Send the whole file as your first message in any AI chat tool, then paste in the text, a chapter or section at a time works best for a long one.
A full book, course, or policy loaded into context costs tokens whether or not a given answer actually needs it. This restructures it the same way any other AI skill is structured: a short index that loads every time, and separate section files that only open when a specific question actually needs that section.
Before You Start
- Only use a book you have the legal right to read: one you bought, borrowed properly, or that is in the public domain. A training course or policy document from your own organisation does not carry the same copyright constraint, but check it is genuinely yours to use this way rather than something confidential.
- This output is for your own private use. Do not publish, resell, or redistribute the section files, the techniques document, or the glossary; for a book, that would be redistributing someone else's copyrighted work, not a tool.
- Work from your own copy's text, not a pirated or scraped source.
Gather the Inputs
- The title, author or owning team, and table of contents, if available
- The text of each chapter or section, pasted in one at a time for a long source, or the whole thing at once for a short one
- What you actually want to use it for, so the index highlights what matters most to you rather than everything equally
Build the Structure
1. The Index File
One short file that stays loaded every time: the book's title and author, a one-paragraph summary of what it actually argues or teaches, a chapter list with a one-line description of each, and where the glossary and techniques document live. Keep this under roughly 100 lines; it is the only file that loads on every use, so it must earn its place.
2. One File Per Chapter
For each chapter, a separate file containing the chapter's actual content structured as concepts, techniques, patterns, or arguments, not a copy of the original prose. Use a few direct short quotations only where the original wording genuinely matters and cannot be paraphrased without losing meaning. End with a one-line note on where this chapter sits in the book's overall argument.
3. The Techniques and Patterns Document
One document, separate from the chapter files, listing every named technique, pattern, framework, or step-by-step method the book describes, with the chapter it came from, so a specific method can be found without opening every chapter file to look for it.
4. The Glossary
One file defining every term the source uses in a specific or non-obvious way, so a later question can check a definition without reloading a whole section.
5. Check for Contradictions, Policy and Training Material Only
A book rarely contradicts itself between chapters. A policy or a training course often does, a later update supersedes an earlier rule, or a specific exception overrides a general one stated elsewhere. Check for this explicitly, and where two sections genuinely conflict, note which is more current or more specific in the index, rather than presenting both as equally valid. Skip this step entirely for a book; it exists because policies change in a way chapters of a book do not.
Apply the Guardrails
- Paraphrase and structure the source's ideas; do not reproduce long passages of the original text
- Never treat this output as something to share, publish, or sell; it is a private reference aid built from a source you already have the right to use this way
- If a section's actual content is thin or repetitive, say so rather than padding the file to look complete
- Keep the index short; if it is creeping past 100 lines, move detail into a section file instead
- For a policy or training course, never silently pick one side of a contradiction; flag it and say which appears more current
Stop When the Task Is Unsafe
Do not produce this output when:
- The text was not provided by someone with the right to use it this way
- The stated purpose is to publish, sell, or otherwise redistribute the resulting files
- The request is to reproduce the original text word for word rather than structure its ideas
Require Human Review
Skim each section file once against the original before relying on it for something that matters. A structuring pass can still misread emphasis or drop a qualifier the original section actually included, and for a policy, still miss a contradiction worth flagging.
For a fictional worked example using a book, read the worked example. For one using an internal policy, including the contradiction check in practice, read the second worked example. Use the review checklist before relying on the generated files.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

