Skill Creator Guide: Build AI Agent Skills

What This Skill Does

Guide for creating and updating AI agent skills — structured packages of knowledge, workflows, and tool integrations that extend agent capabilities.

When to Use It

• Creating a new skill from scratch
• Updating an existing skill with new capabilities
• Structuring a skill package with proper metadata
• Writing effective SKILL.md files

Skill Structure

my-skill/
├── SKILL.md          # Main skill file (instructions + triggers)
├── scripts/          # Helper scripts
├── templates/        # Reusable templates
└── references/       # Reference documentation

Best Practices

• Write clear trigger conditions — when should the agent use this skill?
• Include concrete examples in the SKILL.md
• Keep scripts self-contained with clear inputs/outputs
• Test the skill end-to-end before publishing