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.
