SKILL.md
Delta Briefing Skill
The failure mode of every recurring report is that edition 6 reads like edition 5. This skill structures a recurring brief around the delta: read the last edition's state, diff the world against it, lead with what changed, and save state for the next run.
What This Skill Produces
- A changes-first brief: new / changed / resolved / unchanged-but-watched
- A state record (compact, machine-readable) that the next edition diffs against
- An explicit "nothing changed" edition format — short, honest, and still useful
Required Inputs
Ask for (if not already provided):
- The brief's subject and audience (competitive landscape, product metrics, account health…)
- The previous edition or state record — if none exists, this run is the baseline: say so in the output and produce the first state record
- Current sources for this cycle
- Where state lives between runs (a file next to the brief, a Brain folder — see BRAIN.md if using this library's memory)
Delta Method
- Load last state. Parse the previous state record (or previous edition if that's all there is). List the items it tracked and their status.
- Re-observe. Gather this cycle's facts from the sources — independently of the old state, so removals are caught too.
- Diff into four buckets:
- New — present now, absent last time - Changed — tracked before, materially different now (state what moved, old → new) - Resolved / gone — tracked before, no longer present or no longer a concern - Watching — unchanged but still worth tracking (compressed to one line each)
- Judge materiality. A delta makes the brief only if the audience would act differently knowing it. Trivia goes to the state record, not the brief.
- Write state for next time. Every tracked item, its current status, the date, and the sources read.
Output Format
[Brief name] — [date] (edition [n], previous: [date])
TL;DR: [1-2 sentences: the most consequential delta, or "no material changes"]
New since last edition
- [item] — [why it matters, one line]
Changed
- [item]: [old] → [new] — [implication]
Resolved
Still watching (one line each)
<details> <summary>State record (for the next run)</summary>
{ "edition": n, "date": "YYYY-MM-DD", "sources": ["..."],
"items": [ { "id": "...", "status": "...", "note": "..." } ] }
</details>
If nothing material changed: say exactly that in three lines — TL;DR ("no material changes"), what was checked, next edition date. Do not pad.
Quality Checks
Anti-Patterns