Skills over MCP

The server advertises the io.modelcontextprotocol/skills extension (SEP-2640) in its capabilities and serves the same 18 Pix skills as the prompts, in Agent Skills form. A client that reads skills natively uses these; every other client uses the prompts.

How skills differ from the prompts

	Prompt	Skill
Body	SKILL.md with a server notice prepended	SKILL.md byte for byte
Supporting files	Not reachable	Readable with resources/read
Integrity	None	Size and sha256:<hex> digest per file in the manifest
Frontmatter	Mapped to _meta keys	Published as typed YAML values (user-invocable is a boolean)

Two skills’ supporting files only exist in skill form: fix has references/workflow.md and references/memory-yaml-schema.md.

Methods

Method	Params	Returns
skills/list	cursor, optional	skills: every skill’s entry, in one page. Any cursor is rejected with -32602.
skills/get	uri, the skill’s skill://<name>/SKILL.md	skill: one entry. Unknown URI is -32602.
resources/read	uri, skill://<name>/<path>	The file, with its MIME type

A skill entry:

{
  "uri": "skill://fix/SKILL.md",
  "frontmatter": { "name": "fix", "license": "Apache-2.0", "argument-hint": "<vuln-id>", "user-invocable": true },
  "resources": [
    { "uri": "skill://fix/SKILL.md", "digest": "sha256:...", "size": 0 },
    { "uri": "skill://fix/references/workflow.md", "digest": "sha256:...", "size": 0 }
  ]
}

The frontmatter above is abbreviated; every field from the skill’s YAML frontmatter is published.

File template

One resource template, skill://{name}/{+path}, covers every file of every skill, including nested paths. It is listed by resources/templates/list. An unknown file is a resource-not-found error.

Caching and auth

Nothing in a skill varies by caller. skills/list, skills/get and file reads carry ttlMs: 300000, cacheScope: "public", and need no credential.