skills.rest
Curcolor
CurcolorCOMMUNITY
Explore all skills by this author →
GitHub

skill-mcp-builder

Guides creation of Skills 2.0 directories and stdio MCP servers for Claude Code.

Updated May 19, 2026
Search Tags:#scaffolding#claude code#model context protocol#skill builder#json schema#mcp server#developer tooling
One-click install
npx skills add https://github.com/Curcolor/CLAUDEMAX --skill skill-mcp-builder-curcolor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-mcp-builder
Source: https://github.com/Curcolor/CLAUDEMAX/tree/main/skills/skill-mcp-builder
Command: npx skills add https://github.com/Curcolor/CLAUDEMAX --skill skill-mcp-builder-curcolor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @modelcontextprotocol/sdk.

What problem does it solve? It removes the guesswork of packaging new capabilities for Claude Code in the CLAUDEMAX ecosystem by defining the exact file structure, metadata fields, validation steps, and registration commands for both declarative skills and MCP servers. ## Core Features & Use Cases - Skill 2.0 scaffolding: Defines the required three-file layout (SKILL.md, skill.yaml, schema.json), bilingual trigger conventions, and the validate-skills.mjs check that must pass before a skill ships. - MCP server pattern: Documents the canonical stdio server built on @modelcontextprotocol/sdk, with ListToolsRequestSchema and CallToolRequestSchema handlers, plus the rule that the MCP must be a thin wrapper over a testable CLI. - Decision guidance: Provides a comparison table for choosing between a knowledge skill, a CLI-backed tool skill, or a full MCP server based on whether you need context injection, shell commands, or protocol-validated tools. - Use Case: When you want to add a new capability to Claude Code, invoke this skill to generate the correct directory structure, pass the repo validator, register the MCP with claude mcp add, and wire symmetric uninstall logic. ## Quick Start Ask the AI to create a new skill or MCP server for Claude Code following the skill-mcp-builder conventions and run the validator until it reports OK.

Frequently Asked Questions about skill-mcp-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new skill for Claude Code?▼

Create a directory under skills/<name>/ containing SKILL.md with YAML frontmatter, skill.yaml with version, kind, and bilingual triggers, and schema.json with input/output definitions. Then run node skills/validate-skills.mjs until it reports OK.

How do I build an MCP server with the Model Context Protocol SDK?▼

Use @modelcontextprotocol/sdk to create a Server instance, register ListToolsRequestSchema and CallToolRequestSchema handlers with JSON Schema input definitions, and connect via StdioServerTransport. Register it with claude mcp add -s user <id> -- node <path>.

When should I use an MCP server instead of a skill?▼

Choose an MCP server when the model needs a native tool with a protocol-validated inputSchema available all session. Choose a skill when you only need to inject context, criteria, or checklists, and a CLI-backed tool skill when wrapping shell commands.

Why does my MCP server fail to connect in claude mcp list?▼

A missing connected check means the server process crashes at startup. Run the server file directly with node <path> to see the stack trace, then fix the error and re-register with claude mcp add.

What files does a Skill 2.0 require to pass validation?▼

Exactly three files: SKILL.md with name and description frontmatter, skill.yaml with matching name, version, kind, and triggers, and schema.json with definitions.inputs and definitions.outputs. The directory name must match the name field in both files.

Related Skills

Explore More Software Engineering Skills→
cxnaivecxnaive

spike

Build minimal prototypes to validate technical feasibility and compare implementation approaches.

Community
Intermediate
redpanda-dataredpanda-data
6

ai

Manage the Redpanda AI CLI plugin lifecycle and MCP integration for Claude workflows.

Official
Advanced
kagentikagenti
292

skills:scan

Scan repositories to bootstrap or audit AI agent skills.

Official
Advanced
kreuzberg-devkreuzberg-dev
862

using-the-mcp-server

Convert HTML to Markdown and extract metadata through the html-to-markdown MCP server tools.

Official
Intermediate