Graphic tutorial: Turn a 400-page technical book into a portable skill, from checking the environment to asking questions in five steps图文教程：把一本 400 页的技术书变成随身技能，从检查环境到开口提问只要五步

Run npx skills add virgiliojr94/book-to-skill in the terminal, it will load the cross-agent skills directory and register the/book-to-skill command.

Do not want to use npx manually: git clone repository to ~/.claude/skills/book-to-skill (Copilot CLI with ~/.copilot/skills/, cross-agent unified directory is ~/.agents/skills/).

After installing and reopening a session, tap/book-to-skill to see if there is a completion prompt - it means that the host has recognized this skill.

Go to the skills directory and run python3 scripts/extract.py --check. It lists by format: what PDF is used, what EPUB is used, what DOCX/HTML/RTF is used, what is installed, what is missing, which command should be run.

The most convenient combination: pip3 install pypdf should be a plain text PDF; the technical book should be supplemented with pip3 install docling (the first run will download the model, it is normal to slow down).

EPUB recommends ebooklib + beautifulsoup4 (best quality); you can run without it, you will be returned to the standard library zipfile scheme, which is less effective.

The technical book (with code blocks, tables, formulas, architecture diagram notes) docling,→ which can keep tables and code as Markdown, is worth waiting for those 1.5 seconds/page.

Plain text book (prose, management, biography)→ pdftotext, almost instantaneous and of sufficient quality.

Scanned version first to see if there is a text layer: randomly select a piece of text to see if it can be copied, can not be a picture version, first run ocrmypdf input.pdf output.pdf and then convert.

Before the skill starts, I will take the initiative to ask you what kind of book this book belongs to. Just answer the truth and it will cut the tool itself.

Knock/book-to-skill./yourbook.pdf, or fold a batch of documents into one skill for the entire directory/book-to-skill./docs. Add one more parameter to specify the name:/book-to-skill./book.pdf kubernetes-internals.

Run to ~/.agents/skills/<slug>/to see the directory: SKILL.md, chapters/one file in the next chapter, glossary.md, patterns.md, cheatsheet.md.

Just check the format compliance: python3 tools/validate_skill.py ~/.agents/skills/--lens<slug> claude (host can also change copilot/amp/hermes/opencode).

If you just want to analyze and not generate it first, use the analyze-only mode; the analysis results are satisfactory, and then let it be generated according to the analysis results, saving you a run again.

Don't ask “what this book says” - it's an abstract question, blinded by structure. Ask specifically: "In the chapter on replication in/my-book, when the master-slave delay exceeds the threshold, does it recommend degrading the reader first or expanding the reader first?"

The proxy will only load the matching chapter, and the answer has the chapter source; this is why it saves 24-51 times the token than the whole plug context.

New materials to use the update/fold-in mode into the existing skills, do not need to rebuild; remember to clear the copyright content before sharing, only their own collation.

This article compiles self-public information and accompanies supporting resources; the functions and commands of the involved tools are subject to the official warehouse. Resources are for learning exchange only, please follow source permission.