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.

Installs
2
Repository
pmndrs/glyph
GitHub Stars
141
First Seen
Sep 3, 2026
evidence-first — pmndrs/glyph