# Skill

A Skill is a written method for the AI: a folder with a `SKILL.md` file, plus optional scripts and reference files. When a request matches a skill's description, the AI reads the skill before it starts.

## The folder

| Part | What it holds |
|---|---|
| `SKILL.md` | A short header with `name` and `description`, then the method in plain words |
| `scripts/` | Optional code the skill runs, for example `run.mjs` |
| `references/` · `assets/` | Optional material the AI reads when it needs it |

## Where skills are kept

| Source | Folder | Who can change it |
|---|---|---|
| This computer | `<Cowork home>/skills/` | You and the AI on this computer |
| Workspace | `<workspace>/.agents/skills/` | You and the AI; travels with the folder |
| Your home folder | `~/.agents/skills/` | You |
| Platform | `<Cowork home>/platform_skills/` | Read-only; updated from Micromeet |
| Institution | `<Cowork home>/institution_skills/<institution ID>/` | Read-only; updated from Micromeet |

## Rules

- The header of `SKILL.md` must have `name` and `description`. The description says what the skill does and when to use it.
- JavaScript and TypeScript scripts run on the Bun runtime that comes with Cowork, so nobody has to install Node or Python.
- To create a skill, ask the AI in the chat. It creates the folder and checks the format. The new skill can be used from your next message.

## Related

- [What Skills Are](https://docs.micromeet.ai/skills/what-are-skills.md): Skills from a user's point of view
- [How a Skill Is Written](https://docs.micromeet.ai/skills/skill-anatomy.md): The header and the method, step by step
- [Build Your First Skill](https://docs.micromeet.ai/skills/first-skill.md): Make one with the AI