CtrlK
BlogDocsLog inGet started
Tessl Logo

bmad-preview-ticketing

Create and manage tickets at every level — slice an initiative into epics, break an epic into stories, write or refine a ticket, and run the board (publish, ready, move, assign, status, cancel). Use when the user says "Create a new initiative", "slice this", "split this up", "break this into stories", "incept this epic", "make a ticket", "refine this ticket", "what's ready", "status of a story", "publish ticket changes".

74

Quality

93%

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

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

A dense, well-engineered skill body: fully executable commands with fallbacks, a clean intent-to-reference routing table, and proper progressive disclosure across verified bundle files. Its weaknesses are moderate compression — the ticket-tree section packs many rules into long paragraphs and repeats some state-mapping rules already given in Terms — and validation checkpoints that are mandated but deferred to reference files rather than shown inline.

Suggestions

Consolidate the ticket state/status derivation rules that currently appear in both 'Terms' (State) and 'The ticket tree' into one place, pointing the other at it, to cut redundant tokens.

At the publish/autonomous-mode step, inline one line naming the validate-fix-retry loop (e.g. 'validate.md: check, fix, re-check until clean') so the feedback loop is visible where the action is decided.

Break the long single paragraph under 'The ticket tree' (file/folder naming, plan fields, status ownership) into a few labeled subsections or a small table so a reader can jump to the rule it needs without re-parsing the whole block.

DimensionReasoningScore

Conciseness

The body is lean — no padding, no explanations of concepts Claude already knows, every sentence carries specifics (commands, file names, status mappings). It falls short of the 5 anchor because state/status derivation and entry/pull lifecycle rules are stated in both 'Terms' and 'The ticket tree', and a few dense sentences could be trimmed or consolidated without losing information.

4 / 5

Actionability

Concrete, executable commands are given verbatim: 'uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key core.output_folder --key modules.bmm.active_initiative', 'uv run {skill-root}/scripts/read_toml.py --file ... -k tickets', 'tickets.py find <dir> <ref>', 'tickets.py mark', 'tickets.py pull'. The routing table maps each user intent to a specific reference file, and the activation sequence specifies fallback behavior for each failure mode (script not found, store config unreadable). This matches the 5 anchor: copy-paste-ready commands covering the common cases; remaining details are deliberately delegated via the routing table rather than missing.

5 / 5

Workflow Clarity

Activation is a clear numbered 5-step sequence with explicit error-recovery fallbacks, intake paths are sized and routed, and validation is mandated ('The check on a draft in validate.md always runs', 'still get a yes to publish') — an explicit publish gate. It stops short of the 5 anchor because the validate-fix-retry feedback loop itself lives in validate.md rather than being shown at the point of action, so checkpoints are referenced rather than inlined; this is a minor validation gap, not the absence that would cap at 3.

4 / 5

Progressive Disclosure

The SKILL.md is a genuine overview plus routing: a 7-row table maps user intents to '{skill-root}/references/<file>.md', all of which exist as real files, customization keys and store verbs are resolved by script and loaded on demand, and templates live in assets/. References are one level deep, clearly signaled, and nothing that belongs in a reference is inlined at length. This matches the 5 anchor ('clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

18

/

20

Passed

Description

96%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: it enumerates concrete capabilities at every ticket altitude, uses an explicit 'Use when the user says' trigger clause with ten natural quoted phrases including synonyms, and establishes a distinctive BMad vocabulary. The only weakness is minor overlap risk between generic ticket phrases and adjacent project-management skills.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions with comprehensive coverage: 'slice an initiative into epics, break an epic into stories, write or refine a ticket, and run the board (publish, ready, move, assign, status, cancel)' — both the creation and management sides of the domain are enumerated. This matches the 5 anchor ('lists multiple specific concrete actions; comprehensive coverage') and exceeds the 4 anchor, which would imply coverage gaps.

5 / 5

Completeness

It explicitly answers both 'what' (create and manage tickets at every level, with enumerated operations) and 'when' ('Use when the user says' followed by concrete trigger phrases). This matches the 5 anchor exactly ('clearly and explicitly answers both what AND when with concrete trigger phrases'); the 4 anchor applies when the 'when' clause is present but less explicit.

5 / 5

Trigger Term Quality

Ten quoted natural phrases a user would actually say — 'Create a new initiative', 'slice this', 'split this up', 'break this into stories', 'incept this epic', 'make a ticket', 'refine this ticket', 'what's ready', 'status of a story', 'publish ticket changes' — covering synonyms ('slice/split/break') and question forms. This is comprehensive natural-term coverage, matching the 5 anchor; anchor 4 would require 'a few natural terms missing', which is not the case.

5 / 5

Distinctiveness Conflict Risk

The initiative/epic/story hierarchy and terms like 'incept this epic' give it a clear BMad niche, but generic phrases like 'make a ticket', 'refine this ticket', and 'status of a story' could overlap with a general issue-tracker or project-management skill. This fits the 4 anchor ('mostly distinct; minor overlap risk with closely related skills') better than the 5 anchor's 'minimal conflict risk'.

4 / 5

Total

19

/

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