Aiwg summarize-transcript
Analyze and summarize a transcript, meeting notes, or discussion thread into a clear actionable document
install
source · Clone the upstream repo
git clone https://github.com/jmagly/aiwg
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/agentic/code/addons/aiwg-utils/skills/summarize-transcript" ~/.claude/skills/jmagly-aiwg-summarize-transcript-fe2f3c && rm -rf "$T"
manifest:
agentic/code/addons/aiwg-utils/skills/summarize-transcript/SKILL.mdsource content
Summarize Transcript or Meeting
Analyze and summarize a transcript, meeting notes, or discussion thread into a clear, actionable document.
Usage
/summarize-transcript <path-to-transcript-or-paste-content> [--style <style-preset>] [--emphasize "<guidance>"] [--avoid "<guidance>"]
Parameters
: Path to transcript file OR paste content directly<content>
: Optional style preset (default:--style <preset>
)balanced
: Dense technical detail, architecture-focusedtechnical
: High-level strategic, business-focusedexecutive
: Task-oriented, next-steps focusedaction-items
: Code-centric, implementation detailsdeveloper
: Mix of strategic and technicalbalanced
: Positive guidance - what to highlight, tone to adopt--emphasize "<text>"
: Negative guidance - what to de-emphasize or exclude--avoid "<text>"
Examples
Basic Usage
/summarize-transcript meeting-notes.txt
With Style Preset
/summarize-transcript standup-transcript.md --style action-items
With Positive Guidance
/summarize-transcript design-review.txt --emphasize "Focus on security decisions and data privacy concerns"
With Negative Guidance
/summarize-transcript brainstorm-session.txt --avoid "Skip bikeshedding about naming, focus on architectural decisions"
Combined Guidance
/summarize-transcript architecture-meeting.md \ --style technical \ --emphasize "Highlight consensus mechanisms and performance trade-offs" \ --avoid "Skip discussion of tooling choices, minimize meeting logistics"
Output Structure
The command produces a structured summary following this template:
1. TL;DR Section
- Format: Emoji-prefixed bullet points (3-8 items)
- Content: Core decisions, key outcomes, critical info
- Tone: Scannable, action-oriented, high signal-to-noise
2. Detailed Breakdown
- Format: Topic-organized subsections with emoji headers
- Content: Organized by theme/domain/workstream
- Structure: Each subsection contains:
- Context/background bullets
- Decisions made
- Action items or next steps
- Open questions or risks
3. Optional Sections (if applicable)
- Action Items: Explicitly called-out tasks with owners
- Decisions: Formalized decision log
- Open Questions: Unresolved items requiring follow-up
- Next Steps: Immediate priorities
Style Preset Details
Technical Style
emphasis: - Architecture patterns and system design - Performance characteristics and trade-offs - Implementation details and constraints - Security and reliability considerations tone: - Dense technical vocabulary - Precise terminology - Include metrics and measurements avoid: - Business justifications - High-level platitudes - Process discussions
Executive Style
emphasis: - Strategic outcomes and business impact - Resource allocation and timeline - Risk assessment and mitigation - Cross-functional dependencies tone: - Business-focused language - ROI and value propositions - Clear decision rationale avoid: - Implementation minutiae - Technical jargon without context - Low-level code discussion
Action Items Style
emphasis: - Who does what by when - Blockers and dependencies - Immediate next steps - Accountability assignments tone: - Imperative verbs - Clear ownership - Explicit timelines avoid: - Background discussion - Exploratory tangents - Historical context
Developer Style
emphasis: - Code changes and implementation approach - API contracts and interfaces - Testing strategy and coverage - Debugging and troubleshooting tone: - Code-centric language - Concrete examples - Tool and framework references avoid: - Business strategy - Abstract architecture theory - Meeting meta-discussion
Balanced Style (Default)
emphasis: - Mix of strategic and tactical - Context + decisions + actions - Key takeaways for all audiences - Both "why" and "how" tone: - Accessible to multiple roles - Balance detail and clarity - Preserve important nuance avoid: - Extremes in either direction - Redundant information - Tangential discussions
Guidance Best Practices
Effective Positive Guidance (--emphasize)
- "Highlight security concerns and compliance requirements"
- "Focus on performance optimization decisions and benchmarks"
- "Emphasize user experience trade-offs and design rationale"
- "Call out technical debt and refactoring priorities"
- "Preserve specific metrics, timelines, and commitments"
Effective Negative Guidance (--avoid)
- "Skip meeting logistics and scheduling discussion"
- "Minimize tool bikeshedding, focus on architecture"
- "De-emphasize exploratory tangents without conclusions"
- "Exclude off-topic discussions about [specific topic]"
- "Omit historical context, focus on forward decisions"
Processing Instructions
When executing this command, follow these steps:
1. Content Analysis
- Read the full transcript/meeting notes
- Identify key themes, decisions, and discussion threads
- Extract action items, owners, and timelines
- Flag open questions and unresolved issues
2. Apply Style & Guidance
- Use the specified
preset as baseline--style - Integrate
guidance to prioritize content--emphasize - Apply
guidance to filter or de-emphasize--avoid - Resolve conflicts by prioritizing explicit guidance over presets
3. Structure Generation
- Create TL;DR section (3-8 bullet points)
- Organize detailed breakdown by logical themes
- Use emoji prefixes for visual scanning:
- ⏱️ Time/schedule/deadline
- 🧮 Technical/architecture/design
- 🛡️ Security/reliability/safety
- 🔁 Process/workflow/ops
- 🧵 Structure/organization
- 🧠 Strategy/planning/vision
- 🧪 Experiments/testing/validation
- 🔹 Status/updates/progress
- 📊 Metrics/data/measurement
- 🚀 Launch/deployment/release
- 🔧 Tooling/infrastructure
- 👥 Team/people/roles
- 💡 Ideas/proposals/options
- ⚠️ Risks/blockers/concerns
- ✅ Decisions/commitments
4. Quality Checks
- Ensure TL;DR is genuinely scannable (no walls of text)
- Verify all action items have owners (if mentioned)
- Check that technical terms are consistent
- Remove redundant information
- Preserve critical nuance and context
5. Output Formatting
- Use markdown with proper heading hierarchy
- Apply consistent bullet structure
- Include horizontal rules (⸻) between major sections
- Use bold for emphasis on key terms
- Use
for technical referencescode blocks
Example Output
Based on the provided dev update posting, here's the structure to emulate:
📢 [Meeting Title] — [Date] TL;DR • [Emoji] [Key decision/outcome 1] • [Emoji] [Key decision/outcome 2] • [Emoji] [Key decision/outcome 3] • [Emoji] [Next steps/actions] ⸻ [Primary Section Label] 🔹 [Topic Area 1] • [Context/background] • [Decision made] • [Implementation approach] • [Open questions or next steps] 🔹 [Topic Area 2] • [Context/background] • [Decision made] • [Technical details] • [Action items] 🔹 [Topic Area 3] • [Context/background] • [Strategic direction] • [Resource implications] • [Timeline or milestones] ⸻ [Optional: Action Items] • [@owner] Task description by [date] • [@owner] Task description by [date] [Optional: Open Questions] • Question requiring follow-up? • Decision pending [person/team]? [Optional: Next Meeting] • Date/time • Agenda items
Notes
-
The command is flexible and adapts to various content types:
- Technical design reviews
- Sprint planning meetings
- Architecture discussions
- Strategy sessions
- Incident post-mortems
- Retrospectives
- Community updates
-
Emoji usage is optional but recommended for:
- Visual scanning and quick navigation
- Topic categorization
- Signaling importance or urgency
- Matching tone (formal vs informal)
-
Length guidance:
- TL;DR: 3-8 bullets, 1-2 sentences each
- Topic sections: 3-6 bullets per topic
- Total output: Aim for 40-60% of original length
- Preserve critical details, cut fluff
-
Context preservation:
- Keep enough context for future readers
- Link decisions to rationale
- Preserve dissenting views if significant
- Note when decisions are tentative vs final
Template Version: 1.0 Based On: Roko Dev Community Update (Oct 7 & 9, 2025) Maintained By: AIWG Team
References
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/README.md — aiwg-utils addon overview
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/instruction-comprehension.md — Honor --style, --emphasize, and --avoid parameters correctly
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/vague-discretion.md — Concrete output length and coverage targets
- @$AIWG_ROOT/docs/cli-reference.md — CLI reference for AIWG output formatting conventions