Pm-skills foundation-meeting-recap
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->
git clone https://github.com/product-on-purpose/pm-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/product-on-purpose/pm-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/foundation-meeting-recap" ~/.claude/skills/product-on-purpose-pm-skills-foundation-meeting-recap && rm -rf "$T"
skills/foundation-meeting-recap/SKILL.mdname: foundation-meeting-recap description: 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. classification: foundation version: "1.0.0" updated: 2026-04-17 license: Apache-2.0 metadata: category: meeting frameworks: [meeting-skills-family] author: product-on-purpose
<!-- PM-Skills | https://github.com/product-on-purpose/pm-skills | Apache 2.0 -->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
exists and needs reconciliation (planned vs. actual topics)/meeting-agenda - 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
- Communicating outcomes to non-attendees. Use
— recap assumes reader context; stakeholder-update translates to readers without it./stakeholder-update - Cross-meeting synthesis (patterns across multiple meetings). Use
./meeting-synthesize - 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
or correctionsgo - 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
. If found, load it — its topic list is the recap's topic skeleton and its{YYYY-MM-DD}_{HH-MMtimezone}_{title-slug}_agenda.md
drive the meeting-quality reconciliation.desired_outcomes -
Present go-mode inference summary Show detected meeting date, title, attendees (if inferred), input quality assessment. Accept
or corrections.go -
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
and missing dates as[owner: unassigned]
. Never invent.[due: not specified] - 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)
: from agenda topic listtopics_planned
: topics actually discussedtopics_hit
: planned but not discussed, with brief reasontopics_skipped
: discussed but not on agendatopics_emerged
-
Assess meeting quality signals
: N/M ratio of agendaoutcomes_achieved
met (when agenda present)desired_outcomes
/started_on_time
: from timestamps when available; skipped when notended_on_time
: flag if decision-makers were absentkey_attendees_present
-
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
or is explicitlyattendeesunassigned
matchesmeeting_quality.outcomes_achieved
pattern when populatedN/M
fields present even when empty listsagenda_reconciliation
- Every action's owner appears in
Quality checklist
- Input quality flagged honestly (high / medium / low)
- Agenda auto-discovery attempted; result noted in Generation context
- Every topic segment has Discussion / Decisions / Actions / Open questions subsections
- Decisions are bold-flagged; never invented; confidence marked when inferred
- Every action has owner (or explicit
) + due date (or explicitunassigned
)not specified - Consolidated actions view regrouped by owner
- Agenda reconciliation populated when agenda was loaded
- Meeting quality signals populated with data available; skipped fields flagged
- Shareable summary 5-6 lines, lead with decisions and top actions
- Sources and References Generation context notes transcript source and any missing owners/dates
See also
- Meeting Skills Family Contract
— upstream: provides topic skeleton and desired-outcomes/meeting-agenda
— downstream: consumes recaps for cross-meeting synthesis/meeting-synthesize
— downstream: translates recap outcomes to non-attendees/stakeholder-update