Skillshub common-session-retrospective

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)

install

source · Clone the upstream repo

git clone https://github.com/ComeOnOliver/skillshub

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/HoangNguyen0403/agent-skills-standard/common-session-retrospective" ~/.claude/skills/comeonoliver-skillshub-common-session-retrospective && rm -rf "$T"

manifest: skills/HoangNguyen0403/agent-skills-standard/common-session-retrospective/SKILL.md

source content

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