What problem does it solve? Authoring a SKILL.md that agents actually discover and trigger correctly is hard: frontmatter rules, naming constraints, token budgets, and description-writing pitfalls are scattered across the agentskills.io spec. This Skill condenses the full Agent Skills format specification into one reference so you can write, review, and debug skills without hunting through documentation. ## Core Features & Use Cases - Frontmatter reference: Complete rules for required fields (name, description) and optional fields (license, compatibility, metadata, allowed-tools), including naming constraints and character limits. - Progressive disclosure guidance: Explains the three-stage token budget (discovery, activation, on-demand resources) and when to move content into scripts/, references/, or assets/ directories. - Description optimization and testing: Covers trigger-rate evaluation loops, should-trigger vs near-miss prompt design, and a pre-publish checklist with the skills-ref validator. - Use Case: You are writing a new skill for Claude Code and your agent never activates it. Use this Skill to check your description against the optimizing-descriptions rules, verify your name matches the directory, and run the validation workflow. ## Quick Start Ask the agent to review your SKILL.md frontmatter and description against the Agent Skills specification and suggest fixes for triggering issues.
