skill - Skill specification and implementation guide
Guide agents in authoring, validating, and using skills, including SKILL.md metadata, directory structure, progressive disclosure, and tooling.
Tags
Updated: 2026-10-03Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Explain skill specifications
- Write SKILL.md files
- Validate frontmatter metadata
- Organize skill directories
- Apply progressive disclosure
- Use skills-ref tooling
Inputs
- Skill source content
- Skill directory paths
- Specification requirements
- Validation targets
Outputs
- Authoring guidance
- Validation results
- Directory structure guidance
- Skill architecture guidance
Requirements
- Claude Code, skills-ref CLI, or compatible agent
- Python 3.9+ for skills-ref validation
- Go 1.21+ for boxxy rendering
- Approved Read and Bash tool access