# Create a skill

A custom skill is yours to author end to end: give it an identity, grant it the tools it needs, add any scripts it runs, and write the SKILL.md body that an agent reads when it loads the skill.

## Open the skill editor

Go to Workbench → Skills and click New skill. The full-page editor opens with four sections: Identity, Capabilities, Scripts, and Instructions.

## Identity

- 01Icon and namePick an icon and give the skill a name (it must be unique). The name shows on the card and in each agent’s skill index.
- 02Description, version, and tagsWrite a one-line description — this is what an agent sees when deciding whether to load the skill, so make it match-worthy. Set a version (e.g. 1.0.0) and add comma-separated tags like dev, review for filtering.IdentitySkill editor → Identity: icon, name, description, version, tags.
- 03LocusSet a locus — a palace address for capability scoping, like work.skills.review. It places the skill in your memory den so it can be scoped and found by address.LocusA palace address, e.g. work.skills.review.

## Capabilities — granted tools

In Capabilities, select the tools the skill expects to use. These come from the same read-only catalog the rest of the app draws on — you grant existing tools, you don’t invent new ones here. See the tools catalog for what’s available and how connecting apps adds more.

## Scripts

Add scripts — named commands the skill can run in the sandbox. Each script has a name, a command (e.g. bun run check), and an optional description. They give the playbook repeatable, one-call actions instead of the agent retyping a command each time.

## The SKILL.md body

Finally, write the Instructions — the SKILL.md body, in markdown. This is exactly what use_skill discloses to the agent when it loads the skill, so write it as a clear procedure:

Keep it actionable — numbered steps, what to check, what “done” means. A tight playbook is what lets a Fast-tier agent punch above its weight. Click Create skill when you’re done.

> Built-in skills are read-onlyYou can open a built-in skill to see what it does and what it grants, but its body and scripts are managed by Foxora. Only custom skills get the full editor.