Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add surendranb/writing-skills --skill business-writing -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/business-writing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/business-writing/

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

Similar skills

All skills for Writing and docs →

From the same set16

orwells-rules This skill edits drafts using Orwell’s six writing rules, trimming clichés and excess words while favoring active voice. Use it to revise prose written by you or an agent. CX Codex +1 ★ 53repo stars journalism-ap A skill that holds the agent to Associated Press conventions when drafting news copy and press releases: attribution, numbers, dates, no editorializing. Useful when the text has to read as factual reporting. CX Codex +1 ★ 53repo stars jack-sparrow Rewrites plain announcements and updates into theatrical pirate prose inspired by Captain Jack Sparrow. Fits launch notes, status copy, and playful messages. CX Codex +1 ★ 53repo stars gov-uk-style This skill applies GOV.UK writing principles to public-facing content. Use it to revise help pages, service information, or policy summaries. CX Codex +1 ★ 53repo stars google-dev-docs A skill that makes the agent write technical docs the Google way: action headings, second person, present tense, active voice. Useful for READMEs, tutorials and API references. CX Codex +1 ★ 53repo stars corporate-communication Drafts internal announcements, leadership memos, and org updates with direct clarity and zero corporate boilerplate. CX Codex +1 ★ 53repo stars asd-ste100 Enforces ASD-STE100 Simplified Technical English rules for procedures and manuals so readers grasp the exact intended meaning without confusion. CX Codex +1 ★ 53repo stars skill-folder-name A writing-skill template for defining style rules, checks, prohibitions, and before-and-after examples. Use it when prose needs repeatable guidance. CX Codex +1 ★ 53repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor