CtrlK
BlogDocsLog inGet started
Tessl Logo

bmad-agent-dev

Senior software engineer for story execution and code implementation. Use when the user asks to talk to Amelia or requests the developer agent.

64

Quality

76%

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 ./src/bmm-skills/4-implementation/bmad-agent-dev/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

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

The body is a tightly sequenced, actionable activation procedure with explicit error handling and a validation checkpoint; its only weakness is minor redundancy in the persona-embodying prose.

DimensionReasoningScore

Conciseness

The body is mostly instruction-dense and free of concept-explanation padding, but persona-embodying lines ("Fully embody this persona so the user gets the best experience", repeated icon-prefix reminders) could be tightened, so it is anchor 2 rather than the lean anchor 3.

2 / 3

Actionability

It gives an executable command (python3 .../resolve_customization.py ...), concrete fallback file paths, and explicit merge semantics, matching the anchor-3 copy-paste-ready bar; it is not 2 because the guidance is concrete rather than pseudocode.

3 / 3

Workflow Clarity

Eight clearly numbered steps with an explicit script-failure fallback and a validation checkpoint ("confirm every entry was executed in order ... Do not begin the main workflow until all activation steps have been completed") match anchor 3; it is not 2 because validation is explicit, not implicit.

3 / 3

Progressive Disclosure

It is a well-organized self-contained single-file skill with clear sections (Overview, Conventions, On Activation) and no nested or deep references, satisfying the well-organized-sections bar for anchor 3.

3 / 3

Total

11

/

12

Passed

Description

67%

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 answers both what and when with an explicit Use-when clause, but its capabilities are stated broadly and its triggers focus on persona invocation rather than the engineering work itself.

Suggestions

Add concrete actions to the what-clause (e.g. "implements approved stories test-first, writes and refactors code to meet acceptance criteria") to lift specificity.

Broaden the Use-when triggers to cover the actual work (e.g. "Use when the user asks to implement or code a story, or requests the developer agent (Amelia)").

Tie distinctiveness to the BMAD/story-execution niche (e.g. mention stories, acceptance criteria, or the BMAD workflow) so it is less likely to conflict with generic coding skills.

DimensionReasoningScore

Specificity

"story execution and code implementation" names the domain and some actions but stays high-level rather than listing multiple concrete actions like the anchor-3 example, so it sits at anchor 2 and not 3.

2 / 3

Completeness

It states what ("Senior software engineer for story execution and code implementation") and gives an explicit "Use when..." clause for when, matching the anchor-3 both-what-and-when bar; it is not 2 because the explicit trigger guidance is present.

3 / 3

Trigger Term Quality

"talk to Amelia" and "developer agent" are natural persona-invocation terms, but common work-trigger variations a user would say (e.g. "implement a story", "write code") are missing, keeping it at anchor 2 rather than 3.

2 / 3

Distinctiveness Conflict Risk

The "Amelia"/"developer agent" trigger gives some distinctness, but the "code implementation" capability is broad and would overlap with other coding skills, so it is not the clearly-niched anchor 3.

2 / 3

Total

9

/

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

referenced_paths_exist

Referenced path issues: 1 missing

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.