# book-writing-workspace

Скилл book-writing-workspace собирает в репозитории рабочее место для технической книги: папки разделов, документ о читателе, файлы агентов и порядок рецензирования.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 244 установки · ★ 27 у репозитория
- Автор: yamapan (https://github.com/aktsmm)
- Лицензия: CC-BY-NC-SA-4.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/aktsmm/Agent-Skills/tree/HEAD/book-writing-workspace/SKILL.md
- Обновлён: 2026-10-23
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/book-writing-workspace

## Что делает

Скилл приводит репозиторий книги к одной схеме: текст лежит в `sections/` по файлу на раздел, тезисы отдельно в `keypoints/`, картинки в `images/`. Сначала он смотрит, что уже есть, и не заводит второй файл с описанием читателя, если эту роль уже занял обзорный документ. Для нового проекта запускается `python scripts/setup_workspace.py` с именем, заголовком, путём и числом глав.

Внутри — файлы для `.github/agents/` и `.github/instructions/`, документы `docs/reader-personas.md`, `docs/page-allocation.md`, `docs/schedule.md`, `docs/release-readiness-record.md` и счётчик символов `scripts/count_chars.py`. Дальше цикл: правки по замечаниям P1 и P2, сверка каждой главы с портретом читателя, контроль объёма.

Re:VIEW и PDF подключаются флагом `--with-review`: тогда в проекте появляются скрипты конвертации и `config/review-metadata/project.yml`. Без флага их не будет, а скрипт развёртывания написан на Python, так что интерпретатор нужен до запуска. Число страниц скилл советует мерить по собранному файлу: оценка по символам завышает, и сборка автора не равна типографскому счёту.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill book-writing-workspace -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/book-writing-workspace/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/book-writing-workspace/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill book-writing-workspace -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/book-writing-workspace/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill book-writing-workspace -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/book-writing-workspace/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aktsmm/Agent-Skills book-writing-workspace
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/book-writing-workspace/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill book-writing-workspace -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aktsmm/Agent-Skills --path book-writing-workspace
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/book-writing-workspace/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add aktsmm/Agent-Skills --skill book-writing-workspace -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aktsmm/Agent-Skills/tree/HEAD/book-writing-workspace/SKILL.md

## Когда брать
- разложить рукопись по главам и разделам без дублей
- задать портрет читателя один раз и сверять с ним каждую главу
- разобрать пометки корректора по одному пункту
- посчитать объём главы до сдачи в вёрстку
- подключить сборку PDF только там, где она нужна

## Примеры запросов агенту
- Посмотри репозиторий `my-book` и скажи, что переименовать, чтобы получилась схема скилла.
- Сверь главу про интерфейсы с `docs/reader-personas.md` и покажи места, где текст уходит не к той аудитории.
- Включи для проекта поддержку Re:VIEW и PDF и настрой `config/review-metadata/project.yml`.

## Похожие
- [translate-book](https://affpapa.org/nevibecode/skills/translate-book.md) — скилл · 2100 установок
- [writing-guidelines](https://affpapa.org/nevibecode/skills/writing-guidelines.md) — скилл · 133400 установок
- [humanize-writing](https://affpapa.org/nevibecode/skills/humanize-writing.md) — скилл · 2200 установок
- [avoid-ai-writing](https://affpapa.org/nevibecode/skills/avoid-ai-writing.md) — скилл · 1900 установок
- [human-writing](https://affpapa.org/nevibecode/skills/human-writing.md) — скилл · 630 установок
- [technical-blog-writing](https://affpapa.org/nevibecode/skills/technical-blog-writing.md) — скилл · 237 установок

Из того же набора: [aktsmm/agent-skills](https://affpapa.org/nevibecode/by/aktsmm/agent-skills.md) — 5 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
