Applies to Cowork 0.1.41 · For builders: people who make skills, extensions, mini apps and packages

View as Markdown

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.

What Skills Are Skills from a user's point of view
How a Skill Is Written The header and the method, step by step
Build Your First Skill Make one with the AI