minutes-debrief
Post-meeting debrief — analyzes what happened, compares outcomes to your prep intentions, tracks decision evolution
Install / Use
npx skills add silverstein/minutes --skill minutes-debriefInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of minutes-debrief
minutes-debrief scores 89/100 on our quality scale, 1626th of 4,698 Development & Engineering skills we index (top 35%).
Its SKILL.md is 10 KB long, well organised into 20 sections with 8 code examples: a thorough specification that gives an agent plenty to work with.
With 1,500 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so minutes-debrief is actively maintained.
- Our last check on 2026-10-31 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
minutes-debrief compared with similar skills
All 4 of these similar skills score higher than minutes-debrief; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| minutes-debrief (this skill)by silverstein | 89 | 1.5k | 54d ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
Frequently asked questions
- How do I install minutes-debrief?
- Run
npx skills add silverstein/minutes --skill minutes-debrief. The install tabs above show the steps for each supported agent. - Which AI agents does minutes-debrief work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is minutes-debrief safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is minutes-debrief still maintained?
- The repository was last updated about 2 months ago, so minutes-debrief is actively maintained.
Skill content
View source on GitHubname: minutes-debrief description: Post-meeting debrief — analyzes what happened, compares outcomes to your prep intentions, tracks decision evolution. Use when the user says "debrief", "what just happened in that meeting", "what did we decide", "debrief that call", "post-meeting", "what changed", or right after stopping a recording. compatibility: opencode
Skill Path
Before running helper scripts or opening bundled references, set:
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.opencode/skills"
export MINUTES_SKILL_ROOT="$MINUTES_SKILLS_ROOT/minutes-debrief"
/minutes-debrief
Post-meeting analysis that reads your latest recording, compares what happened to what you planned, and surfaces decision evolution — so nothing falls through the cracks.
How it works
This is a multi-phase interactive flow. It connects to /minutes-prep when a prep file exists, creating a before→after loop.
Phase 1: Find the most recent recording
minutes list --limit 5
Pick the most recent recording. If there are multiple from today, ask via AskUserQuestion: "You have [N] recordings today. Which one are you debriefing?" with options listing the titles.
If no recent recording exists:
Say: "I don't see any recent recordings. Did you run minutes record and minutes stop? If the recording is from a specific meeting, tell me the title or date and I'll find it."
Don't proceed without a recording to debrief.
Phase 2: Read the transcript
Run minutes get "<exact path>" --json, require exit status 0, and use only the
returned transcript and frontmatter. Never reopen the list path with the host
Read tool. Extract:
- Decisions made (from
decisions:frontmatter or## Decisionssection) - Action items created (from
action_items:frontmatter or## Action Itemssection) - Key discussion points (from
## Summaryor the transcript itself) - Attendees (from
attendees:frontmatter)
Phase 2a: No-capture sensitive meetings (capture: none)
If the authorized frontmatter says capture: none, there is no transcript by design: the
meeting was designated sensitive and the recorder never ran. The debrief IS the
record. Switch to debrief-from-memory mode:
- Use the already-authorized response: the
## Markerssection (timestamped notes typed during the meeting) and the frontmatter (title,date,duration,debrief:state). - Ask the user to recount the meeting: who was there, what was discussed, decisions, action items. Use the markers as memory joggers.
- Present the account in the conversation, but do not edit the meeting path through a host filesystem tool. Until Minutes exposes a native authorized debrief-update command, ask the user to persist it in the desktop app or a human-operated CLI flow.
- If the user says it was a test or accidental trigger, report that conclusion without mutating the source path from this skill.
- Sensitivity is binding, not advisory. A restricted meeting is not available to this agent skill by default. Do not bypass a failed native read; direct the user to a human-operated Minutes app/CLI flow with the explicit audited restricted-access controls.
Skip Phases 2 and 2b (there is no transcript and no speaker attribution); continue with prep matching and the closing ritual as normal.
Phase 2b: Check speaker attributions
If the meeting has a speaker_map: field in frontmatter, check the confidence levels:
- All High confidence: Speakers are confirmed — use real names throughout the debrief.
- Any Medium confidence: Note this — "Speakers were auto-identified (medium confidence). If the names look wrong, run:
minutes confirm --meeting <path>" - No speaker_map but has SPEAKER_X labels: The meeting has diarization but no attribution — suggest: "I see anonymous speaker labels. If you know who was in this meeting, run
minutes confirm --meeting <path>to tag them."
This nudge is brief (one line) — don't make it a blocker.
Phase 3: Check for matching prep
Look for a prep file that matches this meeting:
ls ~/.minutes/preps/ 2>/dev/null
Match logic:
- Find
.prep.mdfiles from today or yesterday (within 48 hours) - Read each file's
person:frontmatter field - Compare against the recording's
attendees:list — match on first name, but check learned aliases before deciding there is no match:
Treat all returned variants as equivalent during prep-file matching.node "$MINUTES_SKILLS_ROOT/_runtime/hooks/lib/minutes-learn-cli.mjs" aliases "<attendee-or-person>" 2>/dev/null - If multiple preps match → AskUserQuestion to pick which one
- If no prep matches → standalone debrief (skip to Phase 4b)
Phase 4a: Prep-connected debrief (when a matching prep exists)
Read the prep file. Pull out the goal: field. Ask via AskUserQuestion:
"You went into this meeting wanting to: [goal from prep]
Did you accomplish it?"
Options:
- A) Yes — fully resolved → Mark as complete. Summarize what was decided.
- B) Partially — some progress → Ask: "What's still open?" Capture the remaining items.
- C) No — it didn't come up or it changed → Ask: "What happened instead?" Capture the pivot.
- D) The goal changed during the meeting → Ask: "What's the new direction?"
Then produce the debrief summary with the prep comparison:
Before writing the output, check for a learned debrief presentation preference:
node "$MINUTES_SKILLS_ROOT/_runtime/hooks/lib/minutes-learn-cli.mjs" get-presentation-focus debrief
If the result is:
decisions-first→ put Decisions before Action Items and Relationship Updateactions-first→ put Action Items first, then Decisions, then Relationship Updaterelationship-first→ put Relationship Update first, then Decisions, then Action Items
If there is no preference, keep the default order below.
## Debrief: [Meeting Title]
### Prep vs Reality
- **Goal:** [from prep]
- **Outcome:** [resolved / partially / pivoted]
- **What changed:** [if anything]
### Decisions
- [list each decision]
### Action Items
- [list with assignee and due date]
### Relationship Update
- [any notable changes in tone, new topics, shifted priorities]
Phase 4b: Standalone debrief (no matching prep)
Produce a straightforward debrief:
Before deciding the section order, check:
node "$MINUTES_SKILLS_ROOT/_runtime/hooks/lib/minutes-learn-cli.mjs" get-presentation-focus debrief
Apply the same ordering rules if a preference exists; otherwise keep the default order below.
## Debrief: [Meeting Title]
### Key Decisions
- [list each decision]
### Action Items
- [list with assignee and due date]
### Notable Discussion Points
- [2-3 most significant things discussed]
Phase 5: Decision evolution check
Search for prior decisions on the same topics discussed in this meeting:
minutes search "<topic>" --limit 10 --since <30-days-ago>
For each topic that has a decision in this meeting AND a decision in a prior meeting:
- Compare the decisions
- If they differ → surface the evolution:
"Decision evolution — pricing:
- Mar 3 (with Case): $599
- Mar 10 (with Alex): annual billing
- Today: monthly billing
- Status: VOLATILE (3 changes in 14 days)
Is this settled now, or still in flux?"
Classification:
- STABLE — Same decision held across 2+ meetings
- VOLATILE — Decision changed 2+ times in 14 days
- CONFLICTING — Two different active decisions exist on the same topic
- NEW — First decision on this topic
Phase 6: Closing ritual
End with three beats:
-
Signal reflection — Quote something specific from the meeting or the debrief conversation. "You said '[quote]' — that sounds like the decision is locked."
-
Assignment — One concrete follow-up action. "Send Alex the pricing doc tonight while the conversation is fresh." "Update the roadmap doc with today's Q2 timeline change."
-
Next skill nudge — "At the end of the week, run
/minutes-weeklyto see how all your meetings connect and what still needs attention."
Gotchas
- Record explicit presentation preferences when the user states them. If the user says "show action items first", "lead with decisions", or "start with the relationship read", persist it:
node "$MINUTES_SKILLS_ROOT/_runtime/hooks/lib/minutes-learn-cli.mjs" set-presentation-focus debrief actions-first "User explicitly prefers action items first" node "$MINUTES_SKILLS_ROOT/_runtime/hooks/lib/minutes-learn-cli.mjs" set-presentation-focus debrief decisions-first "User explicitly prefers decisions first" node "$MINUTES_SKILLS_ROOT/_runtime/hooks/lib/minutes-learn-cli.mjs" set-presentation-focus debrief relationship-first "User explicitly prefers relationship updates first" - Don't hallucinate if there's no recording — If
minutes listreturns nothing, say so. Don't invent a debrief. - Stale preps (>48h) are ignored — If the prep file is more than 48 hours old, treat it as no-prep mode. The prep was for a different context.
- First-name matching for prep files — The prep file slug uses first name only (
sarah.prep.md). Match against attendee first names in the recording frontmatter. "Alex C." matches "sarah". - Teach Minutes aliases when the user corrects matching. If the user says "That prep was for Sarah Chen, not just Sarah" or clarifies that two names refer to the same person, persist it:
node "$MINUTES_SKILLS_ROOT/_runtime/hooks/lib/minutes-learn-cli.mjs" set-alias "Sarah Chen" "Sarah" "User corrected prep/debrief matching" - Multiple recordings today — Ask which one. Don't assume the most recent is the right one.
- Recordings without frontmatter — Some recordings only have raw transcripts (no summary, no decisions section). Work with what you have — extract decisions and action items from the transcript text yourself.
- Decision evolution can span weeks — Search the last 30 days for related decisions, not just this week.
- Don't be preachy about decision changes — Decisions change for good reasons. Surface the evolution factually. "Here's what shifted" not "You keep changing your mind."
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
