# skill-progressive-disclosure-design

Помогает решить, что оставить в SKILL.md, а что вынести в references/, чтобы скилл не съедал контекст зря.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4300 установок · ★ 236
- Автор: samber
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/samber/cc-skills/tree/HEAD/skills/skill-progressive-disclosure-design/SKILL.md
- Обновлён: 2026-10-01
- HTML: https://affpapa.org/nevibecode/skills/skill-progressive-disclosure-design

## Что делает

Скилл разбирает два вопроса, которые обычно путают. Триггеринг — это вызывает ли Claude скилл вообще, и зависит он только от поля `description` в YAML. Разбиение файлов на триггеринг не влияет. Если скилл срабатывает нестабильно, делить файлы бессмысленно: правьте описание.

Прогрессивное раскрытие — это то, что подгружается после активации. Тело SKILL.md читается всегда, `references/*` — только когда SKILL.md прямо укажет прочитать конкретный файл, а `scripts/*` выполняется вообще без загрузки в контекст. По умолчанию автор советует не дробить: монолитный SKILL.md выигрывает, пока не доказано обратное. Повод задуматься — файл перевалил за 300–400 строк и в нём видны естественные ветки.

Работают три оси разбиения: вариант (пользователь выбирает одну ветку из нескольких), процедура против справочных данных (шаги в SKILL.md, таблицы и схемы в `references/`), и глубина (частый путь в SKILL.md, редкие случаи в `references/edge-cases.md`). У каждой оси расписаны плюсы и минусы, и решения здесь — компромиссы, а не правила. Отдельный раздел разбирает разбиения, которые не работают: например, деление по темам, когда вызовы не группируются по темам.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/cc-skills --skill skill-progressive-disclosure-design -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/cc-skills --skill skill-progressive-disclosure-design -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/cc-skills --skill skill-progressive-disclosure-design -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install samber/cc-skills skill-progressive-disclosure-design
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/cc-skills --skill skill-progressive-disclosure-design -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/samber/cc-skills --path skills/skill-progressive-disclosure-design
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add samber/cc-skills --skill skill-progressive-disclosure-design -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/samber/cc-skills/tree/HEAD/skills/skill-progressive-disclosure-design/SKILL.md

## Когда брать
- решить, что оставить в SKILL.md, а что вынести в references/
- починить нестабильный триггеринг скилла через описание, а не через дробление файлов
- уложить растущий SKILL.md в разумный объём контекста
- выбрать между вариантной веткой, справочником и edge-cases
- отличить проблему триггеринга от проблемы раскрытия

## Примеры запросов агенту
- помоги разбить мой SKILL.md, он уже за 400 строк
- мой скилл плохо триггерится, что чинить — описание или файлы?
- что вынести в references/, а что оставить в SKILL.md?

## Похожие
- [improve-claude-md](https://affpapa.org/nevibecode/skills/improve-claude-md.md) — скилл · 2500 установок
- [disclosure-page-generator](https://affpapa.org/nevibecode/skills/disclosure-page-generator.md) — скилл · 1000 установок
- [fee-disclosure](https://affpapa.org/nevibecode/skills/fee-disclosure.md) — скилл · 648 установок
- [token-optimizer](https://affpapa.org/nevibecode/skills/token-optimizer.md) — скилл · 976 установок
- [context-compression](https://affpapa.org/nevibecode/skills/muratcankoylan-context-compression.md) — скилл · 459 установок
- [skill-creator](https://affpapa.org/nevibecode/skills/tldraw-skill-creator.md) — скилл · 431 установка

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

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

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