skill-authoring
Installation
Summary
Guidelines and validation for writing Agent Skills compliant with agentskills.io specification.
- Covers skill structure (SKILL.md, references/, scripts/), frontmatter constraints (name format, description limits), and token budgets (SKILL.md <5000 tokens, references <1000 each)
- Enforces metadata best practices: use
WHEN:trigger phrases in descriptions, avoidDO NOT USE FOR:keywords, keep descriptions under 60 words - Implements progressive disclosure with just-in-time reference loading: only explicitly linked files load on activation, not on startup
- Includes validation tools (npm scripts) for checking broken links, token limits, and orphaned references before submission
SKILL.md
Skill Authoring Guide
This skill provides guidance for writing Agent Skills that comply with the agentskills.io specification.
When to Use
- Creating a new skill for this repository
- Reviewing a skill PR for compliance
- Checking if an existing skill follows best practices
- Understanding token budgets and progressive disclosure