claude-plugins: Instructions file for Claude Code

Claude Code Plugin Marketplace

Personal collection of Claude Code plugins. For plugin and marketplace documentation, see:

• Plugin Marketplaces
• Creating Plugins

Quick Start

# Install dependencies
pnpm install

# Bundle plugin scripts, then regenerate marketplace.json + the README list
pnpm run build && pnpm run sync

Plugin Structure

plugins/{name}/
├── .claude-plugin/
│   └── plugin.json          # Required metadata
├── .mcp.json                # Optional: MCP server config
├── agents/*.md              # Optional: agent definitions
├── skills/*/SKILL.md        # Optional: skills
├── commands/*.md            # Optional: slash commands
└── mcp-server/              # Optional: custom MCP server
    └── dist/                # Bundled output

Adding a Plugin

1. Create plugin directory:

   mkdir -p plugins/my-plugin/.claude-plugin
   

2. Create plugin.json:

   {
     "name": "my-plugin",
     "version": "0.1.0",
     "description": "Plugin description",
     "author": {
       "name": "Nick Nisi",
       "email": "[email protected]"
     },
     "keywords": ["optional", "search", "terms"]
   }
   

3. Add components (agents, skills, commands, or MCP servers)

4. Sync marketplace:

   pnpm run sync
   

The sync script auto-discovers plugins and generates marketplace.json.

1. Make sure to update the README for that plugin.

MCP Servers

Custom MCP Server

Use ${CLAUDE_PLUGIN_ROOT} for paths:

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["${CLAUDE_PLUGIN_ROOT}/mcp-server/dist/index.js"],
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}

Build: pnpm run build (bundles to dist/)

External MCP Server

{
  "mcpServers": {
    "external": {
      "command": "npx",
      "args": ["-y", "@org/mcp-server"]
    }
  }
}