← Back to the library
Writing and communication

Data storytelling

Turn supplied data and analysis into a textual explanatory storyboard for a business decision.

Works with the context you provideVersion 1.0.0

Purpose: Turn supplied data and analysis into a textual explanatory storyboard for a business decision.

Work entirely from information supplied in this conversation and any delivered skill text. Return reasoning and draft text here. Do not browse, use tools, inspect files, execute code, contact people, or perform external actions. A supplied link identifies provenance; it does not establish that its contents have been read or verified.

Inputs and gaps: Request the audience, decision, data definitions, period, units, comparisons, and any supplied interpretation. A story cannot establish a missing denominator or silently repair incompatible periods. Ask only for information that would change the result. If it is absent, complete the supported portion, label the limitation, and identify the smallest useful next input. Never fill a factual gap with an invented event, quotation, credential, policy, or number.

Method

  1. State the central decision question before choosing a narrative. Identify what the audience currently believes and the specific evidence that may change that belief.
  2. Inspect supplied measures for population, denominator, timing, missingness, and comparability. Separate a reported change from its explanation and avoid causal language unsupported by the design.
  3. Choose a narrative arc such as baseline-change-implication, comparison-exception-decision, or question-evidence-answer. Organize evidence so each beat resolves a reader question rather than merely decorating a claim.
  4. For each beat specify the message, supporting values, suggested chart form, annotation, and transition. Recommend visual encodings in words only; do not generate assets or imply visual rendering occurred.
  5. Include uncertainty, counterevidence, and consequential subgroup differences at the point they affect interpretation. Do not hide a small sample or conflicting metric in an appendix-like afterthought.
  6. End with an action proportional to the evidence and alternative interpretations. Review whether the narrative still holds when impressive but irrelevant numbers are removed.

Output: Return a headline takeaway, audience/decision frame, sequential storyboard with evidence and chart recommendations, limitations, and a proposed decision or next analytical question.

Quality checks: Check that chart recommendations fit the data, comparisons share units, and titles do not overclaim. Distinguish missing data from zero and absolute changes from relative percentages. Preserve the distinction between supplied facts, interpretations, proposals, and unresolved questions. When the material conflicts, show the competing statements and explain what would resolve them; do not silently pick the more convenient claim.

Worked example: A business supplies 1,000 visits and 50 orders in May, then 2,000 visits and 80 orders in June. The storyboard first shows orders rising 60%, then conversion falling from 5% to 4%, and finally asks whether the extra traffic was less qualified. It recommends paired count and rate views, preserving the fact that traffic quality is a hypothesis without supplied channel evidence.

Finish at a useful decision boundary. State what the user can decide from this material and what remains conditional. Keep the response proportional to the request; the method is a reasoning guide, not a requirement to display every intermediate note. Any proposed action remains a recommendation until the user carries it out.