Retrospective

/retrospective - Create a Skill from This Session

Convert this session's learnings into a reusable skill for future reference.

Your Task

Analyze our conversation and create a new skill document capturing what we learned.

Step 1: Analyze the Session

Review our conversation and identify:

1. What problem we solved - The core challenge
2. What approach worked - The successful solution
3. What failed - Attempts that didn't work (CRITICAL - this is the most valuable part)
4. Key configurations - Specific parameters, versions, commands that mattered
5. Environment details - Dependencies, setup requirements

Step 2: Propose Skill Metadata

Before creating the file, propose:

• name: kebab-case, descriptive (e.g., tmux-enter-key-handling, pytorch-mixed-precision)
• description: When to use this skill (max 500 chars, single line)
• location: ~/.codex/skills/<name>/SKILL.md

Ask me to confirm or adjust before proceeding.

Step 3: Create the SKILL.md

Use this template:

---
name: <skill-name>
description: <when to use this, max 500 chars>
---

# <Title>

## What This Solves

<1-2 sentences describing the problem>

## Working Approach

<Step-by-step solution that worked>

### Key Code/Commands

```<language>
<actual code or commands that worked>

Failed Attempts

Read this first - These approaches don't work:

Environment & Dependencies

• OS: ...
• Versions: ...
• Key packages: ...

Hyperparameters / Configuration

Next Steps / Future Work

• ...

Session Reference

• Date: <today's date>
• Agent:
• Original task:

## Step 4: Save and Confirm

1. Create the skill directory: `mkdir -p ~/.codex/skills/<name>/`
2. Write the SKILL.md file
3. Confirm creation with the full path

## Important Notes

- **Failed Attempts are GOLD** - Document every dead end. "I tried X and it broke because Y" is the most useful thing in a skill.
- **Be specific** - Include exact versions, commands, error messages
- **Future you is the audience** - Write for someone who has no context about this session