> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skybridge.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Serve Skills over MCP

> Ship Agent Skills alongside your server

<Info>
  Skills over MCP tracks [SEP-2640](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2640), still under review. The feature is **experimental** and may change with the spec. Few hosts support it yet, so skills you serve today may go unused until they adopt the standard.
</Info>

A [tool](/build/tools) description tells the model *what* a tool does. A **skill** tells it *how* to run a workflow: a directory of instructions (`SKILL.md` plus supporting files) the host loads into context on demand.

## Enable Skills

Drop your skills under `src/skills/`, one directory per skill, and turn the option on:

```ts server.ts theme={null}
const server = new McpServer(
  { name: "shop", version: "1.0" },
  {},
  { skills: true },
);
```

```
src/skills/
  refunds/
    SKILL.md            # required: frontmatter + instructions
    templates/
      email.md          # supporting files, read on demand
```

Each `SKILL.md` opens with YAML frontmatter whose `name` matches its directory:

```md src/skills/refunds/SKILL.md theme={null}
---
name: refunds
description: Process customer refund requests per company policy.
---

1. Look up the order with `get-order`.
2. ...
```

Skybridge validates every skill at build and dev startup: a bad `name`, a missing `description`, or a name that mismatches its directory fails loudly. Each valid skill is then served at `skill://<name>/SKILL.md`, with its supporting files alongside.

<Info>
  Skills are markdown files only: `SKILL.md` and any supporting `.md` files are served as `text/markdown`, other formats and symlinks are ignored.
</Info>

## How Hosts Use Skills

Hosts don't inject skills on their own. To put one in front of the model, reference its URI from a tool description or a tool result, for example *"see `skill://refunds/SKILL.md`"*. The host pulls in the full instructions only when they're relevant.

<Info>
  A skill is a set of instructions a model may or may not act on: it does not bypass the model's system directives or guardrails.
</Info>

## Go Further

<Columns cols={3}>
  <Card title="Register Tools" icon="wrench" href="/build/tools">
    Define what humans and agents can do
  </Card>

  <Card title="UX Design" icon="sparkles" href="/guides/ux">
    Account for what makes an MCP App different
  </Card>

  <Card title="Deploy" icon="rocket" href="/ship">
    Ship your server to any host
  </Card>
</Columns>