Skillshub 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.

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/session-retrospective" ~/.claude/skills/comeonoliver-skillshub-session-retrospective && rm -rf "$T"
manifest: skills/HoangNguyen0403/agent-skills-standard/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

  1. Extract — Scan for correction signals (loops, rejections, shape mismatches, lint rework)
  2. Classify — Root cause: Skill Missing | Incomplete | Example Contradicts Rule | Workflow Gap
  3. Propose — One fix per root cause: update skill, update reference, new skill, or new workflow
  4. Implement — Apply to all agent dirs. Keep SKILL.md ≤70 lines. Update
    AGENTS.md
  5. Report — Output correction count, skills changed, estimated rounds saved

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