business-writing — Claude Code skill for business writing
This skill structures memos, leadership emails, status updates, and decision briefs around a clear takeaway. Use it when a draft needs a direct ask and supporting facts.
npx skills add surendranb/writing-skills --skill business-writing -a claude-codeWhat business-writing does
The skill guides the agent to lead with the conclusion or request, support it with facts, and state the next action. It favors active verbs, concise paragraphs, and figures over vague adjectives. When a draft presents choices, it puts the recommendation first and gives alternatives with their trade-offs.
Its checklist flags business clichés and checks whether the opening carries the point, the ask names an action and deadline, and sentences stay within 25 words. That last limit means a long draft will need trimming. The guidance calls for numbers tied to context, so it cannot supply evidence that the writer has not provided.
What it helps with
- put the decision and requested approval at the top of a memo
- rewrite a project update with a clear takeaway and next action
- draft a decision brief that compares a recommendation with alternatives
- turn meeting notes into concise facts and follow-up actions
Example prompts for the agent
- Rewrite this project update with the conclusion first, then supporting facts and the next action.
- Draft an email to leadership asking for approval by a clear deadline.
- Create a decision brief with the recommendation first and trade-offs for the alternatives.
How to install business-writing
1Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a claude-code2Manually: put the files in place
~/.claude/skills/business-writing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/business-writing/
1Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a codex2Manually: put the files in place
.agents/skills/business-writing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a cursor2Manually: put the files in place
.cursor/skills/business-writing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install surendranb/writing-skills business-writing2Manually: put the files in place
.github/skills/business-writing/SKILL.md1Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a gemini-cli2Platform CLI
gemini skills install https://github.com/surendranb/writing-skills --path skills/business-writingManually: put the files in place
.devin/skills/business-writing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add surendranb/writing-skills --skill business-writing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about business-writing
How do I install business-writing in Claude Code?
Run npx skills add surendranb/writing-skills --skill business-writing -a claude-code. The skill file is at ~/.claude/skills/business-writing/SKILL.md.
What does business-writing do?
It guides business drafts from the main point to evidence and a requested action. Its checks cover active wording, clichés, sentence length, and explicit asks.
How does the skill handle options?
It puts the recommended choice first, then presents alternatives with a brief account of their trade-offs.
Source text
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