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

87%

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

85%

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

A tightly written, well-structured protocol with explicit quality gates and verification checklists; its main gap is actionability, since the actual develop-task execution lives in an external file not provided in the bundle.

Suggestions

Inline a minimal concrete outline of what the OSS develop task performs (or confirm the referenced task file ships in the bundle) so the skill is self-contained and copy-paste-ready.

Replace the abstract directive 'REUSE > ADAPT > CREATE; absolute imports; Quality First gates' with one concrete example of each to raise actionability.

Clarify how to obtain/verify the referenced '.aiox-core/development/tasks/dev-develop-story.md' path and the 'ARCH-A denylist' so the references are resolvable.

Dimension	Reasoning	Score
Conciseness	Extremely lean ('Lean SDC skill. Task is source of truth.') with no concept explanations; every line earns its place and it assumes Claude's competence throughout.	3 / 3
Actionability	Concrete commands exist ('npm run lint', 'npm run typecheck', 'npm test', 'feat/{story-id}-*'), but the core task work is delegated to an external file '.aiox-core/development/tasks/dev-develop-story.md' that is not present in the bundle, leaving the primary execution guidance incomplete and non-copy-paste-ready.	2 / 3
Workflow Clarity	An 8-step numbered Protocol is followed by an explicit 'Quality gates before done' command block and a 'Post-phase verification' checklist, providing clear sequencing with validation checkpoints.	3 / 3
Progressive Disclosure	Under 50 lines with a single task and well-organized sections (Task SOT, Input, Protocol, Quality gates, Post-phase verification, Forbidden); no bundle files exist, and the body contains no nested/deep references, so the simple-skill bar is met.	3 / 3
	Total	11 / 12 Passed

Description

90%

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 with an explicit 'Use when' trigger clause and strong, distinctive trigger terms; the only weakness is that the capability statement is slightly abstract compared to listing many concrete actions.

Dimension	Reasoning	Score
Specificity	Names the domain and several concrete actions ('Implement a story', 'Runs the OSS develop task', 'Ready → InProgress → ready for review'), but 'implement a story' is somewhat abstract and the action list is less comprehensive than the anchor-3 'extract/fill/merge' example.	2 / 3
Completeness	Explicitly answers both what ('Implement a story... Runs the OSS develop task') and when ('Use when: develop story, *develop, /develop-story, implement ACs'), satisfying the anchor-3 bar for an explicit trigger clause.	3 / 3
Trigger Term Quality	'Use when: develop story, *develop, /develop-story, implement ACs' gives good coverage of natural terms including a slash-command, a wildcard alias, and a plain phrase a user would actually say.	3 / 3
Distinctiveness Conflict Risk	The story-development niche ('develop story', '/develop-story', 'implement ACs', 'OSS develop task') has distinct triggers unlikely to fire for unrelated skills.	3 / 3
	Total	11 / 12 Passed

Validation

87%

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 — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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
Path: .grok/skills/aiox-develop-story/SKILL.md
Commit: 0b32b68

Reviewed: about 14 hours 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.