CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-customize

Authors and updates customization overrides for installed BMad skills. Use when the user says 'customize bmad', 'override a skill', 'change agent behavior', or 'customize a workflow'

Quality

91%

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.

An excellent procedural skill: fully executable commands, explicit sequencing with validation and a recovery loop, and tight token efficiency. The only room for improvement is slight redundancy in the out-of-scope statements and minimal use of reference pointers.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of concept explanations or padding ("Overrides are sparse: only the fields being changed. Never copy the whole customize.toml."); every token carries instruction, matching the lean anchor.

5 / 5

Actionability

Guidance is fully executable: exact commands (uv run {skill-root}/scripts/list_customizable_skills.py --project-root {project-root}), exact file names (bmad-agent-<role>.toml / .user.toml), and concrete TOML field names (persistent_facts, activation_steps_prepend, on_complete) throughout.

5 / 5

Workflow Clarity

Steps 1-6 are clearly sequenced with explicit validation (show diff, wait for explicit yes, resolver verify) and a genuine error-recovery feedback loop ("Verify shows override didn't land ... re-enter Step 4"), so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

Good structure with tooling correctly externalized to the real scripts/list_customizable_skills.py and out-of-scope detail deferred to an external guide, but the entire procedure lives inline with only minimal one-level pointers and out-of-scope items are stated twice (intro and "When this skill can't help"), leaving minor organization gaps versus the ideal overview-plus-references split.

4 / 5

Total

19

/

20

Passed

Description

82%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 with an explicit what/when structure and natural quoted trigger phrases. Its only weaknesses are modest action coverage in the what-clause and a few missing synonyms among triggers.

Suggestions

Enumerate one or two more concrete actions in the what-clause (e.g. "discovers customizable skills and verifies merged overrides") to lift specificity.

Add a synonym trigger phrase such as 'personalize an agent' or 'tweak a workflow' to broaden natural-term coverage.

DimensionReasoningScore

Specificity

"Authors and updates customization overrides for installed BMad skills" names the domain plus two concrete actions, but stops short of the several specific actions (discover, route, verify) that would justify a 4.

3 / 5

Completeness

It explicitly answers both what ("Authors and updates customization overrides for installed BMad skills") and when ("Use when the user says 'customize bmad', 'override a skill', ...") with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Four natural quoted phrases users would actually say ("customize bmad", "override a skill", "change agent behavior", "customize a workflow") give good coverage, but common synonyms like "personalize" or "tweak" are missing, so it falls just short of the comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche (authoring TOML override files for BMad skills) with distinct quoted triggers makes accidental activation by unrelated skills very unlikely.

5 / 5

Total

17

/

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