Skill Crossroads api-design
rubric v1.2 · deterministic
A− 90.9/100 overall
Correctness & Structure 100 pass
Triggering & Discoverability 100 pass
Clarity & Instructions 100 pass
Token & Context Cost 81 2 warn
Safety & Security 89 1 warn
Verifiability & Maintainability 53 1 fail

Top fixes — ranked by score impact

VERIFY-01 Evals or tests present
skill.md:1the skill works no evals/, tests/, or verification section found
No way to prove the skill does what it claims.
Fix Add an evals/ folder (test prompts + expected outcomes) and a '## Verify' step in the body.
SAFETY-03 No destructive auto-invocation
skill.md:30auto-invocable (no disable-model-invocation) performs a destructive action ("DELETE")
Skill appears to "DELETE" but the model can auto-invoke it — a destructive action could fire without the user asking.
DELETE
Fix If this action is destructive/irreversible, set `disable-model-invocation: true` so it only runs when explicitly invoked.
TOKEN-01 Body under line/token budget
skill.md500-line guidance 533 lines
SKILL.md is 533 lines — over the ~500-line guidance. ~4,773 tokens (rough est.); ~$0.0143 per load at $3/Mtok reference rate.
Fix Move heavy reference material into supporting files and link to them (progressive disclosure), keeping SKILL.md lean.
TOKEN-02 Progressive disclosure
skill.mdeverything inlined in SKILL.md 529 body lines, 0 supporting files
Large SKILL.md (529 lines) with no supporting files — all of it loads every time the skill fires.
Fix Move heavy reference material into supporting files and link to them, so the model loads it only when needed.
★ scores higher than ≈30% of 208 public skills (deterministic rubric v1.2 sample, 2026-09)

Embed this badge

Skill Crossroads grade A− Always-fresh — it re-scans and updates on its own.
[![Skill Crossroads](https://skillcrossroads.com/api/badge/kid-sid/claude-spellbook/skills/api-design.svg)](https://skillcrossroads.com/s/kid-sid/claude-spellbook/skills/api-design)
Grade your own Claude Code skill — evidence-cited, file-and-line, free. Scan your own skill →