Building Agent Skills

Help users build clean, discoverable skills that work across Claude Code, Codex, Amp, and OpenCode.

Official Spec

Fetch from https://agentskills.io/specification for YAML frontmatter, file format, and client integration details.

Minimal Structure

my-skill/
  SKILL.md           # Required (<500 lines)
  references/        # Optional: detailed docs
  scripts/           # Optional: executable utilities

SKILL.md Essentials

---
name: my-skill
description: >
  What it does. Include trigger phrases so AI knows when to activate.
---

# Title

## When to Use
- Trigger condition 1
- Trigger condition 2

## Quick Reference
[Tables, common commands]

## Detailed Docs
See [references/](references/) for full documentation.

References

| Topic | File | |-------|------| | Full SKILL.md template | format.md | | Adding scripts | scripts.md | | Safety/auth/trigger patterns | patterns.md | | Installation paths | installation.md | | Distribution (git/CLI/plugin) | distribution.md | | Plugin/marketplace structure | plugin-structure.md | | Production examples | real-examples.md |