creating-skills

Installation
SKILL.md

Creating skills

Goal: a skill the model pulls in on its own and acts on. The user expected one thing and the agent did another. That gap is the skill, and one skill closes one gap. This file is the example.

Descriptions are triggers

Every skill's description sits in context at once, and the model reads it to decide whether to open the file. Trigger wording pulls the skill in when it applies. A line in AGENTS.md naming the skill pushes it into every request instead.

BAD

❌ description: This skill helps you create and improve agent skills by providing guidance on frontmatter, descriptions, invocation metadata, and good/bad examples.

GOOD

✅ description: Use when creating or editing agent skills.

Frontmatter decides who reads that description:

disable-model-invocation: false   # the model may load the skill on its own
Installs
5
GitHub Stars
3
First Seen
Aug 18, 2026