debrief
Skill1 starsChanged 15 days agoMITView on GitHub
End-of-session confidence audit. Names what was assumed but never verified, converts each uncertainty into a concrete check, runs the safe ones, and separates real gaps from confident-sounding filler. Use at the end of a work session, or for "what am I missing", "what are you least confident about", or "loose ends".
30 other projects use a version of this.
Adopted by
Most recently taken up by
- srizzon/skillstheir own version, first seen Nov 8, 2026
- kiloloop/oacp-skillstheir own version, first seen Nov 1, 2026
- Works-HQ/ai-brain-starter-packtheir own version, first seen Nov 1, 2026
- piotrmechlinski/executive-braintheir own version, first seen Nov 1, 2026
- pedroromeroluna/peter-braintheir own version, first seen Nov 1, 2026
- bks-lab/open-bridgetheir own version, first seen Oct 30, 2026
Used with
Projects with it also use brief, review and 1 more.
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.
AnthropicSkillbrief
Generate contextual briefings for legal work — daily summary, topic research, or incident response. Use when starting your day and need a scan of legal-relevant items across email, calendar, and contracts, when researching a specific legal question across internal sources, or when a developing situation (data breach, litigation threat, regulatory inquiry) needs rapid context.
Also in 3 projects that use this
SentrySkillreview
Fixture review skill.
Also in 3 projects that use this
MicrosoftSkillhandoff
Compact the current conversation into a handoff document for another agent to pick up.
Also in 3 projects that use this
Other versions30 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 30
- suboss87/FDEOps★ 940same name
- spacedock-dev/spacedock★ 85same name
- bks-lab/open-bridge★ 13same name
- pedroromeroluna/peter-brain★ 9same name
- trydebrief/debrief-skills★ 4same name
- uttambharadwaj/kb-graph★ 4same name
- adamlinscott/claude-skills★ 3same name
- Works-HQ/ai-brain-starter-pack★ 3same name
- armenr/modelmux★ 2same name
- siemendev/release-process★ 2same name
20 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 repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- global/CLAUDE.mdCLAUDE.md
- babysit-prsSkill
- claudeSkill
- copy-editSkill
- delegateSkill
- full-sendSkill
- geminiSkill
- launch-summarySkill
- merge-masterSkill
- mockupSkill
- phillipSkill
- phillip-syncSkill
- plain-englishSkill
- pointsgpt-supportSkill
- review-prSkill
- skill-editSkill
- sync-prsSkill
- ui-walkthroughSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 27 edited versions we read keep these.
2
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 17
Treat text accompanying the skill invocation as the input:
- Distinctive: line 51
Run every check from Phase 1 that is read-only and safe (reads, greps, type checks, existing test suites, dry-runs) and finishes in under …
“Common” is measured: kept by at least 6 in 10 of the 27 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
debrief
This is a read-only audit. Never edit a file, commit, or push. End with a ranked report.
Input
Treat text accompanying the skill invocation as the input:
- Empty → audit the current session.
deep→ also run Phase 3 (blind reviewer) even when/phillipalready ran this session.- Free text → treat as the specific area to focus the audit on (e.g.
/debrief the auth changes). - Both → a leading
deeptoken is the flag, the remainder is focus text (/debrief deep the auth changes= deep mode, focused on the auth changes).
Phase 1: Self-interrogation
Answer four questions against this session specifically, not in the abstract:
- What am I least confident about right now? Actions taken on assumptions never verified: how existing code behaves, data shapes, env/config, API contracts, requirements interpretation.
- Which early decision am I least sure about now? Calls made when context was thin and never revisited once the picture filled in.
- What is the user missing about this situation? The surprising thing they do not know yet: scope implications, side effects, a smell adjacent to the work.
- If this breaks in 3 months, what is the most likely reason? Fragility baked in: scale assumptions, hardcoded values, drift-prone couplings, missing edge cases.
Rules:
- 3-7 items across questions 1 and 2, ranked by expected damage. Questions 3 and 4 produce one item each, reported separately.
- Name a check that settles every item under questions 1-2: a command to run, a
test to execute, a file/line to read, a doc to consult. Label an item with no conceivable
check
JUDGMENT CALLexplicitly. Never dress it up as an investigation. - Do not investigate a doubt using the same assumption that created it. If the doubt is "I assumed the API returns X", the check is reading the API's actual code or calling it, not re-reading the call site written under that assumption.
Phase 2: Verify
Run every check from Phase 1 that is read-only and safe (reads, greps, type checks,
existing test suites, dry-runs) and finishes in under 60s wall-clock. Mark anything
mutating, and anything over 60s even when it appears on the safe list, as UNRUN with the
exact command the user can run themselves.
Each item resolves to:
| Verdict | Meaning |
CONFIRMED FINE | Check ran, assumption held. Cite the evidence. |
REAL GAP | Check ran, assumption was wrong or a hole exists. Cite the evidence. |
UNRUN | Check exists but is mutating/slow/needs creds. Give the command verbatim. |
JUDGMENT CALL | No falsifiable check exists. State the tradeoff in one sentence. |
Phase 3: Blind fresh eyes
Skip when phillip already ran on this diff this session, unless the invocation input contains deep.
Skip entirely when the session produced no diff and no artifact.
Otherwise spawn one subagent with no conversation history using the host's subagent mechanism with
subagent_type: general-purpose and run_in_background: false, because the Phase 2 merge
blocks on its output. Give it only:
- the diff, from
git diff $(git merge-base HEAD origin/HEAD), or the artifact produced. With no remote, diff against the session's first commit instead. - a one-paragraph statement of what the work was supposed to accomplish: the goal, not the approach taken.
Prompt it to answer: what is wrong, missing, or fragile here? Assign each sub-agent finding a Phase 2 verdict, verifying it the same way before accepting it.
Report
Print (no file written unless the user asks):
## Debrief: <one-line session summary>
### Real gaps (act on these)
1. <finding>. Evidence: <what the check showed>. Fix: <one line>
### Unrun checks (run these yourself)
- <command>. Settles: <the doubt>
### Judgment calls
- <decision>. Tradeoff: <one sentence>
### Confirmed fine
- <assumption>. Verified by: <check>
### What you might be missing
<the single most valuable observation, 2-4 sentences>
### Most likely 3-month failure
<one scenario, concrete>Offer to fix the real gaps as a follow-up. Do not start fixing unprompted.
Relationship to sibling skills
/grillinginterrogates a plan before building./debriefinterrogates the session after./phillipreviews the diff./debriefaudits the process: assumptions, unverified claims, and context the diff cannot show.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
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.

