CtrlK
BlogDocsLog inGet started
Tessl Logo

bmad-editorial-review-structure

Deprecated — forwards to bmad-review

51

Quality

56%

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/core-skills/v6-shims/bmad-editorial-review-structure/SKILL.md
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 content is a lean, highly actionable shim that precisely delegates to bmad-review with the right lens, inputs, legacy report shape, and an exact no-findings fallback. It is exemplary for a deprecation/forwarding skill.

DimensionReasoningScore

Conciseness

The single delegation paragraph is efficient and assumes Claude's competence, specifying the lens, inputs, and exact output shape without explaining concepts Claude already knows; only minor wording could be tightened, matching the efficient-with-minor-trim anchor.

4 / 5

Actionability

It gives fully executable, copy-paste-ready guidance: which skill to invoke, which lens ("structure"), what inputs to pass through, the exact legacy report sections to emit, and the exact fallback string when no issues are found.

5 / 5

Workflow Clarity

As a simple single-purpose delegation, the one action is unambiguous and includes an explicit edge-case branch ("If no structural issues are found, output exactly: ..."), satisfying the simple-skill exception for a clear workflow with an explicit checkpoint.

5 / 5

Progressive Disclosure

The body is a short, well-organized single paragraph with no nested or buried references and no bundle files to navigate; per the simple-skill note, an under-50-line skill with no external references and clean inline organization scores 5.

5 / 5

Total

19

/

20

Passed

Description

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

This is a deprecated shim whose description communicates deprecation and forwarding but provides no concrete capability statement, natural trigger terms, or use-when guidance. It is minimally functional as a forwarding pointer but weak as a discoverable skill description.

Suggestions

Add a "Use when..." clause naming the natural trigger (e.g., "Use when performing BMAD editorial structure review") so users discover it for that task.

Describe the concrete capability in third person instead of only the deprecation status (e.g., "Reviews document structure for BMAD editorial workflows; deprecated, forwards to bmad-review").

Include the natural keyword variations users would say ("editorial review", "structure review", "BMAD") to improve trigger term coverage.

DimensionReasoningScore

Specificity

The description "Deprecated — forwards to bmad-review" names the domain (a deprecation shim) and a single minimal action (forwards), matching the anchor that names the domain but offers only minimal/generic actions; it falls short of listing concrete capabilities (3) and is not entirely vague (1).

2 / 5

Completeness

It gives a vague "what" (forwards to another skill) with no "when" guidance, matching the anchor for a vague what and absent when; the missing explicit trigger guidance also caps it well below a strong what-and-when entry.

2 / 5

Trigger Term Quality

It contains no natural trigger phrases a user would say — only technical jargon ("Deprecated", "forwards to bmad-review") — matching the anchor for no natural keywords and only technical jargon.

1 / 5

Distinctiveness Conflict Risk

Naming a specific target (bmad-review) makes it somewhat distinct, but the description itself signals no real capability and the "editorial-review-structure" framing overlaps conceptually with bmad-review's lenses, so overlap risk remains.

3 / 5

Total

8

/

20

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

metadata_version

'metadata.version' is 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.