retrospective
Skill1 starsChanged 6 days agoMITView on GitHub
Facilitate sprint retros, project post-mortems, and incident post-mortems with actionable, owned improvements. Triggers: retrospective, retro, post-mortem, postmortem, lessons learned, what went wrong, what went well, incident review, blameless, action items, sprint review, after action review.
69 other projects use a version of this.
Adopted by
Most recently taken up by
- Adelie-Squad/solosquadtheir own version, first seen Nov 8, 2026
- sbfnk/skillstheir own version, first seen Nov 8, 2026
- AndyB840506/skillstheir own version, first seen Nov 8, 2026
- paureis/pau-skillstheir own version, first seen Nov 8, 2026
- AsiaOstrich/EngramGraphtheir own version, first seen Nov 8, 2026
- simonasrazm/skillstheir own version, first seen Nov 8, 2026
Used with
Projects with it also use dev-story, team-level and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
lilangMaxSkilldev-story
Read a story file and implement it. Loads the full context (story, GDD requirement, ADR guidelines, control manifest), routes to the right programmer agent for the system and engine, implements the code and test, and confirms each acceptance criterion. The core implementation skill — run after /story-readiness, before /code-review and /story-done.
Also in 12 projects that use this
CoralGameSkillteam-level
Orchestrate level design team: level-designer + narrative-director + world-builder + art-director + systems-designer + qa-tester for complete area/level creation.
Also in 12 projects that use this
CoralGameSkillteam-narrative
Orchestrate the narrative team: coordinates narrative-director, writer, world-builder, and level-designer to create cohesive story content, world lore, and narrative-driven level design.
Also in 12 projects that use this
lilangMaxSkillcreate-stories
Break a single epic into implementable story files. Reads the epic, its GDD, governing ADRs, and control manifest. Each story embeds its GDD requirement TR-ID, ADR guidance, acceptance criteria, story type, and test evidence path. Run after /create-epics for each epic.
Also in 11 projects that use this
- +7 more from lilangMax
- +1 more from CoralGame
Other versions69 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 69
- Donchitos/Claude-Code-Game-Studios★ 27ksame name
- alibaba/MNN★ 16ksame name
- glebis/claude-skills★ 410same name
- pixel-cellar/Claude-Code-Game-Studios★ 324same name
- blacklanternsecurity/red-run★ 296same name
- striderZA/OpenCodeGameStudios★ 118same name
- The01Geek/prflow★ 99same name
- PAIR-code/deliberate-lab★ 97same name
- AsiaOstrich/universal-dev-standards★ 84same name
- tranhieutt/software_development_department★ 71same name
59 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository68 other files it gives its agents.
- AGENTS.mdAGENTS.md
- accessibility-designSkill
- ai-evaluationSkill
- api-designSkill
- architecture-designSkill
- architecture-documentationSkill
- brainstormingSkill
- browser-verificationSkill
- bug-investigatingSkill
- build-vs-buySkill
- cicd-pipelineSkill
- code-archaeologySkill
- code-reviewingSkill
- code-slop-cleanupSkill
- compliance-privacySkill
- configuration-strategySkill
- containerizationSkill
- data-modelingSkill
- data-pipeline-designSkill
- data-qualitySkill
- dependency-impact-analysisSkill
- dependency-managementSkill
- deployment-checklistSkill
- deployment-repoSkill
- dx-auditSkill
- effort-estimationSkill
- exploratory-data-analysisSkill
- feature-planningSkill
- finops-cost-optimizationSkill
- frontend-architectureSkill
- gitops-deliverySkill
- git-workflowSkill
- incident-responseSkill
- infrastructure-as-codeSkill
- llm-app-engineeringSkill
- metrics-and-okrsSkill
- ml-experiment-trackingSkill
- ml-model-deploymentSkill
- ml-pipeline-designSkill
- mobile-architectureSkill
- mobile-releaseSkill
- notebook-to-productionSkill
- observability-designSkill
- performance-optimizationSkill
- plan-executionSkill
- prd-writingSkill
- project-documentationSkill
- project-proposalSkill
- project-reviewSkill
- refactoringSkill
- release-managementSkill
- research-methodologySkill
- resilience-engineeringSkill
- rollback-strategySkill
- security-auditSkill
- skill-routerSkill
- statistical-analysisSkill
- strategic-reviewSkill
- subagent-orchestrationSkill
- tdd-workflowSkill
- The first 60 shown.
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. 0 are common, 14 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 58 edited versions we read keep these.
14
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 19
When: After a significant project or milestone completes
- Distinctive: line 25
When: After any production incident that impacted users
- Distinctive: line 42
Use one of these formats:
- Distinctive: line 62
Don't try to fix everything.
- Distinctive: line 75
Before the meeting, gather:
- Distinctive: line 92
Use the template at templates/post-mortem.md.
- Distinctive: line 103
When did the incident start?
- Distinctive: line 104
When was it detected? (By monitoring or by users?)
- Distinctive: line 105
When was the team alerted?
- Distinctive: line 107
When was the incident resolved?
- Distinctive: line 108
When was the root cause confirmed?
- Distinctive: line 112
Use the "5 Whys" technique to dig past symptoms:
- Distinctive: line 141
Use the template at templates/post-mortem.md.
- Distinctive: line 146
Action over discussion: Every retro must produce specific, owned action items.
“Common” is measured: kept by at least 6 in 10 of the 58 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Retrospective
Facilitate structured reflection that produces concrete improvements. The goal is not to assign blame — it's to make the next iteration better than the last.
Three Formats
Sprint Retrospective
When: End of every sprint Duration: 30-60 minutes Scope: What happened this sprint Output: 2-3 action items with owners for next sprint
Project Post-Mortem
When: After a significant project or milestone completes Duration: 60-90 minutes Scope: The entire project from planning through delivery Output: Written document with learnings and recommendations
Incident Post-Mortem
When: After any production incident that impacted users Duration: 60 minutes Scope: The incident timeline, response, and systemic causes Output: Blameless post-mortem document with prevention actions
Workflow: Sprint Retrospective
Step 1: Gather Data
Collect information about the sprint before the meeting:
- Sprint velocity vs commitment
- Items completed vs carried over
- Incidents or bugs discovered
- Team sentiment (optional pulse survey)
Step 2: Facilitate Discussion
Use one of these formats:
Start/Stop/Continue:
- Start doing: What should we begin doing that we aren't?
- Stop doing: What's wasting time or causing problems?
- Continue doing: What's working well?
Went Well / Didn't Go Well / Action Items:
- What went well this sprint? (Celebrate wins)
- What didn't go well? (Identify problems without blame)
- What specific actions will we take to improve?
4Ls (Liked, Learned, Lacked, Longed for):
- What did we like about this sprint?
- What did we learn?
- What was lacking?
- What did we long for (wish we had)?
Step 3: Prioritize Action Items
Don't try to fix everything. Pick the top 2-3 improvements:
- Each action item gets an owner (one person, not "the team")
- Each action item gets a deadline (usually "by end of next sprint")
- Each action item is specific enough to verify completion
Step 4: Record and Follow Up
Save the retro notes. At the start of next sprint's retro, review the previous action items: were they completed?
Workflow: Project Post-Mortem
Step 1: Prepare the Review
Before the meeting, gather:
- Original project proposal, PRD, and estimates
- Actual timeline and effort vs estimated
- Key decisions made during the project and their outcomes
- Metrics: did the project hit its success criteria?
Step 2: Walk Through Key Questions
- Did we solve the right problem? Was the original problem statement accurate?
- Did we estimate well? Where were estimates off and why?
- What decisions would we make differently? (Technical, scope, team)
- What processes helped? (What to keep)
- What processes hindered? (What to change)
- What surprised us? (Unknowns that became knowns too late)
Step 3: Produce the Document
Use the template at templates/post-mortem.md. Share with the team and stakeholders.
Workflow: Incident Post-Mortem
Blameless Culture
The most important principle: incidents are caused by systems, not people. If a human made an error, the question is "why did the system allow that error to cause an outage?" not "who messed up?"
Step 1: Build the Timeline
Reconstruct a minute-by-minute timeline:
- When did the incident start?
- When was it detected? (By monitoring or by users?)
- When was the team alerted?
- What actions were taken and when?
- When was the incident resolved?
- When was the root cause confirmed?
Step 2: Identify Root Causes
Use the "5 Whys" technique to dig past symptoms:
Why did users see errors? → The API returned 500s.
Why did the API return 500s? → Database connections were exhausted.
Why were connections exhausted? → A query was holding connections open.
Why was a query holding connections? → A missing index caused full table scans.
Why was the index missing? → No index review process exists for migrations.
→ Root cause: No systematic review of database performance for new migrations.Step 3: Define Prevention Actions
For each root cause, define an action that prevents recurrence:
| Action | Type | Owner | Deadline |
| Add EXPLAIN ANALYZE check to migration CI | Prevention | [Name] | [Date] |
| Add connection pool monitoring alert | Detection | [Name] | [Date] |
| Document index guidelines for team | Process | [Name] | [Date] |
Action types:
- Prevention: Makes the incident impossible to recur
- Detection: Makes the incident detectable before user impact
- Mitigation: Reduces the blast radius if it happens again
- Process: Changes how the team works to reduce risk
Step 4: Produce the Post-Mortem
Use the template at templates/post-mortem.md. Publish internally — transparency builds trust and helps other teams learn.
Principles Applied
- Blameless over blame: Focus on systems, not individuals. "The deploy script didn't validate X" not "Dave forgot to check X."
- Action over discussion: Every retro must produce specific, owned action items. A retro without action items is just venting.
- KISS: 2-3 action items per retro, not 15. Fewer items done beats many items forgotten.
- Continuous improvement: Small improvements every sprint compound. A 5% improvement per sprint is 3x better in a year.
Cross-Skill References
incident-response— triggers a post-mortem; use this skill for the post-mortem workflowtechnical-debt-review— if retrospectives repeatedly surface the same maintenance pain, escalate to a full debt review
See references/facilitation-guide.md for retro formats, handling difficult conversations, and action item quality criteria.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

