What are skills
Reusable instructions and assets your agent loads on demand.
A skill is a reusable instruction set (a SKILL.md file plus optional assets) that your AI agent loads on demand. You author skills in MCP Market or import them from a GitHub repository. Skills are visible only within your organization today.
Why use skills
- Encode reusable workflows (like "Pull a release report" or "Triage a Sentry-style issue") so your agent loads them on demand.
- Iterate safely: every save is versioned and you can restore a previous version any time.
- Distribute by installing skills into toolkits, where every member who uses the toolkit gets the skill.
What's in a skill
A skill is a SKILL.md file with a YAML frontmatter block at the top (metadata like name, description, allowed tools, and model preferences) followed by a markdown body that holds the instructions themselves. Skills can include additional files (such as reference docs or scripts) when imported from a GitHub folder. See SKILL.md frontmatter for the full field list.
How skills work
You create a skill from scratch in the editor or import one from a GitHub repository. Edit the skill as a draft, publish to bump a version, then install it into a toolkit to make it available to your agents. Older versions stay available for restore, subject to your plan's retention window. See Plans and pricing for retention details.