Retro Learn Agent Skill
Convert delivery findings into skill, eval, workflow, and documentation improvements.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/HoangNguyen0403/agent-skills-standard --skill retro-learnThe instruction itself
8 sections, as written by the authorRetro Learn Skill
> [!IMPORTANT]
> Convert delivery findings into skill, eval, workflow, and documentation improvements.
Optional args: slug=<feature>, ticket=<id/url>, mode=interactive|autonomous|channel, channel=<id>, auto_continue=true|false, profile=business|hybrid|technical.
Instructions
When the user asks to perform this workflow, execute the following steps:
Retro Learn Workflow
Goal: Turn defects, missed expectations, and delivery friction into durable standards improvements.
Steps
- Gather evidence:
- Review findings
- Bugs found during verification
- Security findings
- User corrections
- Failed or slow checks
- Token or context pain
session-reportartifacts- Classify:
- Skill rule gap
- Eval coverage gap
- Workflow gap
- Documentation gap
- Tooling gap
- Specialist gap
- Environment-only issue
- Decide action:
- Existing skill should prevent it: update
SKILL.mdandevals/evals.json. - No skill covers it: propose a new skill.
- Workflow caused drift: update
.agents/workflows. - Specialist caused drift: add budget, fallback, or output-format rule.
- Tooling can catch it: add or update an audit script.
- Verify learning:
- Run changed skill validation.
- Run eval alignment.
- Record remaining follow-ups.
Runtime Contract
- Use after delivery findings, corrections, or friction need converting into durable standards improvements.
- Required inputs: review findings, verification results, or session-report artifacts to classify.
- Return BLOCKED only when no evidence exists to classify.
Handoff Payload
slug, root causes, skill/eval updates, follow-ups, next workflow.
Blocking Questions
- Ask max 3 at a time with a recommended default and 2-3 options.
Output Template
# Retro: [Name]
## Evidence
## Root Causes
| Finding | Category | Action |
| --- | --- | --- |
| [finding] | [category] | [action] |
## Skill Or Eval Updates
## Outcome Report
feature_status: implemented
requirement_trace: BRD-OBJ-* -> REQ-* -> AC-* -> SRS-* -> evidence
completed_evidence: []; missing_evidence: []; decision_needed: []; recommended_next_workflow: none
## Next Workflow
## Follow-Ups
## Cost Report
Call `get_session_cost(workflow="retro-learn")` before final handoff.
Other skills for the same job
different authors, same section of the catalogue
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Replace with description of the skill and when Claude should use it.
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Use when creating new skills, editing existing skills, or verifying skills work before deployment
How to use it
Take hoangnguyen0403/retro-learn from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.