CtrlK
BlogDocsLog inGet started
Tessl Logo

bmad-retrospective

Post-epic review to extract lessons and assess success. Use when the user says "run a retrospective" or "lets retro the epic [epic]"

48

Quality

51%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./src/bmm-skills/4-implementation/bmad-retrospective/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

27%

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

The skill is a thorough but bloated single-file roleplay script: it over-specifies dialogue Claude could generate itself, lacks bundle-file decomposition, and uses conversational waits in place of concrete validation gates. Actionability and sequencing are present but diluted by the verbosity.

Suggestions

Move the scripted party-mode dialogue into a referenced file (e.g. DIALOGUE.md) and keep SKILL.md as a concise overview of the 13-step workflow with the concrete commands and file contracts, fixing the progressive-disclosure and conciseness issues.

Replace conversational 'WAIT for {user_name}' placeholders with explicit validation checkpoints (e.g. confirm epic_number is set before proceeding; validate YAML after writing sprint-status and re-try on parse failure) to lift workflow clarity to 3.

Cut explanatory narrative about retrospectives and facilitation philosophy that Claude already knows; keep only the BMAD-specific contracts (paths, scripts, status keys, output filename) so every token earns its place.

DimensionReasoningScore

Conciseness

At ~1520 lines, the body is a monolithic wall of pre-scripted roleplay dialogue and templated placeholders that pads the context with content Claude does not need to be told how to produce; it violates the token-budget principle that skills should add only what Claude doesn't already know.

1 / 3

Actionability

It provides some concrete executable guidance (real commands like 'python3 {project-root}/_bmad/scripts/resolve_customization.py', file path patterns, and a YAML action_items snippet to write), but the bulk of the actionable steps are buried under scripted narrative and placeholder variables rather than crisp instructions.

2 / 3

Workflow Clarity

The 13 steps are clearly numbered and sequenced with branching <check> blocks, but validation checkpoints are largely conversational ('WAIT for {user_name}...') rather than concrete verification gates, and the destructive sprint-status/YAML writes in Step 12 lack an explicit validate-then-retry feedback loop.

2 / 3

Progressive Disclosure

Everything lives in a single monolithic SKILL.md with no bundle files and no one-level-deep reference pointers; the few external paths referenced are framework scripts (resolve_customization.py, config.yaml), not skill-owned reference materials that decompose the content.

1 / 3

Total

6

/

12

Passed

Description

75%

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

The description is well-formed: it uses third person, states what the skill does, and gives an explicit 'Use when' trigger clause. It is held back from top marks only by limited action breadth and trigger-term variation.

Suggestions

Broaden the capability list to more concrete actions (e.g. 'extract lessons, assess delivery success, capture action items, flag epic plan updates') to reach specificity 3.

Add common trigger-term variations (e.g. 'post-mortem', 'lessons learned', 'review the epic') so the description matches a wider range of natural phrasings.

DimensionReasoningScore

Specificity

Names the domain ('Post-epic review') and two concrete actions ('extract lessons and assess success'), but does not list multiple specific concrete actions like the score-3 anchor (e.g. extract text, fill forms, merge).

2 / 3

Completeness

Explicitly answers both what ('Post-epic review to extract lessons and assess success') and when ('Use when the user says...'), matching the score-3 anchor with an explicit trigger clause.

3 / 3

Trigger Term Quality

Includes natural phrasings users would say ('run a retrospective', 'lets retro the epic'), but coverage of common variations is thin — no synonyms like 'lessons learned', 'post-mortem', or 'review the epic'.

2 / 3

Distinctiveness Conflict Risk

The epic-retrospective niche with distinct triggers ('run a retrospective', 'retro the epic') is clearly distinguishable and unlikely to fire for the wrong skill.

3 / 3

Total

10

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (1528 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository
bmad-code-org/BMAD-METHOD
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.