develop-story

Implement a story (Ready → InProgress → ready for review). Runs the OSS develop task. Use when: develop story, *develop, /develop-story, implement ACs.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

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.

The body is an exemplar of lean, well-structured instruction-only skill content with concrete gates and a verification checklist. The only notable gap is that the main execution detail lives in an external task file and the gate-failure retry loop is implied rather than explicit.

Suggestions

Add an explicit feedback loop after the quality gates (e.g., 'If lint/typecheck/test fail: fix and re-run until green before marking tasks [x]') to make the retry path unambiguous.

Briefly note what the develop task file covers (one line) so the reader can gauge whether to load it before committing to the protocol.

Confirm the referenced task path '.aiox-core/development/tasks/dev-develop-story.md' is bundled or resolvable; if it lives outside the skill, surface that dependency explicitly.

Dimension	Reasoning	Score
Conciseness	Lean and efficient with no over-explanation of concepts Claude already knows; every line earns its place ('REUSE > ADAPT > CREATE', 'Local commits only. Push → @devops').	5 / 5
Actionability	Concrete executable guidance for branch naming, quality gates, and edit allowlists, but the core execution is delegated to an external task file not shown here.	4 / 5
Workflow Clarity	Clear numbered sequence with quality gates and a verification checklist, but the gate-failure feedback loop (run → fix → rerun) is implicit rather than spelled out.	4 / 5
Progressive Disclosure	Well-organized sections under 50 lines with a single clearly-signaled one-level reference to the task source-of-truth file; no nested references.	5 / 5
	Total	18 / 20 Passed

Description

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

The description is concise, third-person, and clearly answers both what the skill does and when to use it with explicit trigger phrases. The main weakness is the wildcard '*develop' alias, which introduces some overlap risk with generic development requests.

Dimension	Reasoning	Score
Specificity	Names the story-development domain and a couple of concrete actions ('Implement a story', 'implement ACs') with status transitions, but coverage is not comprehensive.	3 / 5
Completeness	Explicitly answers both 'what' (implement a story through status transitions, runs the OSS develop task) and 'when' via a concrete 'Use when:' clause with trigger phrases.	5 / 5
Trigger Term Quality	Includes natural trigger phrases a user would say ('develop story', 'implement ACs') plus slash/wildcard aliases, though it lacks common synonyms and 'ACs' is jargon.	4 / 5
Distinctiveness Conflict Risk	Mostly distinct niche triggers ('/develop-story', 'implement ACs') with minor overlap risk from the broad wildcard '*develop'.	4 / 5
	Total	16 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: SynkraAI/aiox-core
Path: .aiox-core/development/skills/develop-story/SKILL.md
Commit: 4ef6530

Reviewed: 22 days ago

Table of Contents

Discovery Implementation Validation

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.