# groove-work-doc

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 518 установок · ★ 6
- Автор: andreadellacorte
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/andreadellacorte/groove/tree/HEAD/skills/groove-work-doc/SKILL.md
- Обновлён: 2026-07-24
- HTML: https://affpapa.org/nevibecode/skills/groove-work-doc

## Что делает

Скилл исследует кодовую базу и создаёт документ в `.groove/memory/docs/`. В нём должны быть четыре раздела: обзор компонента и решаемой задачи, список ключевых файлов, пошаговое описание основного потока и неочевидные ограничения.

Перед записью он проверяет реальные пути файлов и связывает описание с фактическим выполнением кода. Для исследования используется Explore agent, а документ пишется в изолированном контексте через general-purpose agent. Если тема или её границы неоднозначны, скилл спрашивает, кто будет читать документ: новый участник, будущий агент или оба.

Тема берётся из `$ARGUMENTS`, если она передана. Имя файла очищается от разделителей путей, специальных символов и паттернов вроде `../`. При отсутствии каталога `.groove/memory/docs/` скилл создаёт его. Это значит, что итоговый документ рассчитан на конкретную кодовую базу, а не на общий учебник.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add andreadellacorte/groove --skill groove-work-doc -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add andreadellacorte/groove --skill groove-work-doc -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add andreadellacorte/groove --skill groove-work-doc -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install andreadellacorte/groove groove-work-doc
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add andreadellacorte/groove --skill groove-work-doc -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/andreadellacorte/groove --path skills/groove-work-doc
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add andreadellacorte/groove --skill groove-work-doc -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/andreadellacorte/groove/tree/HEAD/skills/groove-work-doc/SKILL.md

## Когда брать
- создать справку о компоненте кодовой базы
- найти ключевые файлы и описать их роли
- разложить основной поток выполнения по шагам
- зафиксировать ограничения и острые места
- подготовить контекст для будущего агента

## Примеры запросов агенту
- Создай документ о том, как работает модуль авторизации.
- Разбери компонент `src/payments` и запиши его основной поток в документацию.
- Опиши концепцию кэширования для нового участника проекта, указав реальные файлы и ограничения.

## Похожие
- [make-it-work](https://affpapa.org/nevibecode/plugins/make-it-work.md) — плагин · ★ 12
- [documenting-legacy-codebases](https://affpapa.org/nevibecode/skills/documenting-legacy-codebases.md) — скилл · 17900 установок
- [decision-doc-sync](https://affpapa.org/nevibecode/skills/decision-doc-sync.md) — скилл · 3000 установок
- [doc-gen](https://affpapa.org/nevibecode/skills/doc-gen.md) — скилл · 743 установки
- [deepinit](https://affpapa.org/nevibecode/skills/deepinit.md) — скилл · 1000 установок
- [ce-explain](https://affpapa.org/nevibecode/skills/ce-explain.md) — скилл · 957 установок

Из того же набора: [andreadellacorte/groove](https://affpapa.org/nevibecode/by/andreadellacorte/groove.md) — 27 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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