CtrlK
BlogDocsLog inGet started
Tessl Logo

aiox-review-story

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

72

Quality

90%

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

The canonical home for this skill is review-story in SynkraAI/aiox-core

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.

A well-structured, lean QA-gate skill with explicit checkpoints, a feedback loop, and clean delegation to authoritative task files. The only gap is that the substantive review procedure lives in referenced files rather than inline, leaving actionability slightly dependent on external content.

DimensionReasoningScore

Conciseness

Lean instruction-only body with no padding or explanation of concepts Claude already knows; every line is an instruction, pointer, or checkpoint, assuming Claude's competence.

5 / 5

Actionability

Concrete guidance is present — specific paths ('docs/qa/gates/'), file names ('qa-gate.md'), verdict values, and lifecycle transitions — but the core review procedure is delegated to an external task file rather than fully specified inline.

4 / 5

Workflow Clarity

A numbered protocol, a verdict→status-action table, and an explicit 'Post-phase verification' checklist provide a clear sequence with validation checkpoints and a FAIL→InProgress feedback loop.

5 / 5

Progressive Disclosure

A clear overview that delegates authoritative detail to well-signaled one-level-deep references (primary 'qa-gate.md', supporting 'qa-review-story.md', lifecycle rules), with content appropriately split and easy to navigate.

5 / 5

Total

19

/

20

Passed

Description

87%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 concise, third-person description that clearly states both the skill's purpose and explicit trigger conditions, with dedicated slash-command and glob triggers reducing conflict risk. Minor room to broaden trigger synonyms.

DimensionReasoningScore

Specificity

Lists several concrete actions — 'verdict PASS/CONCERNS/FAIL/WAIVED + lifecycle transition' — naming the domain and its concrete outputs, though coverage of the full review action set is delegated rather than comprehensive.

4 / 5

Completeness

Explicitly answers both what ('QA gate for a story — verdict ... + lifecycle transition') and when (concrete 'Use when:' triggers), matching the score-5 anchor for both.

5 / 5

Trigger Term Quality

'Use when: review story, qa gate, *qa-gate, /review-story' provides good keyword coverage including the natural phrase, a glob, and the slash-command trigger, though it lacks broader synonyms.

4 / 5

Distinctiveness Conflict Risk

'QA gate for a story' with a dedicated '/review-story' trigger carves a clear niche with minimal overlap risk against other skills.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

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.