Meeting Recap
A meeting recap is a post-meeting topic-segmented summary produced for attendees and light distribution. It organizes content by topic rather than chronology, highlights decisions visually, and captures actions inline (with owner, due date, dependencies) per topic segment, plus a consolidated actions view at the end for scannability.
This skill absorbs what would otherwise be a separate "meeting-actions" skill. Actions in this family live alongside the context that makes them meaningful, not in a sibling artifact.
This skill belongs to the Meeting Skills Family. It conforms to the Meeting Skills Family Contract.
When to Use
- After any internal meeting that produces decisions or actions affecting attendees
- When a sibling
foundation-meeting-agenda exists and needs reconciliation (planned vs. actual topics)
- When the team needs a topic-organized reference rather than a chronological transcript dump
- When inputs include a transcript (Zoom, Meet, Otter, Fireflies, Krisp MCP) or mixed notes and transcript
When NOT to Use
- Setting the pre-meeting structure attendees will see (topics, owners, time boxes) before the meeting happens. Use
foundation-meeting-agenda. recap summarizes what happened after a meeting; agenda sets expectations before it.
- Preparing the user's private strategic positioning before a meeting that matters. Use
foundation-meeting-brief. recap is a shared post-meeting record; brief is pre-meeting tactical prep never shown to attendees.
- Communicating outcomes to non-attendees. Use
foundation-stakeholder-update. recap assumes reader context; stakeholder-update translates to readers without it.
- Cross-meeting synthesis (patterns across multiple meetings). Use
foundation-meeting-synthesize.
- Synthesizing user research interviews across participants, not one meeting's attendees. Use
discover-interview-synthesis. recap organizes a single meeting by topic; interview-synthesis finds patterns across many research conversations.
- Live meeting note-taking. This skill consumes finished inputs; it does not transcribe live.
Zero-friction execution
Per the family contract, this skill never blocks on interrogation. Default flow:
- Read all provided inputs (transcript, notes, or hybrid) and note input quality upfront
- Auto-discover related agenda via filename-prefix match on same-directory
*_{title}_agenda.md
- Run inference: meeting metadata from content, decisions from language markers, actions from imperative-future patterns, owners from attendee context
- Present a brief inference summary and accept one-word
go or corrections
- Produce the recap
If invoked with --go, skip the inference summary. If the user provides all metadata upfront, no checkpoint appears.
Fabrication prohibition
This skill never fabricates owners, decisions, or actions. When an action lacks an explicit owner, it is captured as [owner: unassigned, needs confirmation] not invented. When a decision is implicit ("it sounded like we decided X"), it is flagged with a confidence marker rather than stated as fact. Trust decay from fabrication is worse than the mild friction of flagging.
Ownership reconciliation threshold (v1.1.0)
When the ratio of unassigned actions to total actions exceeds 0.3 (30%), OR when any high-priority action lacks an owner, the skill surfaces a dedicated ## ⚠ Ownership reconciliation required section at the top of the recap (above the topic segments) listing:
- All unassigned actions
- A suggested next step for each (who should probably own this based on topic context, flagged as inference)
- A recommended follow-up action (Slack thread, 15-min sync, async survey)
The shareable summary also leads with this flag when triggered: ⚠ Ownership reconciliation required: N of M actions lack owners.
The unassigned_action_ratio frontmatter field (float 0.0-1.0) records the ratio for downstream tools.
Rationale: a recap with 60% ownerless actions is "non-fabricated" (per the prohibition above) but operationally broken. a pile of broken tickets. The threshold makes this visible instead of silently shipping.
Instructions
When asked to create a meeting recap, follow these steps:
Parse inputs and detect type
Transcript (timestamped speaker-attributed lines), notes (bullet or prose), or hybrid. Note input quality upfront. transcript plus structured notes is high; scrappy bullets is low.
Auto-discover related agenda
Look in the same directory for a file matching the pattern {YYYY-MM-DD}_{HH-MMtimezone}_{title-slug}_agenda.md. If found, load it. its topic list is the recap's topic skeleton and its desired_outcomes drive the meeting-quality reconciliation.
Present go-mode inference summary
Show detected meeting date, title, attendees (if inferred), input quality assessment. Accept go or corrections.
Topic-segment the content
- If agenda was loaded, use its topic list as scaffold (plus any emergent topics)
- If no agenda, identify topics from transcript discourse markers ("moving on to", "the other thing")
Per topic segment, extract
- Discussion summary: 2-3 sentences capturing what was discussed
- Decisions made: bold-flagged visually. Never fabricate. if uncertain, flag "appears to have decided X [confidence: medium]"
- Actions: owner + due date + dependencies. Flag missing owners as
[owner: unassigned] and missing dates as [due: not specified]. Never invent.
- Open questions: unresolved items with confidence marker on whether they are truly unresolved or simply not re-raised
Consolidate actions by owner
Regroup all actions under each owner. Enables single-owner scan ("what do I owe after this meeting?").
Reconcile agenda (if agenda loaded)
topics_planned: from agenda topic list
topics_hit: topics actually discussed
topics_skipped: planned but not discussed, with brief reason
topics_emerged: discussed but not on agenda
Assess meeting quality signals
outcomes_achieved: N/M ratio of agenda desired_outcomes met (when agenda present)
started_on_time / ended_on_time: from timestamps when available; skipped when not
key_attendees_present: flag if decision-makers were absent
Surface next steps
When we reconvene, what needs to happen on the critical path before that.
Render TEMPLATE.md and validate
- Every action's owner appears in
attendees or is explicitly unassigned
meeting_quality.outcomes_achieved matches N/M pattern when populated
agenda_reconciliation fields present even when empty lists
Project Memory Contract
Active only when .claude/pm-skills.local.md exists. With no file, ignore this section entirely
and behave exactly as described above.
- Reads:
active_initiative, so decisions are recorded against the initiative they belong to.
- Writes: each decision actually reached in the meeting to the
## Decisions section, dated and attributed, plus the recap itself as a decision artifact.
- Posture: propose the entry and wait for confirmation before writing, unless
memory_auto_append: true is set, in which case append and echo what was written.
- Write discipline: re-read the file immediately before writing, never from the copy that
produced the proposal. If it changed in between, merge your entry into the current state and
re-propose rather than overwriting; add only your own entry and leave every other field and
section byte-identical. Nothing enforces this at runtime and the file is gitignored, so a
careless whole-file write loses another session's work with no way to recover it.
The fabrication prohibition above governs this write without exception: record only decisions that were stated. An unrecorded decision is recoverable; an invented one in durable memory is not. This complements the family's filename-based chaining rather than replacing it: filenames still locate the sibling artifacts of one meeting, while project memory carries the durable product context across meetings.
Quality Checklist
See also
1---
2name: foundation-meeting-recap
3description: Produces a topic-segmented post-meeting summary for attendees with decisions highlighted and actions captured inline per topic (plus a consolidated action view at the end). Auto-populates topic skeleton from a sibling meeting-agenda when available and reconciles planned vs. actual topics. Accepts transcripts from Zoom, Meet, Otter, Fireflies, Krisp MCP, or manual notes; runs on variable-quality input without blocking. For synthesizing user research interviews across participants, use discover-interview-synthesis.
4license: Apache-2.0
5metadata:
6 classification: foundation
7 version: "1.2.0"
8 updated: 2026-07-05
9 category: meeting
10 frameworks: [meeting-skills-family]
11 author: product-on-purpose
12---
13
14<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->
15# Meeting Recap
16
17A meeting recap is a post-meeting topic-segmented summary produced for attendees and light distribution. It organizes content by topic rather than chronology, highlights decisions visually, and captures actions inline (with owner, due date, dependencies) per topic segment, plus a consolidated actions view at the end for scannability.
18
19This skill absorbs what would otherwise be a separate "meeting-actions" skill. Actions in this family live alongside the context that makes them meaningful, not in a sibling artifact.
20
21This skill belongs to the Meeting Skills Family. It conforms to the [Meeting Skills Family Contract](../../docs/reference/skill-families/meeting-skills-contract.md).
22
23## When to Use
24
25- After any internal meeting that produces decisions or actions affecting attendees
26- When a sibling `foundation-meeting-agenda` exists and needs reconciliation (planned vs. actual topics)
27- When the team needs a topic-organized reference rather than a chronological transcript dump
28- When inputs include a transcript (Zoom, Meet, Otter, Fireflies, Krisp MCP) or mixed notes and transcript
29
30## When NOT to Use
31
32- Setting the pre-meeting structure attendees will see (topics, owners, time boxes) before the meeting happens. Use `foundation-meeting-agenda`. recap summarizes what happened after a meeting; agenda sets expectations before it.
33- Preparing the user's private strategic positioning before a meeting that matters. Use `foundation-meeting-brief`. recap is a shared post-meeting record; brief is pre-meeting tactical prep never shown to attendees.
34- Communicating outcomes to non-attendees. Use `foundation-stakeholder-update`. recap assumes reader context; stakeholder-update translates to readers without it.
35- Cross-meeting synthesis (patterns across multiple meetings). Use `foundation-meeting-synthesize`.
36- Synthesizing user research interviews across participants, not one meeting's attendees. Use `discover-interview-synthesis`. recap organizes a single meeting by topic; interview-synthesis finds patterns across many research conversations.
37- Live meeting note-taking. This skill consumes finished inputs; it does not transcribe live.
38
39## Zero-friction execution
40
41Per the family contract, this skill never blocks on interrogation. Default flow:
42
431. Read all provided inputs (transcript, notes, or hybrid) and note input quality upfront
442. Auto-discover related agenda via filename-prefix match on same-directory `*_{title}_agenda.md`
453. Run inference: meeting metadata from content, decisions from language markers, actions from imperative-future patterns, owners from attendee context
464. Present a brief inference summary and accept one-word `go` or corrections
475. Produce the recap
48
49If invoked with `--go`, skip the inference summary. If the user provides all metadata upfront, no checkpoint appears.
50
51## Fabrication prohibition
52
53This skill never fabricates owners, decisions, or actions. When an action lacks an explicit owner, it is captured as `[owner: unassigned, needs confirmation]` not invented. When a decision is implicit ("it sounded like we decided X"), it is flagged with a confidence marker rather than stated as fact. Trust decay from fabrication is worse than the mild friction of flagging.
54
55## Ownership reconciliation threshold (v1.1.0)
56
57When the ratio of unassigned actions to total actions exceeds **0.3** (30%), OR when any high-priority action lacks an owner, the skill surfaces a dedicated `## ⚠ Ownership reconciliation required` section at the top of the recap (above the topic segments) listing:
58
59- All unassigned actions
60- A suggested next step for each (who should probably own this based on topic context, flagged as inference)
61- A recommended follow-up action (Slack thread, 15-min sync, async survey)
62
63The shareable summary also leads with this flag when triggered: `⚠ Ownership reconciliation required: N of M actions lack owners.`
64
65The `unassigned_action_ratio` frontmatter field (float 0.0-1.0) records the ratio for downstream tools.
66
67Rationale: a recap with 60% ownerless actions is "non-fabricated" (per the prohibition above) but operationally broken. a pile of broken tickets. The threshold makes this visible instead of silently shipping.
68
69## Instructions
70
71When asked to create a meeting recap, follow these steps:
72
731. **Parse inputs and detect type**
74 Transcript (timestamped speaker-attributed lines), notes (bullet or prose), or hybrid. Note input quality upfront. transcript plus structured notes is high; scrappy bullets is low.
75
762. **Auto-discover related agenda**
77 Look in the same directory for a file matching the pattern `{YYYY-MM-DD}_{HH-MMtimezone}_{title-slug}_agenda.md`. If found, load it. its topic list is the recap's topic skeleton and its `desired_outcomes` drive the meeting-quality reconciliation.
78
793. **Present go-mode inference summary**
80 Show detected meeting date, title, attendees (if inferred), input quality assessment. Accept `go` or corrections.
81
824. **Topic-segment the content**
83 - If agenda was loaded, use its topic list as scaffold (plus any emergent topics)
84 - If no agenda, identify topics from transcript discourse markers ("moving on to", "the other thing")
85
865. **Per topic segment, extract**
87 - **Discussion summary**: 2-3 sentences capturing what was discussed
88 - **Decisions made**: bold-flagged visually. Never fabricate. if uncertain, flag "appears to have decided X [confidence: medium]"
89 - **Actions**: owner + due date + dependencies. Flag missing owners as `[owner: unassigned]` and missing dates as `[due: not specified]`. Never invent.
90 - **Open questions**: unresolved items with confidence marker on whether they are truly unresolved or simply not re-raised
91
926. **Consolidate actions by owner**
93 Regroup all actions under each owner. Enables single-owner scan ("what do I owe after this meeting?").
94
957. **Reconcile agenda** (if agenda loaded)
96 - `topics_planned`: from agenda topic list
97 - `topics_hit`: topics actually discussed
98 - `topics_skipped`: planned but not discussed, with brief reason
99 - `topics_emerged`: discussed but not on agenda
100
1018. **Assess meeting quality signals**
102 - `outcomes_achieved`: N/M ratio of agenda `desired_outcomes` met (when agenda present)
103 - `started_on_time` / `ended_on_time`: from timestamps when available; skipped when not
104 - `key_attendees_present`: flag if decision-makers were absent
105
1069. **Surface next steps**
107 When we reconvene, what needs to happen on the critical path before that.
108
10910. **Render TEMPLATE.md and validate**
110 - Every action's owner appears in `attendees` or is explicitly `unassigned`
111 - `meeting_quality.outcomes_achieved` matches `N/M` pattern when populated
112 - `agenda_reconciliation` fields present even when empty lists
113
114## Project Memory Contract
115
116Active only when `.claude/pm-skills.local.md` exists. With no file, ignore this section entirely
117and behave exactly as described above.
118
119- **Reads:** `active_initiative`, so decisions are recorded against the initiative they belong to.
120- **Writes:** each decision actually reached in the meeting to the `## Decisions` section, dated and attributed, plus the recap itself as a `decision` artifact.
121- **Posture:** propose the entry and wait for confirmation before writing, unless
122 `memory_auto_append: true` is set, in which case append and echo what was written.
123- **Write discipline:** re-read the file immediately before writing, never from the copy that
124 produced the proposal. If it changed in between, merge your entry into the current state and
125 re-propose rather than overwriting; add only your own entry and leave every other field and
126 section byte-identical. Nothing enforces this at runtime and the file is gitignored, so a
127 careless whole-file write loses another session's work with no way to recover it.
128
129The fabrication prohibition above governs this write without exception: record only decisions that were stated. An unrecorded decision is recoverable; an invented one in durable memory is not. This complements the family's filename-based chaining rather than replacing it: filenames still locate the sibling artifacts of one meeting, while project memory carries the durable product context across meetings.
130## Quality Checklist
131
132- [ ] Input quality flagged honestly (high / medium / low)
133- [ ] Agenda auto-discovery attempted; result noted in Generation context
134- [ ] Every topic segment has Discussion / Decisions / Actions / Open questions subsections
135- [ ] Decisions are bold-flagged; never invented; confidence marked when inferred
136- [ ] Every action has owner (or explicit `unassigned`) + due date (or explicit `not specified`)
137- [ ] Consolidated actions view regrouped by owner
138- [ ] Agenda reconciliation populated when agenda was loaded
139- [ ] Meeting quality signals populated with data available; skipped fields flagged
140- [ ] Shareable summary 5-6 lines, lead with decisions and top actions
141- [ ] Sources and References Generation context notes transcript source and any missing owners/dates
142
143## See also
144
145- [Meeting Skills Family Contract](../../docs/reference/skill-families/meeting-skills-contract.md)
146- [`foundation-meeting-agenda`](../foundation-meeting-agenda/SKILL.md). upstream: provides topic skeleton and desired-outcomes
147- [`foundation-meeting-synthesize`](../foundation-meeting-synthesize/SKILL.md). downstream: consumes recaps for cross-meeting synthesis
148- [`foundation-stakeholder-update`](../foundation-stakeholder-update/SKILL.md). downstream: translates recap outcomes to non-attendees