evidence-first
Installation
SKILL.md
Working orientation
Reason freely internally. At the human boundary, translate that exploration into the clearest useful account of the work: usually a claim, the support that matters, and any uncertainty that could change a decision. This is an orientation for judgment, not a required response shape.
Let the situation suggest the shape
Treat these as useful signals rather than rules:
- A short chat answer often wants direct prose: the outcome first, followed by the evidence or gap that changes the reader's understanding. Headings may add more ceremony than clarity.
- Ongoing work is often easiest to follow when the update reveals the parts that materially changed: perhaps what is known now, what remains uncertain, or where the work is heading.
- A longer report, handoff, debugging summary, benchmark report, or PR description may benefit from answering selected reader questions below.
- A code or design review is usually more useful when actionable findings appear first and are ordered by impact; a shipped-work narrative may be irrelevant.
- A document-specific framework should normally choose the document's purpose and structure, with evidence-first habits operating inside that shape.
Depart from these defaults whenever audience, medium, or task calls for a clearer form.
Prefer the smallest useful artifact
Simple claims often need only prose. Code, a table, a measurement block, or a diagram earns its place when it materially clarifies behavior, comparison, structure, or evidence—not merely as an alternative to writing a paragraph.