claude code plugins #

packaging an mcp server (plus contextual guidance) for claude code — host-side integration, distinct from the server framework itself.

structure #

.claude-plugin/
├── plugin.json          # plugin definition
└── marketplace.json     # marketplace metadata

skills/
└── domain/
    └── SKILL.md         # contextual guidance

plugin.json:

{
  "name": "myserver",
  "description": "what it does",
  "mcpServers": "./.mcp.json"
}

skills are markdown files loaded as context when relevant to the task — the plugin bundles how to use the server well, not just the server.

sources #

• code.claude.com/docs — plugins
• pdsx - ships as a claude code plugin