Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add oyi77/1ai-skills --skill book-to-skillgit clone --depth 1 https://github.com/oyi77/1ai-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/oyi77/1ai-skills/book-to-skill)<a href="https://agentmods.dev/skills/oyi77/1ai-skills/book-to-skill"><img src="https://agentmods.dev/badge/skills/oyi77/1ai-skills/book-to-skill/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/oyi77/1ai-skills/book-to-skill"><img src="https://agentmods.dev/badge/skills/oyi77/1ai-skills/book-to-skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00074 | $0.02934 |
| Opus 5 | $0.00037 | $0.01467 |
| Sonnet 5 | $0.00015 | $0.00587 |
| Haiku 4.5 | $0.00007 | $0.00293 |
Grade B, and why
book-to-skill scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Asks for rootmediumPrivilege escalation
A mod that escalates privileges can change anything on the machine, not only the project.
sudo apt install poppler-utils # for pdftotext (text-heavy PDFs, instant) How it starts
The opening of the file, as written. The whole thing — 310 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Overview
This skill converts technical books and documents — PDF, EPUB, DOCX, HTML, Markdown, RTF, MOBI — into structured agent skills with frameworks, mental models, chapter references, and decision rules. Use it when a knowledge source should become reusable operational guidance. It includes the full extraction and structuring pipeline.
persona: name: "Virgilio Jr." title: "The Knowledge Distiller — Book-to-Skill Pipeline Maintainer" expertise: ['Document Extraction', 'Knowledge Structuring', 'Agent Skill Design', 'Pipeline Engineering'] philosophy: "Books contain crystallized expertise. Extract structure, not summaries." credentials: ['Creator of book-to-skill (MIT)', 'Open-source maintainer'] principles: ['Structure over summary', 'Preserve author precision', 'Layer depth appropriately', 'Privacy-first: all processing local']
Book-to-Skill Converter
Transform written knowledge into actionable agent skills by extracting frameworks, principles, techniques, and anti-patterns — not producing summaries.
Upstream repo: github.com/virgiliojr94/book-to-skill
Upstream author: @virgiliojr94
This integration: Full extraction pipeline vendored into core/book-to-skill/
License: MIT
Format support: PDF, EPUB, DOCX, TXT, Markdown, reStructuredText, AsciiDoc, HTML, RTF, MOBI/AZW/AZW3
Process
Convert a knowledge source into a structured, loadable skill by following the extraction pipeline.
- Ingest — load the source in its native format (PDF, EPUB, DOCX, HTML, Markdown, RTF, MOBI) and confirm all chapters/sections are readable.
- Extract structure — pull frameworks, mental models, chapter references, and decision rules into the skill's working sections.
- Author the skill — write frontmatter (name, description, domain), a workflow, and at least one concrete code example grounded in the source.
- Validate — run the repo's lint and test gates; fix section or frontmatter gaps.
- Install and verify — load the skill in your agent harness and run one real task against it.
What ships with it
35 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- book_to_skill/__init__.py 217 B runs code
- book_to_skill/__main__.py 74 B runs code
- book_to_skill/cli.py 536 B runs code
- book_to_skill/config.py 955 B runs code
- book_to_skill/dependencies.py 9.8 KB runs code
- book_to_skill/exceptions.py 117 B runs code
- book_to_skill/parsers/__init__.py 18 B runs code
- book_to_skill/parsers/calibre.py 876 B runs code
- book_to_skill/parsers/docx.py 4.7 KB runs code
- book_to_skill/parsers/epub.py 4.9 KB runs code
- book_to_skill/parsers/html.py 1.7 KB runs code
- book_to_skill/parsers/pdf.py 5.0 KB runs code
- book_to_skill/parsers/rtf.py 1.7 KB runs code
- book_to_skill/parsers/text.py 1.2 KB runs code
- book_to_skill/sanitize.py 659 B runs code
- book_to_skill/utils.py 30 KB runs code
- CHANGELOG.md 13 KB
- CONTRIBUTING.md 2.0 KB
- docs/ARCHITECTURE.md 6.7 KB
- docs/assets/logo.png 192 KB
- docs/CNAME 21 B
- docs/index.md 2.5 KB
- docs/PERFORMANCE.md 3.1 KB
- LICENSE.md 1.0 KB
- pyproject.toml 930 B
- README.md 24 KB
- scripts/banner.txt 2.8 KB
- scripts/extract.py 871 B runs code
- tests/test_book_to_skill.py 68 KB runs code
- tests/test_discovery_tax.py 4.0 KB runs code
- tests/test_sanitize_extracted_text.py 3.1 KB runs code
- tests/test_scan_generated_skill.py 5.9 KB runs code
- tools/discovery_tax.py 8.4 KB runs code
- tools/scan_generated_skill.py 9.7 KB runs code
- tools/validate_skill.py 8.0 KB runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago Changed · +21 lines 3a8e075693f7
- 8d ago First seen · 289 lines · 74 tokens per session scan B 4b0b42bb0025
book-to-skill is a skill published in the GitHub repository oyi77/1ai-skills (12 stars, last pushed yesterday), licensed MIT. It adds 74 tokens to every session and 2,934 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and…
Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and…
learning-practice-coevolution
AI-guided learning coach that turns books, articles, PDFs, courses, concepts, and real tasks into a reconstruct-critique-transfer-reflect loop. Use for active recall, teach-back critique, concept repair, transfer practice, project-based learning, serial lessons, targeted reading recommendations, or reusable method…
book-to-skill
Book-to-skill takes technical books, documentation, or other long-form sources and converts them into a skill made of a core definition plus per-chapter files, a glossary, and cheatsheets, so an agent can load only the relevant section instead of the whole document. It supports PDF, EPUB, DOCX, HTML, and several other…
knowledge-absorber
A tool that deeply examines links, documents, code, or images and turns them into teaching notes and knowledge posters. It supports formats such as PDF, Word, Markdown, source code, and images, and can save the results to a knowledge base.
PDF Content Extractor & Annotator
A tool for extracting and analyzing PDF content, including text, tables, metadata, and embedded images. It can also combine PDFs, add annotations, remove some watermarks, and use OCR to read scanned pages.