OPEN SOURCE SKILL · КНИГИ И АУДИОКНИГИ

Book Summary
Skill

Мультиагентный workflow, который превращает книгу или аудиокнигу в оригинальное, проверяемое саммари: текст, подготовленную озвучку и пакет материалов для чтения и слушания.

Открыть репозиторий ↗Как начать
Статус публичной версии

Сейчас в репозитории готовы общий контракт проекта, настройка языка и длительности, а также адаптеры для Hermes, Claude Code и Codex. Полный конвейер извлечения, синтеза, вёрстки и сборки аудио описан как следующий этап разработки.

Не пересказ, а рабочее саммари

Skill задуман для книг, электронных изданий и аудиокниг. Он помогает сохранить структуру аргументов, проверить факты, подготовить связный текст и при необходимости — версию для прослушивания.

НА ВХОДЕКнига, документ или аудиокнига с надёжной расшифровкой.
НА ВЫХОДЕСаммари, редактируемый текст озвучки, PDF, FB2 и один MP3 — по мере готовности полного конвейера.
ПРИНЦИПМодель не подменяет источник: итог проверяется по именам, числам, причинным связям и структуре книги.

Быстрый старт

Репозиторий запускается как обычный проект: он спрашивает язык саммари и целевую длительность аудио, а затем сохраняет выборы в отдельной конфигурации проекта.

git clone https://github.com/pavelnasuta/book-summary-skill.git
cd book-summary-skill
python scripts/project_config.py ./projects/my-book

В результате появится project.json с выбранным языком и длительностью. При возвращении к тому же проекту настройки не спрашиваются заново.

Подключение к AI-агенту

В репозитории есть адаптеры под три среды. Они используют одну общую структуру проекта и не создают три разных конвейера.

Hermes

Установите адаптер из GitHub, затем работайте с клонированным репозиторием и его общими скриптами.

hermes skills install pavelnasuta/book-summary-skill/agents/hermes

Claude Code

Поместите адаптер в проект как .claude/skills/book-summary/SKILL.md и сохраните рядом общие scripts/ и specs/.

Codex

Добавьте правила из agents/codex/AGENTS.md в рабочий AGENTS.md проекта.

Полный маршрут

  1. Создать проект и явно задать язык и длительность.
  2. Извлечь текст книги или подготовить надёжную расшифровку аудиокниги.
  3. Разбить источник на устойчивые фрагменты и сохранить покрытие.
  4. Собрать саммари по главам и проверить ключевые утверждения.
  5. Подготовить PDF, FB2, текст озвучки и единый MP3.
  6. Проверить, что структура, факты и длительность соответствуют источнику и задаче.

Этот маршрут намеренно разделяет черновик, проверку и публикацию: убедительный текст без проверки — не готовый результат.

Границы и права

Skill создаёт оригинальное преобразование, а не замену книге. Источники, расшифровки и пользовательские результаты по умолчанию остаются приватными. Публикация или распространение требуют отдельной оценки прав на исходный материал.

Перед изменением общей логики репозитория запускаются офлайн-тесты:

pytest tests/ -q