AI Skills

Install MCPDS guidance into your coding agent.

MCPDS ships an AI skill for Claude Code, GitHub Copilot and other agents. The skill gives your agent the MCPDS context it needs to design, review and generate .mcp.yaml files consistently.

What MCPDS skills do

Skills package project knowledge for AI coding tools. The MCPDS skill teaches the agent how the specification is structured, what a valid MCPDS document describes and which installation workflow to use.

01

Specification-aware help

The agent can reason about MCPDS as a design contract for MCP servers, not just as generic YAML.

02

Shared across tools

The same skill can be installed for Claude Code, GitHub Copilot and other agents so teams get consistent MCPDS guidance.

03

Local or global scope

Install once for every project, or keep the skill scoped only to the repository where you design MCP servers.

Install MCPDS skills

Use the skills CLI through npx. Add -g when you want the MCPDS skill available globally for all projects.

Global install

For all projects

Install the MCPDS skill globally for Claude Code, GitHub Copilot and other agents.

npx skills add mcpdesignorg/mcpds -g -a claude-code -a github-copilot -y
Project install

For project only

Keep the skill attached to the current repository without changing the global tool setup.

npx skills add mcpdesignorg/mcpds -a claude-code -a cursor -a github-copilot -y
Maintenance

Update or remove

Refresh the installed MCPDS skill when the upstream guidance changes, or remove it from your setup.

npx skills update mcpds
npx skills remove mcpds

Manual install

Prefer to install it yourself? Download or copy the MCPDS skill files from the canonical skills/mcpds folder and place them in the skills directory used by your AI coding tool.

Open skill folder

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please reload the page.