CtrlK
BlogDocsLog inGet started
Tessl Logo

review-story

QA gate for a story — verdict PASS/CONCERNS/FAIL/WAIVED + lifecycle transition. Use when: review story, qa gate, *qa-gate, /review-story.

69

Quality

85%

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

85%

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

A token-efficient, well-structured skill body with a clear sequenced protocol and explicit verification checkpoints. Its main gap is actionability: the executable review detail lives in external task files rather than in the skill itself.

Suggestions

Inline a minimal, concrete gate-file template or schema snippet so the skill is actionable without first loading the external qa-gate.md task file.

Add one short concrete example of a gate-file write (e.g. a filename pattern and the minimum fields expected) to lift actionability toward fully executable guidance.

DimensionReasoningScore

Conciseness

The body is lean ('Lean SDC skill. Task is source of truth for gate schema and review depth.'), assumes Claude's competence, and never explains concepts Claude already knows; every token earns its place.

3 / 3

Actionability

It gives concrete paths ('docs/qa/gates/', 'qa-gate.md') and a verdict-to-status mapping table, but the actual review execution and gate-file schema are delegated to external task files, leaving it incomplete as standalone guidance.

2 / 3

Workflow Clarity

A numbered 5-step Protocol is paired with a 'Post-phase verification' checklist providing explicit checkpoints (gate file on disk, QA Results updated, correct status set), matching the anchor for a clear sequence with validation steps.

3 / 3

Progressive Disclosure

A compact, well-organized body with clearly labeled Primary/Supporting task-file references that are one level deep and clearly signaled, with no nested reference chains.

3 / 3

Total

11

/

12

Passed

Description

85%

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 concise, specific description that clearly states both what the skill does and when to use it, with a distinct QA-gating niche. Trigger term quality is the weakest dimension: it leans on slash-command syntax and omits common natural-language variations.

Suggestions

Broaden the 'Use when' clause with natural-language variations a user might actually say, e.g. 'story QA', 'quality gate', 'review a story', rather than relying on '*qa-gate' and '/review-story' invocation syntax.

DimensionReasoningScore

Specificity

Names a concrete capability (QA gate) and enumerates specific outputs ('verdict PASS/CONCERNS/FAIL/WAIVED + lifecycle transition') rather than vague language, matching the anchor that lists multiple specific concrete actions.

3 / 3

Completeness

Explicitly states what it does ('QA gate for a story — verdict... + lifecycle transition') and when to use it ('Use when: review story, qa gate...'), answering both what and when with an explicit trigger clause.

3 / 3

Trigger Term Quality

Includes some relevant natural terms ('review story', 'qa gate') but mixes in invocation syntax ('*qa-gate', '/review-story') and misses common variations like 'story QA' or 'quality gate', so coverage is partial.

2 / 3

Distinctiveness Conflict Risk

'QA gate for a story' is a clear, narrow niche with distinct triggers tied to story QA gating, making it unlikely to fire for unrelated skills.

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
SynkraAI/aiox-core
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.