# 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**:
```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](https://code.claude.com/docs/en/plugins)
- [pdsx](https://github.com/zzstoatzz/pdsx) - ships as a claude code plugin