briefing
Skill1 starsChanged 34 days agoMITView on GitHub
Write a one-page briefing or standup update — Headline, What's New, Why It Matters, What's Next / Asks — for a recurring audience that already holds context and needs the delta fast. Use for a terse status or situational update, not a narrative summary. Anti-trigger; for a longer standalone summary of a larger document written for a first-time reader use exec-summary, for a released-version history use changelog.
20 other projects use a version of this.
Adopted by
Most recently taken up by
- gustaferiksson/skillstheir own version, first seen Nov 8, 2026
- t128n/skillstheir own version, first seen Nov 8, 2026
- parker-brown-family/agent-skillstheir own version, first seen Nov 8, 2026
- Getty/briefingtheir own version, first seen Nov 8, 2026
- PatrickSUDO/fadacai-portfoliotheir own version, first seen Nov 6, 2026
- adeonir/agent-skillstheir own version, first seen Nov 6, 2026
Used with
Projects with it also use handoff and grill-me.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.Other versions20 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 20
- garrytan/gbrain★ 32ksame name
- PatrickSUDO/fadacai-portfolio★ 145same name
- google-gemini/gemini-managed-agents-templates★ 99same name
- norrietaylor/distillery★ 25same name
- bks-lab/open-bridge★ 13same name
- adeonir/agent-skills★ 8same name
- GavinGreenwood/agentic-workflow-template★ 5same name
- Getty/briefing★ 5same name
- Erionis/Jarvis-Lite★ 3same name
- flopperj/dotfiles-core★ 3same name
10 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository46 other files it gives its agents.
- academicSkill
- adrSkill
- ai-architecture-docSkill
- arc42-arch-docSkill
- audit-docsSkill
- business-planSkill
- c4-model-diagramSkill
- changelogSkill
- clinical-submissionSkill
- competitive-quadrantSkill
- compliance-auditSkill
- computing-paperSkill
- diataxis-explanationSkill
- diataxis-how-toSkill
- diataxis-referenceSkill
- diataxis-tutorialSkill
- doc-set-plannerSkill
- ears-acceptance-criteriaSkill
- engineeringSkill
- exec-summarySkill
- feature-specSkill
- google-design-docSkill
- humanities-chicagoSkill
- humanities-mlaSkill
- kiro-designSkill
- kiro-requirementsSkill
- kiro-tasksSkill
- legal-memoSkill
- market-research-reportSkill
- mif-corpusSkill
- mif-frontmatterSkill
- mif-provenanceSkill
- mif-to-pdfSkill
- mif-validateSkill
- nist-spSkill
- playbookSkill
- prdSkill
- python-pepSkill
- regulatory-disclosureSkill
- rust-rfcSkill
- security-pentestSkill
- sre-runbookSkill
- sustainability-reportSkill
- svg-chartsSkill
- systematic-reviewSkill
- trend-analysisSkill
The file
We split this skill into the rules it gives an agent
1 rule. 0 are common, 1 is distinctive, and 0 are very specific to this project.
0
Common
Most of the 17 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 38
Every "What's New" bullet carries a paired "Why It Matters" line — an update with no stated implication is incomplete.
“Common” is measured: kept by at least 6 in 10 of the 17 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
briefing
Produces a one-page briefing: a terse status or standup update for a recurring audience — a standup, a sync, a regular stakeholder update — who already hold the backdrop and need the delta and the next action, fast. It is harness-native: no named external body (ISO/NISO/ANSI/APA/etc.) prescribes a "briefing" format, so there is no domain standard to conform to here.
Pattern (one-page briefing / standup update)
- Headline — one line: the single most important thing to know right now.
- What's New — 2 to 4 bullets of the latest developments since the last briefing. Favor the delta (changed or new items) over restating what's already known.
- Why It Matters — one line per item: the implication or so-what. Every "What's New" bullet is paired with one of these — there is no orphan update.
- What's Next / Asks — the next actions, owners, and any decisions or inputs needed. Name something concrete; "continue monitoring" is not an ask.
Front matter carries a title, a date, and the period the briefing covers (since
the last update). No figures are required — this is a one-pager; add a single
status indicator only if it replaces a sentence, and render it as a Mermaid
xychart-beta, never ASCII art or an image. A footnote/source list is the only
back matter, and only when citation markers are used.
Rules
- Hard ceiling: one page. If it spills over, cut to the delta — the freshest, most decision-relevant items win over restated context.
- Lead with the change; do not re-explain standing background the recurring audience already holds.
- Every "What's New" bullet carries a paired "Why It Matters" line — an update with no stated implication is incomplete.
- Exclude claims known to be false; flag uncertain or weakened ones inline (e.g. "unconfirmed", "reportedly") rather than presenting them as settled.
- Account for everything the briefing is drawing from — compress to the delta, but never silently drop an item; note thin or uncertain ones instead of omitting them.
- Citations, when used, are inline markers (
[1],[2]) or bare links resolving to a short footnote list — never raw internal identifiers in the body prose.
Anti-triggers — do not use this genre for
- A longer, standalone summary of a larger document for a reader who does
not already hold context — that is
exec-summary: it re-establishes background rather than assuming it, and isn't bound to a recurring cadence or a "since last update" delta. - A curated, versioned history of released changes — that is
changelog: entries are anchored to release versions, not to a standup cadence. - A single already-made technical decision with its rationale on record —
that is
adr: immutable and driver-and-outcome shaped, not a status delta.
MIF frontmatter
type: episodic — a briefing is a time-bound record tied to a specific
coverage period, not durable declarative knowledge. The L1 floor is id,
type, created + body; climb to L2 with namespace (briefing/<area>),
title, and tags, and to L3 with modified, temporal validity,
provenance, citations[] for any sourced claims, and typed
relationships[]. Gate every output with mif-validate (--level 1
minimum).
Why machine-readable
| Question an agent asks | Answered by (frontmatter) |
| What period does this update cover, and is it still current? | temporal.validFrom / temporal.ttl |
| Where did each "What's New" item come from? | citations[] |
| Who or what produced this briefing? | provenance (W3C-PROV) |
| What does this briefing follow on from or feed into? | typed relationships[] (relates-to, derived-from) |
The same document still reads as a terse human status update and projects losslessly to JSON-LD and back — one artifact, two readers.
The L1 -> L3 climb
templates/good-l1.md— L1 floor:id,type,created+ body. A complete, valid briefing, but opaque to a machine consumer asking "is this still current?" or "where did this come from?".templates/good.md— L3 (highest this genre supports): addsnamespace,modified,temporalvalidity for the coverage period, W3C-PROVprovenance,citations[]tied to the "What's New" items, and a typedrelationships[]graph (e.g.relates-tothe prior period's briefing). Validate withmif-validate --level 3.
Author at the highest level the drafting context supports (grade down
rather than fabricate). templates/bad.md shows the antipattern: "What's New"
bullets with no paired "Why It Matters" — orphan updates the reader has no way
to weigh.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

