Agent Skills (SKILL.md)
Teach your agent custom skills with SKILL.md files — turn team expertise into permanent agent capabilities.
Overview
The magic is progressive disclosure: the agent initially reads only each skill name and description, and loads the full instructions plus any bundled scripts or templates only when a task matches. You can add dozens of skills without burning context.
Skills are shared with the team inside the repo (.claude/skills/) or personally (~/.claude/skills/), and have become the fastest way to convert tacit team knowledge into consistent agent behavior.
Who Is This For?
- Teams standardizing how recurring tasks are executed across agents
- Turning internal procedures (reports, deploys, reviews) into automatic capabilities
- Sharing senior-engineer expertise with every agent user
- Building a company skill library maintained in one place
Installation
mkdir -p ~/.claude/skills/my-skill
# Create SKILL.md inside with YAML frontmatter (name, description) + instructions. Project-level: .claude/skills/ Configuration
---
name: pdf-reports
description: Generate branded PDF reports from data. Use when asked for a PDF report.
---
Steps the agent should follow... Explore AI Tools
Discover the best AI tools that complement your skills
Read AI & Design Articles
Tips and trends in the world of design and AI
Related Servers
Markdown Documentation Generator
Auto-generate structured project documentation from your codebase. AI agents can produce API references, guides, and architecture docs.
OpenAPI Documentation
Generate interactive API documentation from OpenAPI and Swagger specifications. Keep your API docs always up to date with your endpoints.
README Generator
Create comprehensive, well-structured project READMEs that cover installation, usage, configuration, and contribution guidelines.