Opinionated guide to building Agent Skills for any agent, covering layout, frontmatter, descriptions, and Claude Code specifics.
24 installs
Coding
Agent Skills
Try itAgent Skills standard reference guide. Covers SKILL.md specification format, progressive loading, skill discovery and activation, authoring best practices, quality evaluation, description optimization
What it does
Agent Skills standard reference guide. Covers SKILL.md specification format, progressive loading, skill discovery and activation, authoring best practices, quality evaluation, description optimization, and more.
The skill document
Agent Skills Standard
A standardized way to equip AI Agents with new capabilities and domain expertise. Adopted by 35+ Agent products.
Use Cases
Use when creating new skills, validating skill formats, optimizing existing skills, or learning about standardized skill system design.
Reference File Routing
| Need | Read |
|---|---|
| Quick skill creation (5-step guide) | quick-start.md |
| SKILL.md format spec + Agent integration | spec.md |
| Authoring best practices + quality eval + description optimization | authoring.md |
| Common anti-patterns and fixes | anti-patterns.md |
| Script binding and design | using-scripts.md |
| Supported product list | products.md |
Minimal Example
---
name: pdf-processing
description: Extract PDF text, fill forms, merge files. Use when handling PDFs.
---
## Workflow
1. Extract: `python scripts/extract.py input.pdf`
2. Fill: `python scripts/fill.py template.pdf data.json`
## Gotchas
- Scanned PDFs need OCR first — use `scripts/ocr.py`
Validation
skills-ref validate ./my-skill
Related skills
Generate Skill skeleton code, SKILL.md, and reference materials following best practices
2 installs
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
3 installs1 stars
Agent skill recommender. Input a user need, task description, or existing skill list; output best matching skills, install rationale, duplicate/merge candida...
37 installs
Update installed agent skills with diff preview, backup, and rollback before any change is applied.
93 installs6 stars
Use when asked to review, edit, tighten, shorten, deduplicate, clean up, or remove slop from an existing agent skill while preserving behavior. Use for skill...
1 installs