editorial-voice-wsj-like

WSJ-like news writing for reports. Use when writing or editing the prose of a report, briefing, figure caption, executive summary or research summary so it reads like disciplined business news reporti

SKILL.md

GitHub

Editorial voice (WSJ-like)

Write like a careful business reporter explaining numbers to a busy, sceptical reader: precise, attributed, short, and honest about what is not known.

This is a WSJ-like news style: our own adaptation, written from cited public sources (the front-page nut-graf formula, Bill Blundell's story blocks, reported 2023 usage changes) in our own words. It is not The Wall Street Journal's style guide, is not affiliated with or endorsed by the paper, and uses none of its fonts or logos. See SOURCES.md.

Structure

Briefs and monitoring updates: inverted pyramid. The most important fact first, with its number and comparison. Then the next most important. A reader who stops after one paragraph has the news.

Analyses and exception reports: lede, nut graf, body, kicker. This is the front-page feature formula the Journal is known for, which Poynter traces to managing editor Barney Kilgore's 1941 ban on "today" and "yesterday" in leads: news need not have happened today to matter, so lead with significance and trends rather than the calendar.

  1. Lede (paragraph 1). A specific, concrete opening: the fact, the customer case, the campaign. Not the calendar ("This week, …") and not the process ("We analysed …"). In a business briefing the lede is usually the number itself; an anecdote (one customer's cancelled order) is used only when it stands for the pattern, and says so.
  2. Nut graf (right after the lede; by paragraph 2–4 at the latest). One paragraph that steps back from the case to the pattern and answers "why should I bother with this?": what changed, how big, why now, what it means for a decision. Our own practice (not from the cited sources): write it first, as one or two sentences, before drafting, and rewrite it as the evidence comes in, because it exposes gaps. It is an argument, so every clause in it needs evidence in the body. One paragraph; two or three at the very most. If you cannot write it, there is no story yet: send a monitoring update instead.
  3. Body: cover the bases, support then counter-evidence. Build the body from the six blocks below, in the order the reader's questions arise. Each supporting paragraph is followed, where it exists, by the strongest evidence against or the main alternative explanation. Unknowns are stated as unknowns.
  4. Kicker: close with the decision or the open question, not a summary of what was already said and not a flourish.

Misuses to avoid: a nut graf that promises more than the body proves; one that repeats the lede in abstract words; burying it below the first figure; a report so formulaic that every issue has a "story" when nothing happened.

Cover the bases: six story blocks

William Blundell, a former Journal page-one writer and writing coach, organised material around six blocks (as described by Chip Scanlan at Poynter). Use them as a reporting checklist for any exception or analysis, and as the skeleton of the body. Skip a block only deliberately.

Block Question Example, fictional online furniture shop (figures invented): conversion fell to 24%
History When did it start; what led here? first week below 28% since March; price list v7 on 28 Sep
Scope How big; how many affected; how much money? 412 design consultations a week; about €12,000 a month per point
Reasons What forces drive it? mix shift toward Meta leads; v7 delivery fee +€40
Impact Who gains or loses, and how much? sofa orders most affected; delivery slots under-filled mid-October
Countermoves Who is acting on it, and with what effect? Meta spend capped since 2 Oct; sales calling back open consultations
Future What happens if nothing changes, per the people and data involved? October orders ~15% under plan on the current trend (forecast v3)

The same blocks work for research: history (prior results), scope (how many benchmarks, effect size), reasons (mechanism), impact (who should change practice), countermoves (competing methods, failed replications), future (open questions, what would falsify it).

Sentence rules

  • Numbers carry unit, period and base. "Revenue was €182,400 in September, up 9% from August" not "revenue grew strongly".
  • Attribute every claim. Data: "according to the order service (retrieved 5 Oct)". People: name and role. Inference: say whose ("the analysis suggests"). An unattributed claim is the writer's opinion; label it or cut it.
  • Separate reporting from opinion. Findings and recommendations live in separately labelled sections. A recommendation never appears as a finding.
  • Verbs proportional to evidence. "rose", "fell", "was unchanged"; causal verbs only as statistical-claims allows. No "skyrocketed", "plummeted", "game-changing", "massive", "unprecedented" unless the number and the full history justify it.
  • Concrete and short. Subject, verb, number. Active voice. One idea per sentence; most sentences under about 25 words. Delete "very", "really", "significantly" (unless statistical, and then define it).
  • Names. Full name and role at first mention, surname after; no courtesy titles (Mr., Ms., Dr. as an honorific). The Journal reportedly dropped courtesy titles in 2023. Occupational titles are kept ("analyst", "CFO"); that part is our own rule, not something the reports describe. In a small team's internal briefing, first names are acceptable if used consistently.
  • Company names without legal suffixes (Inc., Corp., Oy, Ab) in running text unless the legal entity matters (also reportedly dropped by the Journal in 2023).
  • "Said" is the attribution verb. Not "claimed", "admitted", "revealed", "slammed": those editorialise. Attribution goes after the fact it supports, not before a string of clauses.
  • Quotes for judgement and colour, not for facts. A number belongs in your sentence with its source; a quote earns its place when it carries a view or a voice ("We lost three sofa orders to the delivery fee this week," the head of customer service said). Never paraphrase a person into more certainty than they expressed.
  • Absolute time. "the week to 4 October", "since 28 September", not "last week" or "recently": briefings are read later and forwarded.
  • One precise hedge, not many vague ones. "The data cannot yet separate price from mix" beats "this may possibly suggest".
  • Explain jargon once, in passing. "ROAS, revenue per euro of ad spend, …"; then use the term.
  • No new facts while editing. An edit may cut, reorder and sharpen. It may not introduce a number, cause or quote that is not in the evidence.

Editing pass (classify → diagnose → revise → verify)

Run references/editing-pass.md on any draft: classify the piece (brief, exception, analysis), check the nut graf exists by paragraph 4, flag every unattributed claim and every number without unit/period/base, revise, then verify that every number in the revision still matches the evidence.

Good / bad

Bad:

This week we saw some really interesting developments in conversion, which dropped significantly, probably due to the new pricing.

Good (illustrative; a fictional online furniture shop, figures invented):

Consultation-to-order conversion fell to 24% in the week to 4 October, from 31% a week earlier, on 412 design consultations, according to the order service.

The drop matters because October opens the pre-holiday buying season: at about 1,800 consultations a month and September's average order value of €690, each lost point of conversion is roughly €12,000 of monthly revenue. [nut graf]

The fall coincided with price list v7, which raised the delivery fee by €40. But the share of consultations from Meta ads, which convert at half the rate of referrals, also rose from 18% to 29%; the data do not yet separate the two. [support, then counter-evidence]

Checklist

  • Form chosen: inverted pyramid (brief) or lede + nut graf (analysis).
  • Nut graf present by paragraph 2–4; states what changed and why it matters now.
  • Body covers history, scope, reasons, impact, countermoves, future (or skips one deliberately).
  • Kicker is a decision or open question; attribution verb "said"; absolute dates.
  • Every number has unit, period and comparison base.
  • Every claim attributed; opinion and recommendation labelled.
  • Strongest counter-evidence or alternative explanation included.
  • No hype words; causal verbs match the design.
  • No courtesy titles; no legal suffixes in running text.
  • Editing introduced no new facts; numbers re-verified.

Adapted in part from jamditis data-journalism (MIT); changed: the observation/interpretation split and evidence-matched wording rewritten into sentence rules, examples replaced. Sources and licences: SOURCES.md.