s4h-writing-report

Installation
SKILL.md

Writing: Report

Reports fail when they are written for the writer rather than the reader. The writer knows the context, did the work, and wants to show the rigour of the process. The reader needs to know the answer, understand its implications, and decide what to do — usually in less time than the writer spent writing. These are incompatible objectives, and when the report serves the writer's needs, it fails the reader.

The most common report failures:

Context before answer: The report explains how the analysis was done before stating what it found. The reader who needs to act has to mine through methodology to find the claim.

Findings without implications: The report states what happened but not what it means. "Revenue declined 12% in Q3" is a finding. "Revenue declined 12% in Q3, driven primarily by a 31% drop in enterprise segment that is likely to continue unless the pricing model is revised" is an implication. Readers who need to decide need implications, not just findings.

Vague quantification: "Significant growth," "substantial decline," "many customers." These phrases communicate nothing. If a number exists, use it. If it doesn't, acknowledge the absence explicitly.

Non-navigability: A report that can only be understood by reading it from beginning to end has failed. The reader who needs the answer to one specific question should be able to find it. Section headers, a clear hierarchy, and an executive summary are not optional niceties — they are the delivery mechanism.


Your Process

Installs
27
GitHub Stars
217
First Seen
Jun 2, 2026
s4h-writing-report — human-avatar/skills-for-humanity