# book-to-skill

> Turns a technical book or document folder you own into a skill your agent loads on demand: its frameworks, patterns and chapter notes.

book-to-skill is an open-source Agent Skill by virgiliojr94 that turns a technical book, a document folder or a set of papers you own into a structured skill your agent can study and reference while you work. Instead of searching a PDF or hoping the agent remembers the book, you ask the generated skill about a topic and it reads the right chapter notes.

What you can do with it
- Convert a book: /book-to-skill ./my-book.pdf creates a skill with the book's core mental models, a chapter index, per-chapter notes, a glossary, a patterns file and a cheat sheet
- Ask the result about a topic or chapter, such as /designing-data-intensive-apps replication
- Merge several files, a folder or a glob into one skill, and fold new material into an existing skill later
- Use it beyond books: internal docs, runbooks, brand and design guidelines, specs and research papers
- Works with PDF, EPUB, DOCX, HTML, Markdown, plain text, RTF and, with Calibre, MOBI and AZW

How it works
- A Python extractor turns the document into clean text on your machine; your agent then follows the skill's steps to write the new skill.
- Chapter files load only when you ask about that topic, which keeps the loaded skill small.
- Install it with npx skills add virgiliojr94/book-to-skill, or clone it into your agent's skills folder. It follows the open Agent Skills standard; the maker documents Claude Code, Codex, GitHub Copilot CLI and more.
- Optional extractors (Docling for technical books with code and tables, pdftotext, ebooklib) improve quality. Scanned PDFs need OCR first.

Good to know
- It ships no book content. You point it at files you have the right to use, and the generated skill is synthesized notes: the skill's own rules say never to copy raw book text.
- The maker asks you to keep skills made from third-party copyrighted books private. If you choose to publish a generated skill to GitHub, the repository is private by default.
- Extraction runs locally; the text your agent reads goes to its model provider like any other prompt.
- MIT licensed (the converter, not the books you process). A community project by virgiliojr94.

- Type: Skill
- Made by: virgiliojr94
- Category: Education
- Formats: Skills
- Version: aebe394
- Website: https://booktoskill.is-a.dev
- Source: https://github.com/virgiliojr94/book-to-skill
- Page: https://pluginboard.ai/skills/book-to-skill

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the book-to-skill folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Claude

In Claude (web or desktop): Download the book-to-skill folder and zip the folder itself, then upload it in Customize → Skills.

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Gemini

In Gemini: Download the book-to-skill folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### GitHub Copilot

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill ~/.copilot/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Cursor

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill ~/.cursor/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Claude Code

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill ~/.claude/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Codex

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill ~/.agents/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Antigravity

In Antigravity: Copy the book-to-skill folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Gemini CLI

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill ~/.gemini/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Replit

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill .agents/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### OpenClaw

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill ~/.openclaw/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### OpenCode

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill ~/.config/opencode/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

### Hermes Agent

Run in your terminal:

```shell
npx -y degit virgiliojr94/book-to-skill ~/.hermes/skills/book-to-skill
```

View the folder on GitHub: https://github.com/virgiliojr94/book-to-skill

---
From Pluginboard (https://pluginboard.ai).
