CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-walkthrough

Guide a human review of a commit, PR, file, or directory. Use when invoked by name

Quality

87%

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

100%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 lean launcher: one exact, executable command with explicit substitution rules and complete, concrete handling of every failure mode (HALT, missing script, unavailable uv). It fully respects the token budget and delegates workflow detail to the rendered output.

DimensionReasoningScore

Conciseness

The body is 14 lines with no concept explanations and no padding: an exact command, placeholder substitution rules, and three contingency bullets. Every token is load-bearing ("exactly once", "without changing the current working directory", "Do not run any workflow source directly"), matching anchor 5 rather than 4, which expects trimmable over-explanation.

5 / 5

Actionability

The skill provides a fully executable command with explicit placeholder-substitution instructions, and error paths are handled with concrete commands ("npx skills add bmad-code-org/BMAD-METHOD --skill bmad") and unambiguous directives (report and HALT). This matches anchor 5's copy-paste-ready guidance covering the common cases.

5 / 5

Workflow Clarity

This is a simple single-task skill and the one action is unambiguous, so the simple-skill exception applies. Beyond that, each failure branch is explicitly sequenced: script not found -> offer setup (install if needed) -> rerun once; HALT output -> report and stop; any other failure -> report and HALT. No destructive or batch operations are involved, so no validation cap applies.

5 / 5

Progressive Disclosure

The skill is well under 50 lines with no inlined bulk content and no external references to organize; per the rubric's simple-skill guidance this scores 5. Deferring the actual workflow to the rendered output is itself well-signaled one-level-deep disclosure ("The command prints the skill's workflow: follow it").

5 / 5

Total

20

/

20

Passed

Description

70%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.

The description is concise, third-person, and answers both what and when, with natural target keywords (commit, PR, file, directory). Its main weakness is thinness: a single generic action verb and a when clause that relies solely on invocation by name without concrete trigger phrases.

Suggestions

Enumerate the concrete review activities (e.g., "walk through the diff, flag risky changes, summarize findings for the reviewer") instead of the single generic action "Guide a human review".

Expand the when clause with concrete trigger phrases, e.g., "Use when the user asks to review a commit, PR, or files, or invokes bmad-walkthrough by name".

Add natural trigger synonyms such as "pull request", "code review", or "diff" to widen keyword coverage.

DimensionReasoningScore

Specificity

"Guide a human review of a commit, PR, file, or directory" names the domain and one concrete action with specific targets, but does not list several distinct actions (e.g., what the review involves or produces). It fits anchor 3 (domain plus 1-2 concrete actions) rather than 4, which requires multiple specific actions, and the action is too concrete for anchor 2's generic-minimal bar.

3 / 5

Completeness

Both parts are present: "Guide a human review of a commit, PR, file, or directory" answers what, and "Use when invoked by name" is an explicit when clause, so the missing-trigger cap at 3 does not apply. It is not a 5 because the when clause gives no concrete trigger phrases (e.g., when the user asks to review a commit or PR).

4 / 5

Trigger Term Quality

"commit, PR, file, or directory" plus "review" are natural terms users would say, comparable to anchor 4's "PDF files, forms, document extraction". It falls short of anchor 5 because common variations like "pull request", "diff", "changes", or "code review" are missing.

4 / 5

Distinctiveness Conflict Risk

The "human review" framing and name-only invocation ("Use when invoked by name") carve a fairly distinct niche, but "review of a commit, PR, file, or directory" overlaps with code-review-style skills. This matches anchor 4 (mostly distinct, minor overlap risk with closely related skills) rather than 5's clear-niche bar.

4 / 5

Total

15

/

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-walkthrough/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.