borghei/Claude-Skills / project-management/execution/summarize-meeting
summarize-meeting
VerifiedTurns 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.0 KB |
| assets/meeting_summary_template.md | markdown | 2.0 KB |
| assets/sample_meetings.json | config | 2.2 KB |
| examples/product-review-may-22.md | markdown | 8.3 KB |
| references/meeting-facilitation-guide.md | markdown | 6.0 KB |
| references/red-flags.md | markdown | 10.0 KB |
| references/summarization-process.md | markdown | 7.1 KB |
| scripts/action_item_tracker.py | script | 8.1 KB |
| scripts/decision_log_builder.py | script | 6.9 KB |
| scripts/meeting_effectiveness_scorer.py | script | 9.1 KB |
scripts/decision_log_builder.py
View on GitHub#!/usr/bin/env python3
"""Decision Log Builder - Build and query a decision log from meeting data.
Aggregates decisions across meetings and provides search, timeline,
and decision audit capabilities.
Usage:
python decision_log_builder.py --meetings meetings.json
python decision_log_builder.py --meetings meetings.json --search "launch"
python decision_log_builder.py --meetings meetings.json --json
python decision_log_builder.py --example
"""
import argparse
import json
import re
import sys
from datetime import datetime
def load_data(path: str) -> dict:
try:
with open(path, "r") as f:
data = json.load(f)
except (OSError, json.JSONDecodeError) as e:
fail(f"cannot read {path}: {e}")
if not isinstance(data, dict):
fail(f"{path}: top level must be a JSON object (see --example)")
return data
def fail(msg: str) -> None:
"""Bad input: one line on stderr, exit 2."""
print(f"Error: {msg}", file=sys.stderr)
sys.exit(2)
def build_log(data: dict, search: str = None) -> dict:
meetings = data.get("meetings", [])
decisions = []
for meeting in meetings:
date = meeting.get("date", "Unknown")
topic = meeting.get("topic", "Unknown")
participants = meeting.get("participants", [])
for dec in meeting.get("decisions", []):
decision = {
"id": f"DEC-{date.replace('-', '')}-{len(decisions)+1:03d}",
"date": date,
"meeting_topic": topic,
"decision": dec.get("decision", ""),
"rationale": dec.get("rationale", ""),
"decided_by": dec.get("decided_by", "Unknown"),
"participants": participants,
"category": dec.get("category", "General"),
"impact": dec.get("impact", "Medium"),
"reversible": dec.get("reversible", True),
}
decisions.append(decision)
# Sort by date (most recent first)
decisions.sort(key=lambda x: x["date"], reverse=True)
# Apply search filter
if search:
pattern = re.compile(search, re.IGNORECASE)
decisions = [d for d in decisions if pattern.search(d["decision"]) or pattern.search(d.get("rationale", ""))]
# Category distribution
categories = {}
for d in decisions:
cat = d["category"]
categories[cat] = categories.get(cat, 0) + 1
# Impact distribution
impact_counts = {"High": 0, "Medium": 0, "Low": 0}
for d in decisions:
impact_counts[d["impact"]] = impact_counts.get(d["impact"], 0) + 1
# Quality checks
missing_rationale = [d for d in decisions if not d.get("rationale")]
high_impact_reversible = [d for d in decisions if d["impact"] == "High" and d.get("reversible", True)]
recs = []
if missing_rationale:
recs.append(f"{len(missing_rationale)} decision(s) without documented rationale. Future teams need to understand 'why'.")
if high_impact_reversible:
recs.append(f"{len(high_impact_reversible)} high-impact decision(s) marked as reversible. Verify this is correct and document rollback plans.")
return {
"total_decisions": len(decisions),
"search_query": search,
"categories": categories,
"impact_distribution": impact_counts,
"decisions": decisions,
"quality": {
"missing_rationale": len(missing_rationale),
"decisions_with_rationale_pct": round((len(decisions) - len(missing_rationale)) / len(decisions) * 100, 1) if decisions else 0,
},
"recommendations": recs,
}
def print_report(result: dict) -> None:
print(f"\nDecision Log")
if result["search_query"]:
print(f"Search: '{result['search_query']}'")
print(f"Total Decisions: {result['total_decisions']}")
print("=" * 65)
imp = result["impact_distribution"]
print(f"Impact: High={imp.get('High',0)} | Medium={imp.get('Medium',0)} | Low={imp.get('Low',0)}")
print(f"Rationale Coverage: {result['quality']['decisions_with_rationale_pct']:.0f}%")
print(f"\nDecisions:")
for d in result["decisions"]:
rev = " [reversible]" if d.get("reversible") else " [irreversible]"
print(f"\n {d['id']} ({d['date']})")
print(f" Decision: {d['decision']}")
if d["rationale"]:
print(f" Rationale: {d['rationale'][:80]}")
print(f" Decided by: {d['decided_by']} | Impact: {d['impact']}{rev}")
if result["recommendations"]:
print(f"\nRecommendations:")
for i, r in enumerate(result["recommendations"], 1):
print(f" {i}. {r}")
print()
def print_example() -> None:
example = {
"meetings": [
{
"date": "2026-03-14",
"topic": "Architecture Review",
"participants": ["Alice", "Bob", "Carol"],
"decisions": [
{"decision": "Use PostgreSQL for analytics service", "rationale": "80% relational queries based on pattern analysis", "decided_by": "Engineering leads", "category": "Technical", "impact": "High", "reversible": False},
{"decision": "Adopt trunk-based development", "rationale": "Reduce merge conflicts and improve CI speed", "decided_by": "Alice", "category": "Process", "impact": "Medium", "reversible": True},
],
},
{
"date": "2026-03-07",
"topic": "Sprint Planning",
"participants": ["Alice", "Dave"],
"decisions": [
{"decision": "Launch date set for April 15", "rationale": "Allows 2 full sprints for QA after feature freeze", "decided_by": "Steering committee", "category": "Schedule", "impact": "High", "reversible": True},
],
},
],
}
print(json.dumps(example, indent=2))
def main():
parser = argparse.ArgumentParser(description="Build and query a decision log.")
parser.add_argument("--meetings", type=str, help="Path to meetings JSON file")
parser.add_argument("--search", type=str, help="Search decisions by keyword")
parser.add_argument("--json", action="store_true", help="Output as JSON")
parser.add_argument("--format", choices=["text", "json"], default="text", help="Output format (--json is the same as --format json)")
parser.add_argument("--example", action="store_true", help="Print example and exit")
args = parser.parse_args()
if args.example:
print_example()
return
if not args.meetings:
parser.error("--meetings is required")
data = load_data(args.meetings)
try:
result = build_log(data, args.search)
except (AttributeError, TypeError, KeyError, ValueError) as e:
fail(f"unexpected input shape ({type(e).__name__}: {e}); run --example for the format")
if args.json or args.format == "json":
print(json.dumps(result, indent=2))
else:
print_report(result)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |