| name | retro-create |
| description | Post-invocation retrospective. Tracks skill issues and applies fixes automatically. |
Purpose
After any skill completes, review the session for issues and improve the skill to prevent recurrence.
Trigger
Run automatically after every skill invocation completes (success or failure).
What to look for
- Failed commands — commands that errored and required retrying or workarounds
- User corrections — the user stepped in to redirect, correct, or override
- Wrong assumptions — the skill assumed something that was not true (versions, paths, flags)
- Missing steps — manual steps the user had to perform that the skill should have handled
- Outdated instructions — references to APIs, flags, or behaviors that have changed
Protocol
For each issue found:
- Log — append an entry to
<skill-dir>/retro.md (create the file if it does not exist)
- Root-cause — identify which file (SKILL.md, reference, template) contains the gap
- Fix immediately — edit the skill file directly to prevent recurrence. This is the default action.
- Log only if unsafe — record the issue with
status: open only when the fix would change skill behavior in ways that cannot be verified in the current session. Require a resolution-hint on every open entry.
After logging any status: open entry, append:
Open issues remain. Run /retro-resolve to process them.
retro.md entry format
## YYYY-MM-DD — <brief title>
- **type**: failed-command | user-correction | wrong-assumption | missing-step | outdated-instruction
- **skill**: <skill-name>
- **context**: <what happened>
- **root-cause**: <why it happened>
- **fix**: <what was changed> | `status: open` if not yet fixed
- **resolution-hint**: <what the fix should look like> (required for open entries)
- **files-changed**: <list of files edited, or "none">
