business-writing — скилл для Claude Code: деловая переписка
Скилл помогает составлять деловые письма, записки и отчёты: сначала вывод или просьба, затем факты и следующий шаг. Пригодится для статусов, брифов решений и итогов встреч.
npx skills add surendranb/writing-skills --skill business-writing -a claude-codeЧто делает business-writing
Скилл задаёт структуру делового текста: начать с вывода или просьбы, подкрепить их фактами, затем указать нужное действие или следующий шаг. Он предлагает активные глаголы, короткие абзацы и конкретные числа вместо оценочных слов. Для вариантов решения рекомендация идёт первой, затем — альтернативы с их компромиссами.
В инструкциях также есть список запрещённых клише и проверка готового текста: ясна ли главная мысль с первой строки, есть ли явная просьба с глаголом и сроком, не длиннее ли предложения 25 слов. Это ориентир для проверки, а не гарантия, что агент сам получит недостающие цифры: правило требует опираться на числа и контекст. Длинный черновик придётся сокращать.
Какие задачи решает
- составить письмо руководителю с ясной просьбой и сроком
- переписать статус проекта так, чтобы вывод шёл первым
- подготовить бриф решения с рекомендацией и альтернативами
- сжать итоги встречи до фактов и следующих действий
Примеры запросов агенту
- Перепиши этот статус проекта: сначала главный вывод, затем подтверждающие факты и следующий шаг.
- Составь письмо руководителю с конкретной просьбой и сроком ответа.
- Подготовь бриф решения: поставь рекомендацию первой, а альтернативы опиши с их компромиссами.
Как установить business-writing
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a claude-code2Вручную: положить файлы
~/.claude/skills/business-writing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/business-writing/
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a codex2Вручную: положить файлы
.agents/skills/business-writing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a cursor2Вручную: положить файлы
.cursor/skills/business-writing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install surendranb/writing-skills business-writing2Вручную: положить файлы
.github/skills/business-writing/SKILL.md1Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a gemini-cli2Командой платформы
gemini skills install https://github.com/surendranb/writing-skills --path skills/business-writingВручную: положить файлы
.devin/skills/business-writing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о business-writing
Как установить business-writing в Claude Code?
Выполните npx skills add surendranb/writing-skills --skill business-writing -a claude-code. Файл скилла находится по пути ~/.claude/skills/business-writing/SKILL.md.
Что делает business-writing?
Помогает строить деловую коммуникацию от главного вывода к фактам и нужному действию. Также проверяет активный залог, клише, длину предложений и явность просьбы.
Как скилл оформляет варианты решения?
Сначала ставит рекомендацию, затем перечисляет альтернативы и кратко указывает компромисс для каждой.
Исходный текст
SKILL.md · MIT
---
name: business-writing
description: Write executive-grade business communication with BLUF (bottom line up front), active verbs, and zero buzzwords. Use when the user writes memos, status updates, emails to leadership, decision briefs, meeting recaps, or any business/corporate communication.
---
# Business Writing
Respect the reader's time. Verdict first, evidence after, decision-ready.
## The core rule
**BLUF — the bottom line is the first line.** Executives read the first sentence; if it does not contain the answer, the rest may never be read. Every paragraph earns its place by carrying a fact, a decision, or a requested action.
Workflow: `one sentence: the verdict or the ask` → `2–4 supporting facts with numbers` → `one sentence: what you need or what happens next` → `delete everything else`.
## Mechanics
1. **First sentence = verdict or ask.** "Q3 revenue missed by 12% and we recommend extending the campaign." If the answer is a decision, say the decision.
2. **One idea per paragraph, one decision per paragraph.** If a paragraph contains two decisions, split it.
3. **Numbers over adjectives.** "12% below target, $84K short" not "significantly below expectations."
4. **Active, concrete verbs.** "We shipped", "I recommend", "The fix resolved". Never "it was determined that".
5. **State the ask explicitly.** "I need your approval by Friday." Never implied asks.
6. **No buzzwords.** Ban list: synergy, leverage (as verb), circle back, touch base, bandwidth, move the needle, low-hanging fruit, deep dive, going forward, best-in-class, robust, seamless, optimize (unspecified).
7. **Short paragraphs, short sentences.** 15–20 words average; paragraphs 2–4 sentences.
8. **Options with recommendations.** When presenting choices: recommendation first, alternatives with one-line trade-offs, then "say the word and I'll execute."
## Verify
- The first sentence contains the point (highlight it: can the rest be skimmed safely?)
- Every number is attached to a unit or context ("12% of Q3 target")
- No banned buzzwords (grep the draft)
- One explicit ask, stated as a verb + deadline
- No sentence over 25 words
## Do not
- Bury the verdict in context or "as we know" preamble
- Use passive voice for decisions ("it was decided" → "we decided")
- Deliver problems without a recommendation (every caveat comes with a path)
## Example transformations
**Before:** "Following a review of the recent performance metrics, it appears that there may be some softness in our pipeline coverage going forward, and we are currently exploring potential options to address this, with several avenues under consideration at this time."
**After:** "Pipeline coverage is down 18% this quarter, which puts Q4 at risk. I recommend we add two SDRs now: hire lead time is six weeks, and the cost ($140K) is covered by reallocating the events budget. I need your sign-off by Friday to start interviews."
**Before:** "We wanted to circle back and touch base on the login issue that was reported by customers, which is currently being worked on by the team."
**After:** "Login failures are fixed and deployed (99.2% success now vs 91% before). Customers who reported the issue have been notified. No action needed from you."
© surendranb · MIT · surendranb/writing-skills