| name | common-session-retrospective |
| description | Analyze conversation corrections to detect skill gaps and auto-improve the skills library. Use after any session with user corrections, rework, or retrospective requests. (triggers: **/*.spec.ts, **/*.test.ts, SKILL.md, AGENTS.md, retrospective, self-learning, improve skills, session review, correction, rework) |
Session Retrospective
Priority: P1 (OPERATIONAL)
Structure
common/session-retrospective/
├── SKILL.md # Protocol (this file)
└── references/
└── methodology.md # Signal tables, taxonomy, report template
Protocol
- Extract — Scan for correction signals (loops, rejections, shape mismatches, lint rework)
- Classify — Root cause: Skill Missing | Incomplete | Example Contradicts Rule | Workflow Gap | Trigger Miss
- Trigger Miss Check — For every task in the session, ask: "Was a relevant skill available but not loaded?"
- If yes: record skill ID, indirect phrase used, and fix (add keyword alias to triggers)
- Propose — One fix per root cause: update skill, update reference, new skill, or new workflow
- Implement — Apply to all agent dirs. Keep SKILL.md concise; move large tables to
references/. Update AGENTS.md
- Report — Output correction count, skills changed, trigger misses found, estimated rounds saved
Trigger Miss Output
Emit a trigger miss block (schema in references/methodology.md) for each miss detected.
Guidelines
- Cite specifics: Reference concrete conversation moment per proposal
- Extend first: Search
AGENTS.md before creating — update existing skills
- One fix per loop: One correction → one targeted skill change
- Sync all agents: Apply to every agent skill dir listed in
.skillsrc agents field
- Follow skill-creator: New skills comply with
common/skill-creator standards
Anti-Patterns
- No Vague Proposals: Cite exact gap + fix, not "make X better"
- No Duplicate Skills: Search AGENTS.md index first
- No Oversized Patches: Extract to
references/ per skill-creator standard
References
Signal tables, root cause taxonomy, report template, real-world example:
references/methodology.md
