| name | skill-authoring |
| description | Write Agent Skills that comply with the agentskills.io specification. WHEN: "create a skill", "new skill", "write a skill", "skill template", "skill structure", "review skill", "skill PR", "skill compliance", "SKILL.md format", "skill frontmatter", "skill best practices". DO NOT USE FOR: improving existing skills (use sensei), general documentation. INVOKES: waza CLI. |
| license | MIT |
| metadata | {"author":"Microsoft","version":"1.0.0"} |
| compatibility | copilot-chat |
Skill Authoring Guide
Constraints
name: 1-64 chars, lowercase + hyphens, match directorydescription: inline double-quoted, ≤60 words, ≤1024 chars- Use
WHEN: with quoted trigger phrases (preferred over USE FOR:)
- SKILL.md: <500 tokens (soft), <5000 (hard)
- references/*.md: <1000 tokens each
Structure
SKILL.md (required) — Frontmatter + instructionsreferences/ (optional) — Detailed docs, loaded on demandscripts/ (optional) — Executable code
Progressive Disclosure
Metadata loads at startup. SKILL.md on activation. References load when linked via [text](references/file.md).
MCP Tools
| Tool | Purpose |
|---|
| None | CLI-only; uses local file tools |
CLI fallback: Primary mode is CLI-based. No MCP servers required.
Quick Start
- Create skill directory with
SKILL.md
- Add frontmatter:
name, description, license
- Run
waza check {skill-name} to validate
Examples
- "Create a new skill for code review"
- "Review my skill for compliance"
Troubleshooting
If waza check reports broken links, verify reference file paths match exactly.
References
