Knowledge and governance closeout: reconcile project docs, rule files (CLAUDE.md/AGENTS.md), authorized agent memory, and workspace residue with what the code and runtime actually do, so the next session or the next person starts from one current answer. Trigger when the user names "neat-freak", "洁癖", or "/neat" — and also on clear knowledge-closeout intent without the name: syncing or tidying project docs/rules/memory after development ("把文档和记忆整理一下", "收尾时把文档同步掉", "docs 和代码对不上了"), stale or conflicting CLAUDE.md/memory, a clean handoff to a teammate or a fresh session, or auditing whether workspace rules are actually followed. Do not trigger for pure coding/refactoring/debugging tasks, tidying data or prose (JSON, 周报, changelog announcements), or a bare "整理" with no project-knowledge context.
book-to-skill
book-to-skill is an open-source docs skill for Claude Code and GitHub Copilot, published by virgiliojr94. Its author describes it as: “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…”. The project has 23k stars on GitHub and is available under the MIT license. Add it to your setup with `git clone https://github.com/virgiliojr94/book-to-skill ~/.claude/skills/book-to-skill`.
What book-to-skill does
... [skill-name-slug] -->
Installation
Add book-to-skill to your agent with:
git clone https://github.com/virgiliojr94/book-to-skill ~/.claude/skills/book-to-skillAlways review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.
What's inside
The SKILL.md for book-to-skill is organised into these sections:
- 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
When to use it
Reach for book-to-skill when you want docs help from Claude Code without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.
About virgiliojr94/book-to-skill
book-to-skill
Strengths
- Clear MIT license — safe to read and adapt
- Established project with 22,785 GitHub stars
- Declares compatibility with Claude Code, GitHub Copilot
- Actively maintained (recent commits)
Topics
Frequently asked questions
- What does book-to-skill do?
- 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, or Claude Code, apply an author's frameworks while working, or build a reusable knowledge base from a file.
- How do I install book-to-skill?
- Run git clone https://github.com/virgiliojr94/book-to-skill ~/.claude/skills/book-to-skill in your agent, then reload your skills. Review the source at https://github.com/virgiliojr94/book-to-skill before installing.
- Is book-to-skill free to use?
- Yes. book-to-skill is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does book-to-skill work with?
- book-to-skill declares compatibility with Claude Code and GitHub Copilot. Agent Skills use a portable SKILL.md format, so other compatible clients can usually load it too.
Related skills
More Docs →
Plan and, with explicit network consent, use an optional external Defuddle cleaner to extract article-like HTTPS pages as Markdown. Use for defuddle, clean this URL, strip page clutter, readable Markdown from a web page, or preparing a web source for later wiki ingestion.
Explain, draft, or validate Obsidian Flavored Markdown syntax: properties, wikilinks, embeds, callouts, tags, comments, highlights, block references, math, and Mermaid. Use when the user explicitly requests Obsidian note formatting or syntax help, not for general Markdown or broad vault operations.
Detect and use the official Obsidian command-line interface for read-only vault access; use for wiki-cli, Obsidian CLI, Obsidian read, Obsidian search, vault transport, which transport, transport detection, backlinks, tags, or Obsidian command line. Mutations always go through the claude-obsidian transaction core.
Create a bounded, extractive, structurally idempotent rollup of recent Obsidian wiki log entries, with dry-run preview by default and one optional transaction apply. Use for manual log compression without modifying child pages. Triggers: fold the log, run a fold, run wiki-fold, log rollup, roll up log entries, commit the fold.