AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
RAG / Knowledge Base/
book-to-skill
book-to-skill logo

book-to-skill

Active·★ 38.3k·MIT·Updated 2026-11-08
★ Most Popular

book-to-skill is an open-source tool and agent skill by Virgilio Jr that converts technical books, document folders, and API specs into unified, structured Agent Skills. Rather than dumping an entire multi-hundred-page PDF into a model's context window—which subjects every subsequent query to repetitive 'discovery loop taxes' as the model refetches tables of contents and navigates sections—the tool distills the source material once into a persistent, modular knowledge bundle.

The resulting artifact adheres to the open Agent Skills standard. It generates a lightweight `SKILL.md` (around 4,000 tokens) containing high-level mental models and chapter indexes, complemented by separate files for chapter deep-dives (`chapters/ch01-*.md`), an alphabetized `glossary.md`, core architectural `patterns.md`, and decision-tree `cheatsheet.md`. Crucially, detailed chapter files are loaded by the agent on demand, enabling 24× to 51× token savings on individual technical queries while eliminating context-drift hallucinations.

It supports PDF, EPUB, DOCX, Markdown, and MOBI sources, installing globally via `npx skills add virgiliojr94/book-to-skill` for GitHub Copilot CLI, Claude Code, Codex, and OpenClaw. Users should be prepared for significant upfront time and LLM token expenditure during the initial conversion pass of lengthy books. Additionally, noisy scanned documents with non-standard multi-column layouts or complex figures can suffer degraded extraction quality.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-12.

License
MIT
Latest release
v1.4.0 · 2026-08-10
Last commit
2026-11-08
Contributors
57
Forks
3,987
Open issues and PRs
27
First published
2026-05-01

Source: GitHub, npm and PyPI public APIs.

#agent-skills#ai-agents#book-to-skill#context-engineering#dev-tooling#document-processing#edtech#knowledge-base
$ Install
$ npx skills add virgiliojr94/book-to-skill
↗ Visit site★ GitHub
01

Features

01Chapter-indexed Skill with on-demand chapter files
02Glossary, patterns and quick-reference outputs
03File, folder and glob inputs with analysis/update modes
02

Why choose it

+Cuts per-query token consumption by 24×–51× compared to dumping raw books into context.
+Modular on-demand loading isolates chapter details, architectural patterns, and glossary references.
+Broad format ingestion supporting PDF, EPUB, DOCX, Markdown, HTML, and MOBI files.
+Cross-agent discovery compliant with the open Agent Skills standard across all major CLI hosts.
03

Trade-offs

!Initial conversion and distillation pass requires noticeable upfront LLM processing time and tokens.
!Complex multi-column scanned PDFs and poor OCR sources can yield fragmented or messy chapter markdown.
!Heavily visual books with intricate flowcharts lose fidelity when converted to plain text and tables.
!Python environment prerequisites (pdfplumber, pypdf) required during local document parsing stages.
04

Maintenance check

ActiveChecked: 2026-11-12
Last commit
2026-11-03
Commits, last 90 days
100+
Releases, last 90 days
0
Latest release
v1.4.0 (2026-08-10)
Open issues
27
Recent issues with at least one comment
2/13
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 15, 6, 6, 7, 4, 9, 8, 18, 0, 9, 9, 0

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #309 Proposal: slim down the installed skill payload (split runtime files from dev/site files)4 comments · 2026-10-27
  • #169 The generator's own SKILL.md is 7k tokens with zero references — 52% of it loads before the run knows it can proceed2 comments · 2026-08-15
  • #128 PDF: `pdftotext -layout` interleaves columns on multi-column documents, and the word-based token estimate hides the 26x size blowup3 comments · 2026-08-10
  • #263 [bug] BeautifulSoup HTML/EPUB extraction inserts newlines inside inline headings and code tokens1 comments · 2026-10-01
  • #259 [bug] Interrupted-run reuse accepts missing or corrupted extracted text1 comments · 2026-09-30

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

05

Compatibility

Agent Skills
Claude Code, Codex, Copilot CLI and other documented hosts
Verified via docs
Python
Python extraction setup check; tools vary by format
Verified via docs
Documents
PDF, EPUB, DOCX, Markdown and other documented formats
Verified via docs
06

Quick start

1
$ npx skills add virgiliojr94/book-to-skill
07

Use cases

↳Organizing a technical book as an agent reference
↳Combining several documents into one navigable skill
↳Refreshing reference material as source documents change
08

Alternatives

⚡Top VS:
VSllm-wiki-compiler★2.3k→VSOpenKnowledge★4.9k→VSawesome-agent-skills★37.3k→VSzvec★16.3k→
llm-wiki-compiler logo
llm-wiki-compiler★ 2.3k
The knowledge compiler. Raw sources in, interlinked wiki out. Inspired by Karpathy's LLM Wiki pattern.
VSCompare→
OpenKnowledge logo
OpenKnowledge★ 4.9k
Beautiful, AI-native markdown IDE and LLM wiki
VSCompare→
awesome-agent-skills logo
awesome-agent-skills★ 37.3k
A curated collection of 1000+ agent skills from official dev teams and the community, compatible with Claude Code, Codex, Gemini CLI, Cursor, and more.
VSCompare→
zvec logo
zvec★ 16.3k
A lightweight, lightning-fast, in-process vector database
VSCompare→
Anthropic Skills logo
Anthropic Skills★ 196.7k
Public repository for Agent Skills
VSCompare→
taste-skill logo
taste-skill★ 117.7k
Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
VSCompare→
cognee logo
cognee★ 33.4k
Cognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory with small models for free
VSCompare→
video-shotcraft logo
video-shotcraft★ 21.0k
AI video skill for Claude Code & Codex — cinematic, editable product promos with Remotion: 124 shot recipe cards, 150 motion previews, beat sync, sound design, Motion Workbench & JianYing (CapCut CN) export.
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
virgiliojr94 /
book-to-skill
↗

Transforms technical books and document clusters into modular, on-demand agent skills

38.3k4.0kMIT
Last commit1w ago
StatusActive
CategoryRAG / Knowledge Base
Contributors57
Latest releasev1.4.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.