Skip to content

borghei/Claude-Skills / project-management/execution/summarize-meeting

summarize-meeting

Verified

Turns meeting notes or transcripts into a summary of decisions, owned and dated action items, and open questions. Use when writing up a meeting, a recap email or a decision log; for patterns across a series use meeting-analyzer.

Meeting Summary Expert

Overview

Transform meeting notes, transcripts, or recordings into clear, actionable summaries. Every summary follows a consistent structure that makes it easy for attendees and non-attendees alike to understand what was discussed, what was decided, and who is doing what by when.

Done looks like: every decision is numbered with who made it and why; every action item has one owner, a concrete deliverable and a calendar date; open questions have an owner; nothing is invented that the notes do not support (mark gaps as [owner?] or [date?] and ask).

When to Use

  • After any meeting where decisions were made or actions were assigned.
  • Sprint ceremonies -- planning, retro, backlog refinement, sprint review.
  • Stakeholder meetings -- steering committees, executive reviews, client calls.
  • Ad-hoc discussions -- when an impromptu conversation produces commitments that need tracking.

For accountability across a recurring series (who keeps missing commitments, which meetings never decide anything), use ../../meeting-analyzer/ instead.

Clarify First

Before summarizing, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

  • The source material and its fidelity: raw notes, transcript, or recording (summary quality is bounded by input; missing owners/dates for action items cannot be invented).
  • Meeting type: planning, retro, steering committee, or client call (tailors discussion synthesis and which decisions matter).
  • Distribution scope + confidentiality: attendees, non-attendees, or execs, and any sensitivity limits (determines whether standard 24-hour distribution applies).

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

Tools

Once summaries are captured as JSON (one object per meeting under meetings), three tools check them. All read --meetings FILE, print text or --format json (--json is the same), and --example prints a valid input.

ToolChecks
action_item_tracker.pyCompletion rate, overdue items, owners with the most open work, items with no owner or date. --as-of YYYY-MM-DD sets the date for overdue checks; it defaults to the latest meeting date so old notes give a stable result.
decision_log_builder.pyNumbered decision log (DEC-YYYYMMDD-NNN), rationale coverage, high-impact decisions marked reversible. --search TEXT filters by keyword.
meeting_effectiveness_scorer.py0-100 per meeting from decisions, owned/dated actions, time per output, agenda coverage and attendee count.
python3 project-management/execution/summarize-meeting/scripts/action_item_tracker.py \
  --meetings project-management/execution/summarize-meeting/assets/sample_meetings.json
python3 project-management/execution/summarize-meeting/scripts/decision_log_builder.py \
  --meetings project-management/execution/summarize-meeting/assets/sample_meetings.json --search postgres
python3 project-management/execution/summarize-meeting/scripts/meeting_effectiveness_scorer.py \
  --meetings project-management/execution/summarize-meeting/assets/sample_meetings.json --format json

On the sample: 5 actions, 2 done, 1 overdue (Carol, 4 days as of 2026-03-14), 1 with no owner or date; 3 decisions with 67% rationale coverage; the status sync with eight people, no agenda and no decision scores lowest.

Exit codes: 0 report produced · 2 missing or unreadable file, invalid JSON, or the wrong shape (top level not an object, meetings not a list). The tools report findings; they do not gate.

Anti-Patterns

Posting an AI summary without review

Mistake: A transcription tool's auto-summary is posted as the official summary, with nobody checking it. Why it happens: The output looks finished, and the 24-hour distribution window pushes people to send it as is. Instead: Treat any machine-generated summary as a draft. Someone who attended checks names, who decided what, and whether each action item was actually agreed, then adds a "reviewed by" line. No "reviewed by" line means it is still a draft.

Sensitive details sent to a wide list

Mistake: A summary that goes beyond the attendees includes personnel feedback, a customer's commercial terms, or in-flight legal language. Why it happens: The summarizer captures everything said in the room, and the distribution list is set by habit. Instead: If anyone outside the meeting is on the distribution list, run a redaction pass before sending. Confirm confidentiality limits up front (see Clarify First). Once the email is sent, you cannot recall it.

Pasting the transcript as the summary

Mistake: The "summary" is four pages of who said what. Why it happens: Copying the transcript feels safe because nothing is left out. Instead: Compress it into the template's sections: discussion points, numbered decisions, action items and open questions. If the summary runs past a page of named-speaker dialogue, cut it down.

Seven more, each with a bad and a good example: references/red-flags.md.

Reference Documentation

Load the reference that matches the task — keep this file lean and pull detail on demand:

  • references/summarization-process.md — the full six-step methodology (metadata → discussion → actions → decisions → open questions → distribute), the output template, focus priorities, troubleshooting table, and success criteria. Read when producing a summary.
  • references/meeting-facilitation-guide.md — meeting types, note-taking strategies, and anti-patterns. Read to tailor the summary to the meeting type or improve input quality.
  • references/red-flags.md — common ways summaries go wrong with bad/good examples. Read before posting, emailing, or linking a summary.
  • assets/meeting_summary_template.md — ready-to-use fill-in template. Use to draft the summary directly.

Scope & Limitations

In Scope: Capturing meeting metadata, extracting key discussion points, documenting decisions with rationale, recording action items with owners and due dates, capturing open questions, distributing summaries, maintaining consistent naming conventions and storage.

Out of Scope: Meeting facilitation and agenda design, real-time transcription (use a transcription tool as input), project status tracking (hand off to ../jira-expert/), strategic decision frameworks (hand off to ../senior-pm/), recording or video management.

Limitations: Summary quality is bounded by the quality of input notes or transcript. Automated transcription tools may introduce errors that the summarizer must catch. The skill does not replace the need for a skilled facilitator -- poorly run meetings produce poor summaries regardless of template quality. Sensitive or confidential meetings may require restricted distribution that the standard workflow does not address.

Integration Points

IntegrationDirectionWhat Flows
wwas/Meetings -> WWASDecisions and commitments from meetings become WWAS backlog items
job-stories/Meetings -> StoriesDiscovery discussions surface situations and motivations for job stories
../jira-expert/Meetings -> JiraAction items create Jira tickets; decisions update issue comments
../confluence-expert/Meetings -> ConfluenceSummaries stored in Confluence using meeting notes template
../senior-pm/Meetings -> PMSteering committee and stakeholder meeting summaries feed portfolio reporting
../delivery-manager/Meetings -> DMRelease planning and incident review meeting outcomes feed delivery tracking

Files

FilePurpose
scripts/action_item_tracker.pyAction completion, overdue and ownership report
scripts/decision_log_builder.pyDecision log with rationale coverage
scripts/meeting_effectiveness_scorer.pyPer-meeting effectiveness score
assets/sample_meetings.jsonThree meetings that exercise all three tools
assets/meeting_summary_template.mdFill-in summary template
examples/product-review-may-22.mdWorked summary
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall