What problem does it solve? Agent skills often fail because of poorly written frontmatter descriptions that cause under-triggering or over-triggering, and bloated SKILL.md bodies that agents ignore. This Skill diagnoses and fixes both problems by treating frontmatter optimization and body content optimization as separate, composable concerns. ## Core Features & Use Cases - Spec Validation: Runs validate_skill.py to check a skill directory against the agentskills.io specification, reporting errors (missing fields, bad naming, cross-skill references) separately from quality warnings. - Body Analysis: Runs analyze_skill_body.py to detect oversized sections, deterministic instructions that should become scripts, and content that belongs in reference files. - Frontmatter Rewriting: Improves descriptions with explicit trigger phrases and negative boundaries to fix triggering accuracy. - Use Case: A user has a skill whose description is "A tool for classifying support tickets" that triggers on unrelated prompts. This Skill validates it, rewrites the description with explicit "Use this whenever" triggers and negative boundaries, then re-validates the result. ## Quick Start Ask the agent to validate and improve the skill at skills/my-skill/ by fixing its triggering description and restructuring its bloated SKILL.md body.
