iterate-retrospective
Structures team reflection sessions to document learnings and assign improvement actions.
Install
mkdir -p .claude/skills/iterate-retrospective && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11667" && unzip -o skill.zip -d .claude/skills/iterate-retrospective && rm skill.zipInstalls to .claude/skills/iterate-retrospective
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Facilitates and documents a team retrospective capturing what went well, what to improve, and action items. Use at the end of a sprint, project, or milestone to reflect and improve team practices. To bank individual learnings into organizational memory afterward, use iterate-lessons-log.Key capabilities
- →Define the context of a retrospective
- →Choose a suitable retrospective format
- →Gather input from team members
- →Discuss and prioritize impactful items
- →Define specific and assignable action items
- →Document key points for future reference
How it works
The skill guides the user through a structured retrospective process, from setting context and gathering input to defining action items and documenting the outcome.
Inputs & outputs
When to use iterate-retrospective
- →Conducting sprint retrospectives
- →Documenting project post-mortems
- →Improving team dynamic
About this skill
Retrospective
A retrospective is a structured reflection that helps teams learn from their experiences and continuously improve. By regularly examining what went well, what didn't, and what to change, teams build a culture of learning and adaptation. The value isn't just in the discussion.it's in the documented actions and follow-through.
When to Use
- At the end of every sprint (for agile teams)
- After completing a significant project or milestone
- Following a major incident or outage
- When team dynamics feel off and need addressing
- At regular intervals (monthly, quarterly) even without specific triggers
- When onboarding new team members to establish improvement culture
When NOT to Use
- You want one durable learning banked for the organization -> use
iterate-lessons-log; the retro is the ceremony, the log entry outlives it - You are scoring an OKR cycle at close -> use
measure-okr-grader - The reflection must end in a pivot-or-persevere call -> use
iterate-pivot-decision - You need a recap of a general (non-retro) meeting -> use
foundation-meeting-recap
Instructions
When asked to facilitate or document a retrospective, follow these steps:
-
Set the Context Define what period or project this retrospective covers, who attended, and any significant events that occurred. This frames the discussion and helps future readers understand the context.
-
Choose a Format Select a retrospective format that fits the team's needs. Common options include:
- Start/Stop/Continue: Simple and direct
- 4Ls: Liked, Learned, Lacked, Longed for
- Mad/Sad/Glad: Emotion-focused
- Sailboat: Visual metaphor (wind=helps, anchor=holds back)
-
Gather Input Collect observations from all team members. Ensure everyone contributes.quiet voices often have important insights. Group similar items to identify themes.
-
Discuss and Prioritize Don't try to address everything. Focus the discussion on the most impactful items. Vote or discuss to identify the top 2-3 issues to address.
-
Define Action Items Convert insights into specific, assignable actions. Every action needs an owner and a due date. Avoid vague improvements like "communicate better."
-
Review Previous Actions Check the status of action items from the last retrospective. Celebrate completions and discuss blockers for incomplete items. This builds accountability.
-
Document for Future Reference Capture the key points so they're available for future team members and for tracking patterns over time.
Project Memory Contract
Active only when .claude/pm-skills.local.md exists. With no file, ignore this section entirely
and behave exactly as described above.
- Reads: the recent
artifacts[]entries, so the retrospective can look at what the cycle actually produced instead of relying on recall. - Writes: the lessons as an
interpretationartifact. - Posture: propose the entry and wait for confirmation before writing, unless
memory_auto_append: trueis set, in which case append and echo what was written.
A retrospective surfaces raw observations, patterns, and commitments at once. Record the durable half, the lessons, under a single tag; a downstream reader needs to know how firmly to weight the entry, and a mixed tag tells it nothing.
Output Format
Use the template in references/TEMPLATE.md to structure the output. A complete retrospective fills every template section: Overview; Previous Retrospective Review; What Went Well; What to Improve; Discussion Notes; Action Items; Parking Lot; Metrics and Trends; Facilitator Notes; and Next Retrospective.
Quality Checklist
Before finalizing, verify:
- All attendees had opportunity to contribute
- Both positives and improvements are captured
- Action items have owners and due dates
- Previous retrospective actions are reviewed
- A reader who missed the retro can tell what was decided and who owns each action from this document alone
Examples
See references/EXAMPLE.md for a completed example.
When not to use it
- →When banking individual learnings into organizational memory
- →When scoring an OKR cycle at close
- →When the reflection must end in a pivot-or-persevere call
Limitations
- →Not for general meeting recaps
- →Focuses on team learning and improvement, not individual organizational memory
- →Does not include OKR cycle scoring
How it compares
This skill provides a structured, step-by-step facilitation and documentation process for team retrospectives, ensuring actionable outcomes and historical records.
Compared to similar skills
iterate-retrospective side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| iterate-retrospective (this skill) | 0 | 2mo | No flags | Beginner |
| spec-to-backlog | 8 | 4mo | No flags | Intermediate |
| prd | 0 | 4mo | No flags | Intermediate |
| postmortem-writing | 17 | 2mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
spec-to-backlog
atlassian
Automatically convert Confluence specification documents into structured Jira backlogs with Epics and implementation tickets. When Claude needs to: (1) Create Jira tickets from a Confluence page, (2) Generate a backlog from a specification, (3) Break down a spec into implementation tasks, or (4) Convert requirements into Jira issues. Handles reading Confluence pages, analyzing specifications, creating Epics with proper structure, and generating detailed implementation tickets linked to the Epic.
prd
alfredolopez80
Product Requirements Document generation and management with INVEST-compliant user stories
postmortem-writing
wshobson
Write effective blameless postmortems with root cause analysis, timelines, and action items. Use when conducting incident reviews, writing postmortem documents, or improving incident response processes.
search-company-knowledge
atlassian
Search across company knowledge bases (Confluence, Jira, internal docs) to find and explain internal concepts, processes, and technical details. When Claude needs to: (1) Find or search for information about systems, terminology, processes, deployment, authentication, infrastructure, architecture, or technical concepts, (2) Search internal documentation, knowledge base, company docs, or our docs, (3) Explain what something is, how it works, or look up information, or (4) Synthesize information from multiple sources. Searches in parallel and provides cited answers.
log-knowledge-gap
zrosenfield
Logs unanswered questions to the Knowledge Gaps list and routes them to a subject matter expert. Triggers when the assistant cannot answer a question from the Knowledge Base library. Checks the Expert Directory for a matching expert and assigns the gap automatically.
fc-assistant
wam-leadclic
Main orchestrator for the Salesforce functional consultant engagement lifecycle. Detects the current project phase, guides the consultant through the full engagement (from pre-workshop preparation to training materials), and invokes the appropriate skill at each stage. Entry point for all functional