Skills
What's in a skill
A skill's parts: a name, when to use it and the instructions, as one SKILL.md you can write yourself.
Updated
A skill is one SKILL.md: a name, a line on when to use it and the instructions. That's all of it. Our built-in skills and your own are the same thing.
SKILL.md
---
name: Pricing page watch
description: Every Monday, says whether visits to /pricing turned into trials, by channel.
---
Compare last week's visits to /pricing with trial starts, by channel, against the week before.
Name the channel that changed most, with the numbers.
If nothing moved more than 10%, report nothing.What are the parts and their limits?
| Part | Limit | Tips |
|---|---|---|
| Name | 64 characters | What it does, in a few words. |
| Description | 300 characters | When to use it. Your agent reads it to pick the skill. |
| Instructions | 20,000 characters | What to read, what counts as worth reporting and how to say it. |
What makes instructions good?
- Name the metric, the period and the comparison: "last 7 closed days against the 7 before".
- Say when to stay quiet: "If nothing moved more than 10%, report nothing." If you add one line, add this one.
- Ask for the fix, with where and what: "the exact text now and the text to use".
- Never ask a skill to change the site; it can't, and runs never do.
Make one
In Skills, click Write a skill, or ask your agent: "Write a skill that checks /pricing every Monday." Give it a schedule on its page, then test it: "Run my pricing page watch now."