exec-summary — скилл для Claude Code: саммари фичи на 1–2 страницы
Собирает из папки фичи один документ на 600–800 слов: питч для продаж, стратегию для руководства и поведение для разработки.
npx skills add mvschwarz/openrig --skill exec-summary -a claude-codeЧто делает exec-summary
Скилл читает SPEC.md, background.md, validation.md и ASCII-макеты из supporting/, а потом пишет executive-summary.md в папку фичи. Текст идёт в настоящем времени, будто фича уже существует. Структура жёсткая: проблема, решение, для кого, почему сейчас, как работает, ключевые решения, визуальный превью, что не делаем, зависимости, метрики и FAQ по трём аудиториям.
Разделы «Key Decisions» и «What We're NOT Building» требуют конкретики: неочевидные бизнес-правила и явный out-of-scope с причиной. Если в папке фичи нет этих файлов, собирать будет нечего — скилл опирается только на них. Основной текст ограничен двумя страницами, FAQ выносится на третью.
Полезно, когда фича готова к разработке, а продажи и руководство уже спрашивают, что там. Один файл вместо трёх пересказов.
Какие задачи решает
- собрать один документ о фиче для продаж, руководства и разработки
- зафиксировать неочевидные бизнес-правила до старта разработки
- перечислить out-of-scope с причиной, чтобы не спорить потом
- показать зависимости и порядок выхода фич
- ответить на частые вопросы по фиче без созвонов
Примеры запросов агенту
- Сгенерируй executive summary для фичи в папке
billing-export - Собери
executive-summary.mdпо SPEC.md и background.md этой фичи - Сделай саммари фичи: проблема, решение, ключевые решения и что не делаем
Как установить exec-summary
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill exec-summary -a claude-code2Вручную: положить файлы
~/.claude/skills/exec-summary/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/exec-summary/
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill exec-summary -a codex2Вручную: положить файлы
.agents/skills/exec-summary/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill exec-summary -a cursor2Вручную: положить файлы
.cursor/skills/exec-summary/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mvschwarz/openrig exec-summary2Вручную: положить файлы
.github/skills/exec-summary/SKILL.md1Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill exec-summary -a gemini-cli2Командой платформы
gemini skills install https://github.com/mvschwarz/openrig --path skills/_canonical/pm/exec-summaryВручную: положить файлы
.devin/skills/exec-summary/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mvschwarz/openrig --skill exec-summary -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о exec-summary
Как установить exec-summary в Claude?
Выполните npx skills add mvschwarz/openrig --skill exec-summary -a claude-code. Файл скилла окажется по пути ~/.claude/skills/exec-summary/SKILL.md.
Что делает exec-summary?
Читает файлы фичи и пишет executive-summary.md на 600–800 слов: проблему, решение, аудиторию, ключевые решения, out-of-scope, зависимости, метрики и FAQ для продаж, руководства и разработки.
Какие файлы нужны для работы скилла?
SPEC.md, background.md, validation.md и ASCII-макеты в supporting/. Без них контекст для саммари брать негде.
Исходный текст
SKILL.md · Apache-2.0
--- name: exec-summary description: "Generate a 1-2 page executive summary for a feature — orients sales, leadership, and engineering from a single document." --- You generate an executive summary for a feature that's ready for development. The summary orients three audiences from one document: sales (pitch), leadership (strategy), and engineering (behavioral overview). ## What You Produce A single `executive-summary.md` file in the feature folder. 600-800 words excluding mockups and FAQ. Written in present tense as if the feature already exists. ## Sources to Read Before writing, silently gather all context from the feature folder: 1. **SPEC.md** — acceptance criteria, business rules, scope, user stories 2. **background.md** — customer drivers, competitive context, regulatory considerations 3. **validation.md** — demand evidence, status quo, desperate user, narrowest wedge 4. **supporting/mockup-ascii.md** — visual mockups (pull 2-3 key screens) ## Output Structure ```markdown --- title: "Executive Summary: [Feature Name]" feature: [feature-folder-name] status: [ready | in-progress | shipped] jira: [ticket key] updated: [today's date] --- # [Feature Name] ## The Problem [2-3 sentences. Customer pain in their language. Name real customers/prospects.] ## The Solution [2-3 sentences. What we built, present tense. No jargon.] ## Who It's For [Primary personas + named customers/prospects waiting for this.] ## Why Now [Deals it unblocks, competitive gap it closes, what it enables next.] ## How It Works [5-8 key capabilities. Describe actual user-facing behavior — enough for a dev to understand what to build.] ## Key Decisions [5-8 non-obvious business rules and design choices. Focus on surprising or counter-intuitive ones.] ## Visual Preview [2-3 ASCII mockup screens from supporting/ — the key screens that tell the story.] ## What We're NOT Building [5-8 key out-of-scope items with brief reason.] ## Dependencies & Sequencing [What must ship first. Cross-feature dependencies. Prerequisites.] ## Success Metrics [2-4 measurable outcomes. Mix of usage and business metrics.] ## FAQ ### For Sales [2-3 questions. When available, what to tell prospects, competitive positioning.] ### For Leadership [2-3 questions. Opportunity cost, strategic fit, risks.] ### For Engineering [2-3 questions. Dependencies, known risks, what's deferred, data model implications.] ``` ## Writing Guidelines - **Present tense throughout.** Write as if the feature exists. - **Customer-readable language.** A prospect should understand sections 1-5. - **Be specific, not vague.** Name deals, dollar amounts, competitors. - **Key Decisions should surprise.** Don't list obvious things. - **Mockups are curated.** Pick the 2-3 that tell the story. - **FAQ answers should be direct.** No hedging. - **Hard cap: 2 pages** for core content. FAQ can be a third page.
© mvschwarz · Apache-2.0 · mvschwarz/openrig