agentskills-mcp-extension

--- title: agentskills-mcp-extension description: Native MCP Skills publication and origin-preserving client helpers. --- Publish and consume the official MCP Skills extension with immutable, lossless resources. ## Native Skills Only The native Skills API requires MCP SDK `>=2.2,<3`. It serves the official `io.modelcontextprotocol/skills` extension on protocol `2026-07-28` through `skills/list`, `skills/get`, and canonical `skill://` resources. Clients on older protocol revisions see the same `skill://` files as ordinary resources and cannot call the Skills methods. See the [breaking-change guide](https://github.com/pratikxpanda/agentskills-sdk/blob/main/docs/mcp-migration.md). ## Install ```bash pip install "agentskills-mcp-extension[fs]" ``` The `[http]` extra adds the HTTP provider. Publisher verification needs `agentskills-core[verification]` and OpenTelemetry export needs `agentskills-core[telemetry]`. Use an isolated server environment when a host framework pins a different MCP SDK version. ## Serve a Folder Prepare `skills/incident-response/SKILL.md` with valid `name` and `description` frontmatter. The [filesystem guide](https://github.com/pratikxpanda/agentskills-sdk/blob/main/packages/providers/agentskills-fs/README.md#usage) includes a complete sample skill. The Python example publishes that folder over stdio: ```python import asyncio from pathlib import Path from agentskills_core import Skill from agentskills_fs import LocalFileSystemSkillProvider from agentskills_mcp_extension import create_mcp_server provider = LocalFileSystemSkillProvider(Path("./skills")) server = asyncio.run(create_mcp_server([Skill("incident-response", provider)])) server.run(transport="stdio") ``` `create_mcp_server` is async and accepts a `SkillRegistry` or a sequence of raw `Skill` handles. Raw handles avoid imposing registry-specific parsing restrictions before publication. Discovery is metadata-only, including for a single skill. The factory captures complete immu…