> AI agents: this is one page of nextanalytica's docs. The full index for agents: https://nextanalytica.app/llms.txt

# 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: 2026-11-17

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.

```markdown title="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."

## Next step

[Insights](/docs/skills/insights)

Canonical address: https://nextanalytica.app/docs/skills/whats-in-a-skill
