Files
Douglas Ingram 907be508ee feat(hosts): add Hermes Agent skill discovery and validation (#202)
* feat(hosts): add Hermes Agent support

* fix(hosts): honor Hermes project trust and precedence

* fix(hosts): require Git root for project discovery

---------

Co-authored-by: Douglas Ingram <douglas.ingram@outlook.com>
2026-08-31 14:15:28 -04:00

3.7 KiB

description, seo_title, hide
description seo_title hide
Turn any book, PDF or EPUB into a structured agent skill for Claude Code, GitHub Copilot CLI, Amp and Hermes Agent. Named frameworks and decision rules, loaded on demand. book-to-skill - Turn Any Book Into an AI Agent Skill
navigation
toc
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "book-to-skill", "applicationCategory": "DeveloperApplication", "operatingSystem": "Linux, macOS, Windows", "description": "Converts books and documents (PDF, EPUB, DOCX, HTML, Markdown, RTF, MOBI/AZW) into structured, on-demand agent skills for Claude Code, GitHub Copilot CLI, Amp and Hermes Agent.", "url": "https://booktoskill.is-a.dev/", "codeRepository": "https://github.com/virgiliojr94/book-to-skill", "license": "https://opensource.org/licenses/MIT", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" }, "author": { "@type": "Person", "name": "virgiliojr94", "url": "https://github.com/virgiliojr94" } } </script>

book-to-skill

Turn any book or document into a structured, on-demand agent skill — named frameworks, decision rules, and anti-patterns. Structure, not a summary.

Get started{ .md-button .md-button--primary } Skill reference{ .md-button } GitHub{ .md-button }


Why book-to-skill

  • :material-file-document-multiple:{ .lg .middle } Multi-format


    PDF, EPUB, DOCX, HTML, Markdown, RTF, MOBI/AZW (via Calibre). Extraction runs locally with graceful stdlib fallbacks — no upload, no lock-in.

  • :material-brain:{ .lg .middle } Structure, not summaries


    Named frameworks, mental models, decision rules, and anti-patterns — the author's toolkit, captured with their exact terms, not a book report.

  • :material-flash:{ .lg .middle } On-demand chapters


    Per-chapter files load only when the topic is relevant, so a 200-page book costs tokens proportional to the question, not the page count.

  • :material-robot-happy:{ .lg .middle } Multi-agent


    One SKILL.md runs on Claude Code, GitHub Copilot CLI, Amp, and Hermes Agent through the open Agent Skills standard.

Install

As an agent skill (gives you the /book-to-skill command in Claude Code, Copilot CLI, Amp, or Hermes Agent):

npx skills add virgiliojr94/book-to-skill
# or manually:
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill
# then, in your agent session:
/book-to-skill /path/to/book.pdf [skill-name]

As a standalone CLI (just the text extractor, optional):

# not on PyPI yet — pip takes it from the repository
pip install "book-to-skill[pdf,epub,docx] @ git+https://github.com/virgiliojr94/book-to-skill.git"
book-to-skill /path/to/book.pdf --mode text

Learn more

  • :material-sitemap:{ .lg .middle } Architecture


    How the deterministic extractor and the spec-driven generator fit together.

  • :material-speedometer:{ .lg .middle } Performance


    The measured Discovery Loop Tax and real per-conversion token cost.

  • :material-book-open-page-variant:{ .lg .middle } Skill Reference


    The full SKILL.md spec: every step, depth budget, and quality rule.

  • :material-heart:{ .lg .middle } Sponsor


    book-to-skill is free and MIT. Sponsoring funds reviews, releases, and fixes.