aiox-dev

Activate Dex (dev) for Full Stack Developer. Use for code implementation, debugging, refactoring, and development best practices

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/AIOX/agents/dev/SKILL.md

Quality

Content

50%

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

A detailed agent-activation skill with concrete commands and validation feedback loops, weakened by heavy command duplication, an oversized inline YAML config block, and reliance on external workflow files not shipped in the bundle.

Suggestions

Remove the duplication between the Star Commands table, the YAML 'commands' block, and the Quick Commands section — keep one canonical command listing.

Move the full agent YAML definition into a bundled reference file and have SKILL.md act as an overview pointing to it, improving both conciseness and progressive disclosure.

Inline the essential develop-story workflow steps (or ship dev-develop-story.md in the bundle) so the core task is executable from the skill alone without missing dependency files.

Dimension	Reasoning	Score
Conciseness	Mostly operational config Claude would not already know, but the command set is duplicated across three sections (Star Commands table, YAML commands block, Quick Commands) and the CodeRabbit/decision-logging prose with conceptual JS examples could be tightened.	2 / 3
Actionability	Provides concrete commands and file paths, but the core development workflow is delegated to external dependency files (dev-develop-story.md, etc.) absent from the bundle, and the decision-logging example is pseudocode rather than executable code.	2 / 3
Workflow Clarity	A sequence with validation checkpoints and a self-healing feedback loop is present (develop-story order-of-execution, CodeRabbit validate->fix->retry), but the primary multi-step dev workflow is offloaded to an external file not in the bundle, leaving the in-skill sequence incomplete.	2 / 3
Progressive Disclosure	Sections are organized, but the entire full agent definition is embedded as one monolithic inline YAML block (content that should be a separate reference file), and no bundle files exist to support an overview->detail split.	2 / 3
	Total	8 / 12 Passed

Description

92%

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 with explicit 'what' and 'when' clauses and natural trigger phrases; the main weakness is the broad 'development best practices' scope that could overlap with other dev-oriented skills.

Suggestions

Tighten the capability scope or add a distinguishing qualifier so it does not overlap with generic coding skills (e.g., name the AIOX story-driven workflow as the distinctive context).

Fix the missing period/sentence break between 'development best practices' and 'Trigger when' for cleaner readability.

Dimension	Reasoning	Score
Specificity	Names multiple concrete actions — 'code implementation, debugging, refactoring' — rather than vague language, matching the anchor that lists several specific actions.	3 / 3
Completeness	Explicitly answers both what ('Activate the AIOX Full Stack Developer agent... code implementation, debugging, refactoring') and when ('Trigger when user asks to dev...'), with an explicit trigger clause.	3 / 3
Trigger Term Quality	Includes natural phrases a user would say ('activate dev', 'switch to dev', '@dev', 'asks to dev'), giving good coverage of natural trigger terms.	3 / 3
Distinctiveness Conflict Risk	The activation triggers are distinct, but the capability list ('code implementation, debugging, refactoring, and development best practices') is broad and would overlap with generic coding skills, so it is not a clear conflict-free niche.	2 / 3
	Total	11 / 12 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
skill_md_line_count	SKILL.md is long (657 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: SynkraAI/aiox-core
Path: .claude/skills/AIOX/agents/dev/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.