skill-improverlisted

# Skill Improver Audit and improve skills to match the Anthropic skill guide standard. ## When to activate - User wants to create a new skill - User wants to improve an existing skill - Preparing a skill for ClawHub or external distribution - After `atris skill audit` reports warnings or failures ## The standard A well-formed skill has: 1. YAML frontmatter with `name` (kebab-case, matches folder), `description` (WHAT + WHEN + triggers, under 1024 chars), `version` (semver), `tags` 2. No XML tags anywhere in the file 3. Clear numbered instructions with concrete steps 4. Error handling guidance 5. Examples of input and expected output 6. Under 5000 words in SKILL.md (move detail to `references/` subdirectory) ## Audit process 1. Run `atris skill audit [name]` for mechanical checks (12 automated checks) 2. Read the SKILL.md for qualitative issues: - Is the description specific enough to trigger correctly? - Do instructions have concrete steps, not vague guidance? - Are there before/after examples? - Is error handling covered? - Would a new agent understand this without extra context? 3. Score: mechanical (CLI) + qualitative (your judgment) ## Fixing common problems ### Weak descriptions Bad: "Essay writing skill. Triggers on: essay, draft" Good: "Structured essay writing with approval gates at each stage (inbox, outline, panel, write, passes). Use when writing essays, drafts, outlines, or long-form content. Triggers on essay, draft, write, outline, or