book-to-skill

Установка

npx skills add virgiliojr94/book-to-skill

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Команда /book-to-skill принимает файл, папку или glob (PDF, EPUB, DOCX, HTML, Markdown, RTF, MOBI) и создает скилл: SKILL.md с ключевыми моделями и оглавлением, отдельные файлы глав, глоссарий, паттерны и шпаргалку. Главы подгружаются только по запросу, поэтому скилл не занимает много контекста. Извлечение текста выполняет локальный Python-скрипт, а структуру по спецификации в SKILL.md строит сам агент. Кроме книг подходит для внутренней документации, брендбуков, подборок статей и спецификаций.

Для кого. Разработчикам, техническим писателям и преподавателям, которые часто обращаются к одним и тем же книгам или документам.

Пример запроса к агенту

/book-to-skill ./designing-data-intensive-applications.pdf

Ограничения

Для PDF нужны pdftotext, pypdf, pdfminer.six или docling, для MOBI внешнее приложение Calibre. Сканированные PDF требуют OCR, например через ocrmypdf. Текст отправляется модели агента, поэтому при облачной модели действуют условия провайдера. Скиллы по чужим книгам автор просит не публиковать.

Как отключить. Удалите папку book-to-skill из каталога skills. Сгенерированные скиллы лежат в ~/.agents/skills/<slug>/ и удаляются отдельно.

Проверка безопасности

• Запускает локальный Python-экстрактор и может предложить установку зависимостей
• Может опубликовать сгенерированный скилл в GitHub по запросу

Коротко о README

book-to-skill конвертирует книги и документы в скиллы по открытому стандарту Agent Skills для GitHub Copilot CLI, Amp, Claude Code и Hermes Agent. Результат сохраняется в ~/.agents/skills, а для Claude Code создается проверенная символическая ссылка. README объясняет выгоду по токенам, перечисляет форматы и экстракторы, описывает режимы анализа, генерации и дополнения скилла. Отдельный раздел посвящен авторскому праву: инструмент не содержит книг и не копирует дословные фрагменты. Лицензия MIT, README переведен на русский.

SKILL.md

---
name: book-to-skill
description: "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, Claude Code, or Hermes Agent, apply an author's frameworks while working, or build a reusable knowledge base from a file."
---

<!--
Cross-agent notes (informational; ignored by host agents):
  - Compatible skill roots: GitHub Copilot CLI (~/.copilot/skills, ~/.agents/skills,
    .github/skills, .claude/skills, .agents/skills), Amp (.agents/skills,
    ~/.config/agents/skills, ~/.config/amp/skills), Claude Code (~/.claude/skills),
    Hermes Agent ($HERMES_HOME/skills, .hermes/skills, .agents/skills).
  - `allowed-tools` is intentionally omitted to stay agent-neutral: Copilot CLI uses
    `shell`/MCP-server names, Claude uses `Bash`/`Read`/`Write`/`Glob`/`Grep`, Amp
    adds `shell_command`. The skill needs shell (to run extract.py) and file
    read/write — each host will prompt for those on first use.
  - Argument hint: <path-to-document-folder-or-glob>... [skill-name-slug]
-->

# Book-to-Skill Converter

Transform written knowledge into actionable agent skills by extracting structure — not producing summaries.

## Philosophy

Books contain crystallized expertise: frameworks, principles, and techniques that took years to develop. This skill extracts that knowledge into a format GitHub Copilot CLI, Amp, Claude Code, Hermes Agent, or another compatible agent can leverage repeatedly.

**Extract structure, not summaries.** A skill isn't a book report. It's a toolkit of:
- Named frameworks (mental models with clear application)
- Actionable principles (rules that guide decisions)
- Techniques (step-by-step methods)
- Anti-patterns (what to avoid and why)
- Voice calibration (how the author thinks and communicates)

**Preserve the author's precision.** Frameworks often have specific names for reasons. "The 5 Whys" isn't interchangeable with "ask why multiple times." Capture the exact formulation.

**Layer depth appropriately.** Simple books → simple skills. Complex books with 10+ frameworks → skills with reference files and on-demand chapters.

---

## Modes of Operation

Four paths available. Route based on what the user asks:

### 1. Full Conversion (Default)
**Trigger:** User provides one or more document/directory/glob paths without special instructions
**Action:** Run all steps below (Steps 0–9)
**Output:** Complete skill with SKILL.md, chapters/, glossary, patterns, cheatsheet

### 2. Analyze Only
**Trigger:** User says "analyze", "just extract", or "I want to review before generating"
**Action:** Run Steps 0–3, then produce a structured extraction report (frameworks, principles, techniques found). Stop — do NOT generate skill files.
**Output:** Analysis report for user review

### 3. Generate from Prior Analysis
**Trigger:** User has existing analysis notes or previously ran analyze-only
**Action:** Skip Steps 0–3, use the provided analysis as input, run Steps 4–9
**Output:** Skill files from the provided analysis

### 4. Update / Fold-in (Existing Skill)
**Trigger:** User provides one or more new source paths and indicates they want to update an existing skill (either by pointing to the existing skill folder, providing a skill slug that already exists in `SKILLS_HOME`, or explicitly requesting an update).

Похожие