summarize

Summarize Skill

Generate summaries of notes, issues, PR discussions, or documentation in multiple formats.

Quick Start

Use this skill when:

• User requests summary (/summarize)
• Long note/issue needs TLDR
• PR review summary needed

Example:

Content: [Long discussion about authentication redesign - 500 words]

Summary (brief):
"Redesign auth to use JWT tokens instead of sessions. Requires DB schema
changes and API updates. Estimated 2 weeks. Security audit needed."

Summary (bullet):
- Replace session cookies with JWT tokens
- Update DB schema for refresh tokens
- Modify login/logout API endpoints
- Conduct security review before deployment
- Estimated: 2 weeks (1 backend + 1 testing)

Workflow

1. Analyze Content

   • Identify content type (note, issue, PR, docs)
   • Extract key points and decisions
   • Detect action items and owners
   • Find technical details and requirements

2. Choose Summary Format

   • Bullet: Quick scan, action-oriented
   • Brief: Single paragraph TLDR
   • Detailed: Multi-paragraph with sections
   • Executive: Business-focused, non-technical

3. Generate Summary

   • Preserve critical information (dates, numbers, names)
   • Maintain technical accuracy
   • Highlight decisions and action items
   • Include confidence tag if summarizing recommendations

4. Validate Completeness

   • No information loss of critical facts
   • Preserves author intent
   • Maintains chronological order if relevant

Output Format

{
  "format": "bullet",
  "summary": "- Point 1\n- Point 2\n- Point 3",
  "confidence": "RECOMMENDED",
  "word_count": {
    "original": 500,
    "summary": 45,
    "compression_ratio": 0.09
  },
  "key_points": [
    {"type": "decision", "text": "Use JWT tokens"},
    {"type": "action", "text": "Security audit needed", "owner": "security-team"},
    {"type": "estimate", "text": "2 weeks development"}
  ],
  "missing_info": [
    "Timeline for security audit not specified",
    "Rollback strategy not discussed"
  ]
}