CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-retrospective

Review a finished epic folder in the ticket tree against the evidence it left behind — the epic file, each ticket plan, diffs, commits — and produce a retrospective with sourced findings, action items, and an acceptance decision. Use when the user says "run a retrospective" or "lets retro the epic [epic]". Supports -H/--headless

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

96%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an exemplary thin dispatcher: a single exact command, concretely defined placeholders, and exhaustive handling of every output outcome including failure modes. The single gap is that the bundle's phase references and scripts are only reachable through the rendered workflow rather than being signaled from the SKILL.md itself.

DimensionReasoningScore

Conciseness

The 12-line body is entirely instruction with zero padding: "Run the following command exactly once without changing the current working directory", two placeholder definitions, one command, and three output-handling bullets. Every token earns its place and no concept Claude already knows is explained, matching the lean-and-efficient anchor rather than the anchor below, which allows minor trimmable over-explanation.

5 / 5

Actionability

The single exact command ("uv run --no-cache \"{project-root}/_bmad/scripts/render_skill.py\" --project-root ... --skill ...") is executable once its two placeholders are filled, and both placeholders are concretely defined ("the nearest folder containing `_bmad/`, from the working directory upward"). The three enumerated output branches cover the common success and failure cases, matching the fully-executable anchor; the anchor below would require gaps in the guidance, and there are none.

5 / 5

Workflow Clarity

The sequence is clear (resolve project root, resolve skill root, run once, interpret output) with an explicit validation checkpoint on the command's stdout: each outcome has a mandated response — "read and follow <rendered workflow.md>", "HALT: <reason>: report the reason and stop", and on any other failure "report the command output and stop. Do not run any workflow source directly". The script-missing branch adds a feedback loop (offer setup, then run again). This matches the anchor requiring explicit validation steps and error-recovery loops; the retrospective workflow itself is read-only, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

The entry point is maximally lean and the multi-phase content is appropriately split into real bundle files — five phase documents under references/ (e.g., evidence-gathering.md, which invokes {skill-root}/scripts/git_evidence.py) and a measurement script under scripts/ — all verified to exist and effectively one level deep behind the rendered workflow. It falls short of the top anchor because the body itself signals none of the bundle paths: navigation is mediated entirely by the externally rendered workflow.md, so references are not directly signaled from the overview.

4 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it concisely states what the skill does with concrete evidence sources and outputs, and gives explicit quoted trigger phrases for when to use it. The only weakness is that a few natural trigger variations (e.g., post-mortem, lessons learned) are not covered.

DimensionReasoningScore

Specificity

The description enumerates concrete actions ("Review a finished epic folder ... against the evidence it left behind — the epic file, each ticket plan, diffs, commits — and produce a retrospective with sourced findings, action items, and an acceptance decision") and names the exact evidence sources and outputs. It is comprehensive for the domain, matching the anchor for multiple specific concrete actions rather than the anchor below, which allows minor coverage gaps.

5 / 5

Completeness

Both questions are explicitly answered: the "what" is detailed (review epic evidence, produce a retrospective with sourced findings, action items, and an acceptance decision) and the "when" gives concrete quoted trigger phrases ("Use when the user says..."). This is a direct match to the anchor requiring clear and explicit what AND when with concrete trigger phrases, not the anchor below where "when" could be more specific.

5 / 5

Trigger Term Quality

Explicit natural phrases are present — "Use when the user says \"run a retrospective\" or \"lets retro the epic [epic]\"" — covering both the retrospective and retro synonyms, which beats the missing-variations anchor. It falls short of the comprehensive anchor because common variations users might say, such as "post-mortem" or "lessons learned", are absent.

4 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — epic retrospectives over a BMad ticket tree — with distinct triggers ("run a retrospective", "lets retro the epic") that would not naturally fire for other skills. Third-person voice is used throughout with no first/second-person phrasing to penalize.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

bmad-code-org/BMAD-METHOD

Path

skills/bmad-retrospective/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.