CtrlK
BlogDocsLog inGet started
Tessl Logo

bmad-agent-architect

System architect and technical design leader. Use when the user asks to talk to Winston or requests the architect.

68

Quality

83%

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

77%

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

A well-structured, highly actionable activation workflow with clear sequencing and validation. It loses points on conciseness (redundant persona-prefix guidance) and progressive disclosure (a monolithic single file with inline detail that could be externalized).

Suggestions

Consolidate the repeated {agent.icon} prefix guidance into a single statement so it is stated once rather than across Steps 6, 8, and the closing paragraph.

Move the persona/customization detail (Step 3 persona layering, Step 4 persistent facts, Step 5 config keys) into a references file referenced from SKILL.md to reduce inline bulk and improve progressive disclosure.

Tighten soft commentary like "Fully embody this persona so the user gets the best experience" into concrete directives to improve token efficiency.

DimensionReasoningScore

Conciseness

The body is mostly efficient instruction with no concept padding, but repeats the {agent.icon} prefix guidance across Steps 6, 8 and the closing line, and includes soft commentary ("Fully embody this persona so the user gets the best experience") that could be trimmed, matching the level-2 "could be tightened" anchor.

2 / 3

Actionability

It gives a concrete executable command (`python3 {project-root}/_bmad/scripts/resolve_customization.py ...`), explicit merge rules, a precise menu-table spec and clear dispatch rules, matching the fully-executable level-3 anchor.

3 / 3

Workflow Clarity

Eight numbered steps are sequenced clearly with an explicit validation checkpoint ("confirm every entry was executed in order before proceeding"), a fallback for script failure, and clarification guidance, matching the level-3 anchor with explicit checkpoints and error-recovery handling.

3 / 3

Progressive Disclosure

This is a single self-contained file with no bundle references; the ~70-line body is well sectioned but keeps persona and config-resolution detail inline that could be split out, fitting the level-2 anchor where some content that should be separate stays inline.

2 / 3

Total

10

/

12

Passed

Description

90%

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 that clearly answers both what and when with natural, distinctive trigger terms tied to the Winston persona. The only weakness is specificity, where it names the role but does not enumerate concrete actions.

DimensionReasoningScore

Specificity

"System architect and technical design leader" names the domain and role but offers only one vague action phrase; no concrete actions like "designs architecture" or "evaluates trade-offs" are listed, matching the level-2 anchor rather than the multi-action level-3 example.

2 / 3

Completeness

It states both what ("System architect and technical design leader") and when ("Use when the user asks to talk to Winston or requests the architect"), mirroring the level-3 anchor that requires explicit both-what-and-when triggers.

3 / 3

Trigger Term Quality

"asks to talk to Winston or requests the architect" uses the natural phrasings a user of this system would actually say, giving good coverage of trigger terms; it is above level 2 because the terms are concrete and user-natural rather than jargon.

3 / 3

Distinctiveness Conflict Risk

The named persona "Winston" plus the specific "architect" role carve a clear niche with distinct triggers unlikely to fire for unrelated skills, matching the level-3 anchor.

3 / 3

Total

11

/

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.