wrapup-skillup

Session Wrapup & Skillup

Generate a session report for topic: $ARGUMENTS

Your Task

Analyze this conversation session and create a comprehensive report that captures learnings, documents pitfalls, and recommends extensions that could help in future similar sessions.

Instructions

1. Analyze the session context - Review the entire conversation from start to finish
2. Extract the original request - Identify the first user message that started this session
3. Summarize tool usage - Document which tools were used, how, and why
4. Identify key learnings - What discoveries, patterns, or insights emerged?
5. Document pitfalls - What problems were encountered? How were they resolved?
6. Note outcomes - What was accomplished?
7. Find ticket references - Look for any Linear, GitHub, or other ticket IDs mentioned
8. Recommend extensions - Based on the session, suggest which extension types would be most valuable

Output Format

Write the report to: .claude/session-reports/YYYY-MM-DD-HH-MM-{topic}.md

Where {topic} is the topic-slug argument (use "session" if not provided).

Use this template structure:

# Session Report: {Topic Title}

## Metadata
- **Date**: YYYY-MM-DD HH:MM
- **Duration**: ~X minutes (estimate based on conversation length)
- **Related Tickets**: [ticket-ids or "None"]

## Original Request

> [Quote the first user message that initiated this session]

## Tools Used

| Tool | Purpose | Key Usage |
|------|---------|-----------|
| Tool1 | Why it was used | How it was applied |
| Tool2 | Why it was used | How it was applied |

## Key Learnings

- **Learning 1**: Description of what was discovered
- **Learning 2**: Description of pattern identified
- **Learning 3**: Description of insight gained

## Pitfalls & Solutions

### Pitfall: [Issue Name]
- **Problem**: What went wrong or was difficult
- **Solution**: How it was resolved
- **Prevention**: How to avoid this in the future

### Pitfall: [Another Issue]
- **Problem**: Description
- **Solution**: Resolution
- **Prevention**: Future avoidance strategy

## Results & Outcomes

- **Outcome 1**: What was accomplished
- **Outcome 2**: What was delivered
- **Files Changed**: List key files created or modified

## Extension Recommendations

Based on this session, the following extensions would help in similar future work:

### Recommended: [Skill/Command/Hook/Agent]

**Name**: `suggested-name`

**Purpose**: Why this extension would be valuable

**Type Justification**: Why this type (skill vs command vs hook vs agent) is appropriate

**Template**:
```yaml
---
name: suggested-name
description: Description for discovery
---