Use when drafting or revising non-academic prose such as emails, memos, letters, plans, articles, web copy, speeches, resumes, or executive briefs; use academic-writing for scholarly outputs and executive-communication for decision-led executive synthesis.
Single entry skill for any non-academic prose artifact. For reports, proposals, and white papers (longer-form persuasion artifacts with structural conventions of their own), load report-and-proposal-craft instead.
If the artifact explains, argues, persuades, recommends, evaluates, or interprets, run critical-reasoning-and-argument before drafting. This applies to market notes, strategy memos, intelligence-style updates, internal comms, speeches, fundraising letters, and executive briefings.
If the artifact describes how a system, process, workflow, operating model, interface, data architecture, requirements set, or design system works, run systems-process-requirements before drafting.
Growth engine first; metrics and experiments support
The seven-step process (load references/maxwell-7-steps.md)
Every non-academic artifact runs through:
Identify Readers & Purpose — name primary/secondary readers; one-sentence purpose.
Collect Information — source dossier; triangulate load-bearing facts.
Brainstorm — 15–20 candidate items without self-editing.
Organize — pick a structural pattern; outline as descriptive headings.
Draft — write fast; do not edit while drafting; use [TK] placeholders.
Revise — four passes (structure, paragraph, sentence, word) — never combined.
Proof — mechanical only; on paper or out loud; two human eyes.
Skipping a step or combining Steps 6 and 7 is the #1 quality failure.
The master rule (Roman & Raphaelson)
"Don't mumble."
Every sentence carries its point at full volume. Hedge soup, Latinate fog, and bureaucrat voice are cardinal sins. Detail in references/roman-raphaelson-principles.md (the 18 principles).
Reference index
Reference
Load when
references/maxwell-7-steps.md
Always — process spine for every artifact, plus channel overlays
references/roman-raphaelson-principles.md
Sentence-level prose discipline (18 principles, per-channel rules for email/memo/letter/plan/proposal/presentation/fund-raising/resume)
references/persuasion-and-narrative.md
Plans, pitches, fundraising, exec summaries — Hood plain English + Shiach persuasion + Geffner business style + Rubie/Provost narrative; also "make it sound less AI"
references/web-copywriting.md
Web pages, marketing copy, landing pages, blog post structure
references/blog-publishing-workflow.md
Producing a full blog article (topic dev, drafting, on-page structure, image prep, site integration)
references/language-standards-en-fr-sw.md
Multi-language artifacts: English (British/East African), French (Francophone African), Kiswahili (East African)
Use for non-academic prose where channel, audience, purpose, and action determine the form.
Do Not Use When
Use academic-writing for scholarship and report-and-proposal-craft for formal long reports or proposals.
Inputs
Input
Source/provider
If absent
Audience, channel, purpose, desired action
Requester
Stop and clarify the communication task
Facts, voice, constraints
Approved sources and organisation
Mark gaps; do not invent authority or examples
Workflow
Select the channel and desired reader action.
Gather verified substance and choose the fitting reference.
Draft answer-first in the requested voice.
Stop on unsupported persuasion; recover by qualifying or removing it.
Test clarity, accuracy, tone, and actionability.
Outputs
Artefact
Consumer
Acceptance condition
Channel-ready draft
Intended reader and sender
Purpose, evidence, voice, and requested action are clear
Writing Evidence Guidance
The source notes, audience/action decision, and final checklist support the draft.
Writing Capability Notes
Drafting is allowed only when requested. Sending, publishing, impersonation, spending, or binding commitments require explicit authority.
Degraded Mode
Fallback without facts or voice guidance: provide a labelled draft with gaps and placeholders; mark unavailable checks not assessed and do not present it as send-ready.
Decision Rules
Choice
Action
Failure/risk avoided
Reader needs a decision
Lead with the ask
Buried action
Claim is persuasive but unsupported
Remove or source it
Misrepresentation
Formal long-form deliverable
Route to report craft
Wrong structure
Quality Standards
The piece is specific to its reader and channel, factually traceable, concise enough for the purpose, and clear about the next action.
Business Writing Pitfalls
Writing before naming the reader; define them.
Burying the ask; lead with it.
Inflating weak evidence; qualify it.
Copying one voice across channels; adapt deliberately.
Sending a draft without authority; keep it unsent.
Worked Example
A decision email opens with the requested approval and deadline, then gives only the evidence needed to decide.
References
Seven-step process
Channel scenarios
Evidence Produced
Evidence
Consumer
Acceptance condition
Audience-action decision and source notes
Sender, editor, and approver
The draft's facts, voice, channel, and requested action trace to approved inputs
Capability Contract
Minimum capability is read-only access to the brief, approved facts, and voice guidance. Drafting, editing, sending, publishing, spending, or binding commitments require explicit authorisation.
Anti-Patterns
Writing before identifying the reader. Fix: define the reader and desired action.
Burying the ask. Fix: lead with the decision or response required.
Inflating weak evidence. Fix: source, qualify, or remove the claim.
Copying one voice across channels. Fix: adapt register deliberately.
Sending an unapproved draft. Fix: keep it labelled as a draft until authorised.
Companion skills
report-and-proposal-craft — long-form persuasion (reports, proposals, white papers).
critical-reasoning-and-argument — mandatory for non-academic prose that argues, recommends, evaluates, interprets, or persuades.
systems-process-requirements — for process notes, operating-model descriptions, requirements summaries, workflow explanations, and system/data/interface descriptions.
web-scraping-foundations — for pulling source material when needed.
1---2name: business-writing3description: Use when drafting or revising non-academic prose such as emails, memos, letters, plans, articles, web copy, speeches, resumes, or executive briefs; use academic-writing for scholarly outputs and executive-communication for decision-led executive synthesis.4---56# Business Writing78Single entry skill for any non-academic prose artifact. For reports, proposals, and white papers (longer-form persuasion artifacts with structural conventions of their own), load **`report-and-proposal-craft`** instead.910If the artifact explains, argues, persuades, recommends, evaluates, or interprets, run `critical-reasoning-and-argument` before drafting. This applies to market notes, strategy memos, intelligence-style updates, internal comms, speeches, fundraising letters, and executive briefings.1112If the artifact describes how a system, process, workflow, operating model, interface, data architecture, requirements set, or design system works, run `systems-process-requirements` before drafting.1314## Channel router1516| Channel | Right reference | Process spine |17|---|---|---|18| Email | `references/maxwell-7-steps.md` § email · `references/roman-raphaelson-principles.md` § email | Subject line carries verb; ask in first line; ≤200 words |19| Memo | `references/roman-raphaelson-principles.md` § memos | Title, action recipient, obvious structure |20| Letter (sales / fundraising / complaint / recommendation) | `references/roman-raphaelson-principles.md` § letters | Open with reader's interest; specific ask + deadline; PS line |21| Plan / strategy | `references/persuasion-and-narrative.md` · `references/maxwell-7-steps.md` § organize | SCQA + plain English |22| Blog article | `references/blog-publishing-workflow.md` · `references/web-copywriting.md` | Hook → problem → solution → CTA |23| Web copy / landing page | `references/web-copywriting.md` | F-pattern; value above fold; ≤400 words / page |24| Speech / presentation | `references/roman-raphaelson-principles.md` § speeches | Tell-tell-tell; one idea / slide; one ask |25| Resume / cover letter | `references/roman-raphaelson-principles.md` § resumes | Customised; achievements with numbers |26| Internal comms (status, updates, FAQs) | `references/roman-raphaelson-principles.md` § memos · `references/persuasion-and-narrative.md` | Lead with the news; numbered structure |27| Multi-language artifacts (EN / FR / SW) | `references/language-standards-en-fr-sw.md` | Apply per-language register rules |28| Hard scenario (bad news, decline, apology, discourteous reply, policy change) | `references/scenario-playbooks.md` | Resolve the four axes before drafting; pick named scenario |29| Pitch deck (investor / VC) | `references/extended-channels.md` § Pitch decks | Three critical questions; four-part structure; one visual per slide |30| One-pager / capability statement | `references/extended-channels.md` § One-pagers | Headline + CTA + testimonial; Think/Feel/Do test |31| Training material / instruction manual / course | `references/extended-channels.md` § Training material | Five learning principles; tools, not just text |32| Business plan (for lender / angel) | `references/extended-channels.md` § Business plans | Argument hierarchy first; story supports; meet lender early |33| Grant proposal (foundation / agency) | `references/extended-channels.md` § Grant proposals · `report-and-proposal-craft` | Read the call; budget reconciles to methodology |34| Performance appraisal | `references/extended-channels.md` § Performance appraisals | Behaviour → calibrated phrase → specific action |35| AI-assisted draft of any of the above | `references/ai-assisted-writing.md` | WI before AI; embed evidence-discipline clause in every prompt |36| Long-form magazine piece — essay, criticism, investigative, profile, explainer | `references/long-form-business-journalism.md` | Pick the family (essay / investigative / profile / explainer) before choosing length |37| Growth strategy / commercial memo | `../../extracted-books/growth-profit-disruption-research-notes.txt` · `references/persuasion-and-narrative.md` | Growth engine first; metrics and experiments support |3839## The seven-step process (load `references/maxwell-7-steps.md`)4041Every non-academic artifact runs through:42431. **Identify Readers & Purpose** — name primary/secondary readers; one-sentence purpose.442. **Collect Information** — source dossier; triangulate load-bearing facts.453. **Brainstorm** — 15–20 candidate items without self-editing.464. **Organize** — pick a structural pattern; outline as descriptive headings.475. **Draft** — write fast; do not edit while drafting; use `[TK]` placeholders.486. **Revise** — four passes (structure, paragraph, sentence, word) — never combined.497. **Proof** — mechanical only; on paper or out loud; two human eyes.5051Skipping a step or combining Steps 6 and 7 is the #1 quality failure.5253## The master rule (Roman & Raphaelson)5455> *"Don't mumble."*5657Every sentence carries its point at full volume. Hedge soup, Latinate fog, and bureaucrat voice are cardinal sins. Detail in `references/roman-raphaelson-principles.md` (the 18 principles).5859## Reference index6061| Reference | Load when |62|---|---|63| `references/maxwell-7-steps.md` | Always — process spine for every artifact, plus channel overlays |64| `references/roman-raphaelson-principles.md` | Sentence-level prose discipline (18 principles, per-channel rules for email/memo/letter/plan/proposal/presentation/fund-raising/resume) |65| `references/persuasion-and-narrative.md` | Plans, pitches, fundraising, exec summaries — Hood plain English + Shiach persuasion + Geffner business style + Rubie/Provost narrative; also "make it sound less AI" |66| `references/web-copywriting.md` | Web pages, marketing copy, landing pages, blog post structure |67| `references/blog-publishing-workflow.md` | Producing a full blog article (topic dev, drafting, on-page structure, image prep, site integration) |68| `references/language-standards-en-fr-sw.md` | Multi-language artifacts: English (British/East African), French (Francophone African), Kiswahili (East African) |69| `references/english-collocations-and-lexical-precision-2026-09-02.md` | Collocation, register, lexical precision, idiom restraint, calibrated claims, and human-quality proof |70| `references/ai-assisted-writing.md` | Any deliverable where an LLM is in the production chain — WI/AI division of labour, prompt design, fact-check discipline (Lindsell-Roberts) |71| `references/scenario-playbooks.md` | One-off communication artefacts where the message is hard — bad news, decline, apology, discourteous reply, policy change (Ramsey four-axis frame) |72| `references/extended-channels.md` | Pitch decks, one-pagers, training material, business plans, grant proposals, performance appraisals (Henwood / Lindsell-Roberts / Garner) |73| `references/long-form-business-journalism.md` | Long-form magazine writing — essay, investigative, profile, explainer — with craft lessons drawn from *The Best Business Writing 2014* (Starkman et al.) |74| `../../docs/continuous-improvement/english-collocations-and-lexical-precision-2026-09-02.md` | Cross-channel reader-centred English: genre register, grammar, collocation, lexical precision, idiom restraint, evidence-aware revision, and proof/read-aloud |75| `../../extracted-books/growth-profit-disruption-research-notes.txt` | Business growth, product-led growth, profit improvement, disruption, creativity, and commercial research productization |7677## Universal anti-patterns7879- **Mumbling** — soft openings, hedge stacks, evasive verbs.80- **Latinate fog** — *facilitate, utilize, leverage, optimize, expedite*.81- **Bureaucrat voice** — *heretofore, pursuant, said party, the aforementioned*.82- **Passive evasion** — "it was decided that…" hiding the actor.83- **Adjective inflation** — *significant, substantial, world-class, leading*.84- **Buried lead** — recommendation on page 4.85- **Walls of text** — paragraphs over 5 sentences without break.86- **One-size email** — same long email used for an ask, an FYI, and a heads-up.87- **Drafting before outlining** (Step 4 skipped).88- **Editing while drafting** (Step 5 corrupted with Step 6).89- **Combining revision passes** (rewriting in circles).90- **Treating proof as revision** — missing typos and link rot.91- **Sounds-like-AI prose** — repeated reporting verbs, unhedged certainty, perfectly parallel sentences, no quirks. Load `references/persuasion-and-narrative.md`.9293## Universal ship gate9495- [ ] Channel identified; right reference loaded.96- [ ] Step 1 purpose statement written.97- [ ] `critical-reasoning-and-argument` run where the artifact contains a claim, recommendation, interpretation, or persuasive ask.98- [ ] `systems-process-requirements` run where the artifact describes systems, processes, requirements, scope, workflow, data, interfaces, or design systems.99- [ ] Outline approved before drafting.100- [ ] Lead carries the news; nothing buried.101- [ ] Average sentence ≤20 words; max 30; varied length.102- [ ] One idea per paragraph; ≤5 sentences typical.103- [ ] Active voice unless deliberate.104- [ ] No Latinate substitutes where Anglo-Saxon works.105- [ ] No vague adjectives (*significant, substantial, very, really*).106- [ ] Numbers, names, dates instead of adjectives.107- [ ] First-revision cut ≥25 %.108- [ ] Channel-specific rule applied (subject line, F-pattern, slide discipline, etc.).109- [ ] Mechanical proof on paper / out loud; two human eyes for external artifacts.110- [ ] Multi-language: per-language register rules verified.111112## Companion skills113114<!-- dual-compat-start -->115## Use When116117Use for non-academic prose where channel, audience, purpose, and action determine the form.118119## Do Not Use When120121Use `academic-writing` for scholarship and `report-and-proposal-craft` for formal long reports or proposals.122123## Inputs124125| Input | Source/provider | If absent |126|---|---|---|127| Audience, channel, purpose, desired action | Requester | Stop and clarify the communication task |128| Facts, voice, constraints | Approved sources and organisation | Mark gaps; do not invent authority or examples |129130## Workflow1311321. Select the channel and desired reader action.1332. Gather verified substance and choose the fitting reference.1343. Draft answer-first in the requested voice.1354. Stop on unsupported persuasion; recover by qualifying or removing it.1365. Test clarity, accuracy, tone, and actionability.137138## Outputs139140| Artefact | Consumer | Acceptance condition |141|---|---|---|142| Channel-ready draft | Intended reader and sender | Purpose, evidence, voice, and requested action are clear |143144## Writing Evidence Guidance145146The source notes, audience/action decision, and final checklist support the draft.147148## Writing Capability Notes149150Drafting is allowed only when requested. Sending, publishing, impersonation, spending, or binding commitments require explicit authority.151152## Degraded Mode153154Fallback without facts or voice guidance: provide a labelled draft with gaps and placeholders; mark unavailable checks `not assessed` and do not present it as send-ready.155156## Decision Rules157158| Choice | Action | Failure/risk avoided |159|---|---|---|160| Reader needs a decision | Lead with the ask | Buried action |161| Claim is persuasive but unsupported | Remove or source it | Misrepresentation |162| Formal long-form deliverable | Route to report craft | Wrong structure |163164## Quality Standards165166The piece is specific to its reader and channel, factually traceable, concise enough for the purpose, and clear about the next action.167168## Business Writing Pitfalls169170- Writing before naming the reader; define them.171- Burying the ask; lead with it.172- Inflating weak evidence; qualify it.173- Copying one voice across channels; adapt deliberately.174- Sending a draft without authority; keep it unsent.175176## Worked Example177178A decision email opens with the requested approval and deadline, then gives only the evidence needed to decide.179180## References181182- [Seven-step process](references/maxwell-7-steps.md)183- [Channel scenarios](references/scenario-playbooks.md)184<!-- dual-compat-end -->185186## Evidence Produced187188| Evidence | Consumer | Acceptance condition |189|---|---|---|190| Audience-action decision and source notes | Sender, editor, and approver | The draft's facts, voice, channel, and requested action trace to approved inputs |191192## Capability Contract193194Minimum capability is read-only access to the brief, approved facts, and voice guidance. Drafting, editing, sending, publishing, spending, or binding commitments require explicit authorisation.195196## Anti-Patterns197198- Writing before identifying the reader. **Fix:** define the reader and desired action.199- Burying the ask. **Fix:** lead with the decision or response required.200- Inflating weak evidence. **Fix:** source, qualify, or remove the claim.201- Copying one voice across channels. **Fix:** adapt register deliberately.202- Sending an unapproved draft. **Fix:** keep it labelled as a draft until authorised.203204## Companion skills205206- `report-and-proposal-craft` — long-form persuasion (reports, proposals, white papers).207- `critical-reasoning-and-argument` — mandatory for non-academic prose that argues, recommends, evaluates, interprets, or persuades.208- `systems-process-requirements` — for process notes, operating-model descriptions, requirements summaries, workflow explanations, and system/data/interface descriptions.209- `academic-writing` — papers, essays, theses, dissertations.210- `web-scraping-foundations` — for pulling source material when needed.
Run npx skillmds@latest add peterbamuhigire/business-writing in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Use when drafting or revising non-academic prose such as emails, memos, letters, plans, articles, web copy, speeches, resumes, or executive briefs; use academic-writing for scholarly outputs and executive-communication for decision-led executive synthesis. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
peterbamuhigire (@peterbamuhigire) published this skill. Their other Agent Skills are listed on their SkillMD profile.