CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-build-auto

One iteration of an unattended development loop. Use when invoked by name

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/bmad-build-auto/SKILL.md

The canonical home for this skill is bmad-build in bmad-code-org/BMAD-METHOD

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 dispatcher: an exact command, precise substitution and flag rules, and explicit handling for every failure mode (HALT, missing script, uv unavailable, unexpected output). The only weakness is that the two bundled reference files are completely unsignaled from SKILL.md, leaving no navigation path to them.

DimensionReasoningScore

Conciseness

"Run the following command exactly once without changing the current working directory" plus two one-line substitution rules and five compact bullets — lean and efficient with zero padding and no explanations of concepts Claude already knows, matching anchor 5. Not 4 because there is nothing to trim: every instruction carries operational weight.

5 / 5

Actionability

A fully executable command with precise placeholder rules ("Replace `{project-root}` with the nearest folder containing `_bmad/`, from the working directory upward"), exact flag syntax (`--set workflow.route=<value>`) with enumerated valid values (`oneshot`, `full`, `none`/`quick`/`thorough` including the "skip review"/"no review" synonym mapping), and concrete handling for every branch — matching anchor 5 (copy-paste ready, common cases covered).

5 / 5

Workflow Clarity

The single action (substitute placeholders, run the render command, follow the printed workflow) is unambiguous, and every anticipated outcome has an explicit checkpoint: `HALT: <reason>` → "report the reason and stop"; missing script → offer BMad setup then re-run; "On any other output or failure, including `uv` being unavailable, report the command output and stop." This matches anchor 5's explicit error-recovery branches, and the simple-skill exception applies (the skill is a single-purpose dispatcher, not itself a destructive or batch operation).

5 / 5

Progressive Disclosure

The bundle provides references/claims-check.md and references/deletion-check.md, but the body never mentions or signals either file — matching anchor 3 ("references present but not clearly signaled"). Not 4 because navigation to the existing bundle files is entirely absent; not lower because the body itself is well organized with no content inlined that belongs in a separate file, and the run-on-demand render design is itself a disclosure mechanism.

3 / 5

Total

18

/

20

Passed

Description

46%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 explicitly covers both what (one iteration of an unattended development loop) and when (invoked by name), but the 'what' is domain-level rather than concrete and there are no natural trigger terms a user would actually say. It is serviceable for a name-invoked skill but well below the clarity bar set by the good examples.

Suggestions

State the concrete actions an iteration performs, e.g., "Runs one iteration of the BMad unattended development loop: renders the project's workflow, executes the build, and runs the requested review pass" — this would raise specificity and make the 'what' concrete.

Add natural trigger phrases users would say, e.g., "Use when the user asks to run a build iteration, continue/babysit the dev loop, or says 'bmad build auto'" — currently only "invoked by name" exists.

Anchor the description to its ecosystem niche ("BMad") to sharpen distinctiveness from generic development-loop or CI skills.

DimensionReasoningScore

Specificity

"One iteration of an unattended development loop" names the domain (development loop) and the operation (one iteration) but lists no concrete actions — matching anchor 2 ("Names the domain but actions are minimal or generic"). Not 3 because no 1-2 concrete actions (build, review, render) are stated; not 1 because the domain and scope are explicitly named rather than purely abstract.

2 / 5

Completeness

Both elements are present: the 'what' ("One iteration of an unattended development loop") and an explicit 'when' ("Use when invoked by name") — matching anchor 4 (both present, one could be stronger). Not 5 because the 'what' states scope rather than concrete capabilities with trigger phrases; not 3 because the 'when' is explicitly stated, not missing or weakly implied.

4 / 5

Trigger Term Quality

The only trigger guidance is "Use when invoked by name", and the domain phrase "unattended development loop" is technical jargon; there are no natural terms a user would say (e.g., "build iteration", "run the loop", "bmad"). This sits between anchor 1 (no natural keywords, only technical jargon) and anchor 2 (one or two generic keywords, missing natural phrases) → 2.

2 / 5

Distinctiveness Conflict Risk

"unattended" and "One iteration" add some specificity and the name-invocation trigger reduces accidental firing, but the text never mentions its BMad ecosystem and reads generically within the development/CI-loop domain — matching anchor 3 ("Somewhat specific but could still overlap with similar skills"). Not 4 because it lacks the niche markers (e.g., "BMad") that would clearly separate it from other build/loop skills.

3 / 5

Total

11

/

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-build-auto/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.