Conversation Recap

Summarize the session and improve skills based on feedback from the session.

When to Use

Auto-invoke this skill when:

• •A plan has been executed to completion (all planned steps done)
• •All todos in the todo list are marked complete
• •A significant implementation, analysis, or research task is finished

Skip if the conversation was just Q&A, quick fixes, or no lasting learnings.

Process

Step 0: Handle Compacted Conversations

If the conversation has been compacted (you see a summary at the start mentioning "continued from a previous conversation"), fetch the full conversation logs.

Log location: ~/.claude/projects/ (find the directory matching this workspace path)

# List project directories to find the right one
ls -d ~/.claude/projects/*/

# List recent conversation logs by size (larger = more content)
ls -laS ~/.claude/projects/<project-dir>/*.jsonl | head -10

# Extract user prompts from a conversation log
cat ~/.claude/projects/<project-dir>/<conversation-id>.jsonl | jq -c 'select(.type == "user") | .message.content[0].text' 2>/dev/null | grep -v "^null$" | head -30

Log entry types: user (prompts), assistant (responses), summary (compaction), progress (tools), system

Step 1: Analyze the Conversation

Review the conversation (and logs if compacted) to identify:

1. •Initial prompt: The user's original request
2. •Plan: The approved approach/plan
3. •Execution: What was done, step by step
4. •Result: Final outcome, deliverables, findings
5. •Errors/failures: Problems encountered and how they were solved
6. •Usage patterns: New skill usage patterns discovered
7. •Company context: New insights about the business

Step 2: Create Session Summary

Save to: workflows/yyyy-mm-dd-hh-mm-ss-workflow-title.md

Use the template from references/templates.md.

Filename guidelines:

• •Format: yyyy-mm-dd-hh-mm-ss-descriptive-title.md
• •Use lowercase with hyphens
• •Be descriptive but concise
• •Examples: 2026-01-25-14-30-00-email-revenue-analysis.md

Step 3: Improve Skills

Review the session for learnings that should be integrated into skills:

Department files: overview, team, goals, products, marketing, finance, operations, customer-service

Important: Ensure all skill revisions comply with skill-creator guidelines:

• •SKILL.md must stay under 500 lines
• •Split content into reference files when approaching this limit
• •Reference files from SKILL.md with clear descriptions of when to read them

Step 4: Summarize Changes

After documenting and updating, provide the user with:

1. •Path to the session summary file
2. •List of skill files that were updated
3. •Brief summary of what was captured

Guidelines

What to Include in Session Summary

• •Title with date: Descriptive title with date underneath
• •Initial prompt: Exact user request (quoted)
• •Plan: The approved approach
• •Execution summary: Step-by-step what was done
• •Result: Findings, deliverables, conclusions
• •Appendix: List of all skill revisions made

What to Add to Skills

For errors/failures:

• •Add solution to SKILL.md troubleshooting section, or
• •Fix the script directly in scripts/

For usage patterns:

• •Add to references/workflow-examples.md with example prompts and steps

For company context:

• •Add to the relevant department file in .claude/skills/company/references/

Don't

• •Create documentation for trivial conversations
• •Duplicate information across multiple files
• •Add verbose explanations - keep it concise
• •Exceed 500 lines in any SKILL.md file
• •Create files in .claude/plans/ (plans are temporary)