Skip to main content
Version: Next

Skills - Reusable Instruction Sets With Curated Tool Groups

Skills package a piece of instruction text - a name, description, and body following the SKILL.md format - together with an optional group of tools and prompts curated from your catalog. Instead of wiring tools together by hand for every task, an agent can pull in a skill as a single, ready-made capability.

What a skill contains

  • Instruction text. A slug-style name, a short description, and a Markdown body - the same shape as the SKILL.md spec.
  • An optional capability group. A curated selection of tools and prompts drawn from one or more catalog items. Each item can select specific tools/prompts, all of them (*), or none.
  • Attribution. Each skill records its author, powering "by <author>" attribution in the UI.

Authoring skills

A new Skills page in the MCPX UI is the workbench for managing your skills:

  • Create a skill from scratch with a guided form.
  • Upload an existing SKILL.md Markdown file to import a skill.
  • Edit a skill's instruction text and capability group.
  • Delete skills you own.

The list view presents your skills as searchable, sortable cards, and each skill has its own detail page.

Scoping: enable skills per subject

Skills are enabled per subject - a user, a space, or a profile - so each context only sees the skills it should. Enabling a skill for one subject does not expose it to others.

How skills are served

  • Skills are served as MCP resources (skill://), so agents can discover and load them.
  • A skill can optionally be exposed as a prompt (a /slash command) as well, in addition to the resource face.

Note: In this release, skills are personal - authored, edited, and deleted by their owner - with cross-subject sharing planned for a later release.