report-writing
Installation
SKILL.md
Report Writing
Overview
Report writing transforms research findings into clear, actionable documents for decision-makers. This skill covers best practices for structuring, writing, and visualizing market research outputs.
Critical Rules
- ALWAYS start with the Executive Summary — no report should open with methodology, background, or definitions. The first substantive section must state the bottom-line findings and recommendation.
- NEVER fabricate data — if a number is not provided, say so explicitly. Present ranges when sources disagree. Use hedging language ("data suggests", "estimated") for uncertain claims.
- EVERY finding must have a "so what" — orphan facts that don't connect to implications or recommendations waste the reader's time.
- ALWAYS use active voice — passive voice obscures who did what. Write "Stripe captured 40% share" not "40% share was captured by Stripe".
- ALWAYS include at least one Mermaid diagram — visualization is not optional. Use pie charts for composition, quadrant charts for positioning, state diagrams for scenarios.
- Recommendations MUST include What/Why/How/Risk — vague recommendations ("consider expanding") are useless. Be specific and actionable.
- Preserve exact data from the user — do not round, reinterpret, or omit numbers the user provides. Every data point given must appear in the output.
- Match report type to audience — executive briefs for C-suite (1-2 pages), research summaries for VPs (3-5 pages), full reports for analysts (10-30 pages).