The Agent Skills Playbook

Teach Your AI Agents New Skills

The definitive resource for building structured, reusable skills for AI coding agents. From your first skill file to enterprise deployment — for Claude Code, Cursor, Windsurf, Copilot, Codex, Gemini, and any agent that follows instructions.

agent-skills
$ cat commit-msg/SKILL.md
---
description: Generate a conventional commit message
allowed-tools: Bash(git diff), Bash(git log)
---
# Commit Message Generator
Analyze staged changes and produce a commit...
$ _

Anatomy of a Skill

Every skill starts with a simple Markdown file — metadata up top, instructions below. Here's what one looks like:

commit-msg/SKILL.md
---
description: Generate a conventional commit message
allowed-tools: Bash(git diff), Bash(git log)
---

# Commit Message Generator

Analyze staged changes and produce a commit message.

## Steps
1. Run `git diff --cached` to see staged changes
2. Run `git log --oneline -5` for recent style
3. Write a conventional commit: type(scope): description
4. Keep the subject under 72 characters

## Rules
- Use present tense ("add" not "added")
- Reference issue numbers when obvious from branch name
📚
18
Lessons
🔧
26
Real Examples
🎮
1
Interactive Playground
📋
3
Quick Reference Pages

Ready to become a Skills Ninja?

Start with the fundamentals and work your way up to enterprise deployment patterns.

Begin Your Journey