CtrlK
BlogDocsLog inGet started
Tessl Logo

validate-story-draft

Alias for /aiox-validate-story-draft. Use when the user runs /validate-story-draft or mentions validate-story-draft.

60

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./.grok/skills/validate-story-draft/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 a lean, well-structured alias skill that delegates cleanly to a canonical source-of-truth file with concrete fallback commands. It is appropriately concise and organized for a simple single-purpose skill.

DimensionReasoningScore

Conciseness

Three terse numbered steps with no padding and no over-explanation of concepts Claude already knows; every token earns its place, matching the lean-and-efficient anchor.

5 / 5

Actionability

Concrete, executable guidance (specific file path and the exact 'npm run sync:skills:grok' command) with a clear guardrail; minor gap is the absence of an explicit fallback path if regen itself fails.

4 / 5

Workflow Clarity

A clear, unambiguous three-step sequence with an explicit source-of-truth guard; for a simple alias skill this is well-sequenced, though it lacks a validation checkpoint for the fallback-regeneration branch.

4 / 5

Progressive Disclosure

Under 50 lines with well-organized sections and a single clearly-signaled one-level-deep pointer to the canonical skill file; no external bundle files are needed, satisfying the simple-skill exception.

5 / 5

Total

18

/

20

Passed

Description

55%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 a clean, concise alias declaration with an explicit 'Use when' trigger, but it describes only the alias relationship rather than the underlying capability, limiting specificity and trigger-term richness.

Suggestions

Add one concrete capability line so the description conveys what validate-story-draft actually does (e.g., 'Validates story drafts against the AIOX story schema').

Broaden trigger terms with synonyms such as 'story draft validation' or 'check story draft' beyond the bare skill name.

DimensionReasoningScore

Specificity

The description declares it is an 'Alias for /aiox-validate-story-draft' but names no concrete capability (e.g., validate or check story drafts); it only references the domain, matching the anchor for naming the domain with minimal actions.

2 / 5

Completeness

It provides both a 'what' (alias for the named skill) and an explicit 'Use when the user runs /validate-story-draft or mentions validate-story-draft' clause; the 'what' is meta rather than describing the underlying capability, so it stops just short of fully explicit.

4 / 5

Trigger Term Quality

It includes the natural trigger 'validate-story-draft' and '/validate-story-draft', but offers no synonyms or variations such as 'story draft validation' or 'draft checking', matching the anchor for some relevant keywords missing common variations.

3 / 5

Distinctiveness Conflict Risk

The trigger is tied to a specific skill name, giving a clear niche with minimal conflict risk, though inherent overlap exists with its canonical target aiox-validate-story-draft.

4 / 5

Total

13

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

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.