Plugins

my-plugin/
├── .claude-plugin/
│   ├── plugin.json        # Manifiesto (OBLIGATORIO)
│   └── marketplace.json   # Para editores
├── commands/              # Slash commands (auto-detectado)
│   ├── build.md
│   └── deploy.md
├── agents/                # Agentes personalizados (auto-detectado)
│   └── test-runner.md
├── skills/                # Skills (auto-detectado)
│   └── my-skill/
│       └── SKILL.md
├── output-styles/         # Estilos de salida (auto-detectado)
│   └── conciso.md
├── hooks/
│   └── hooks.json         # Configuraciones de hooks
└── .mcp.json              # Servidores MCP (opcional)

Schema completo

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "Qué hace este plugin",
  "author": {
    "name": "Nombre del Autor",
    "email": "[email protected]",
    "url": "https://ejemplo.com"
  },
  "homepage": "https://ejemplo.com/plugin",
  "repository": "https://github.com/org/plugin",
  "license": "MIT",
  "keywords": ["testing", "despliegue"],
  "dependencies": [
    "otro-plugin",
    "dep-plugin@otro-marketplace"
  ],

  "commands": { ... },
  "agents": [ ... ],
  "skills": [ ... ],
  "outputStyles": [ ... ],
  "hooks": { ... },
  "mcpServers": { ... },
  "lspServers": { ... },
  "channels": [ ... ],
  "userConfig": { ... },
  "settings": { ... }
}

Servidores LSP

Language server protocol para inteligencia de código.

Canales

Canales de mensajería para el modo asistente KAIROS.

"channels": [{
  "server": "my-chat-server",
  "displayName": "Chat del Equipo",
  "userConfig": {
    "CHANNEL_ID": {
      "type": "string",
      "title": "ID del Canal"
    }
  }
}]

server debe coincidir con una clave en mcpServers. El servidor MCP debe declarar la capacidad claude/channel.

Configuración (Settings)

Anulaciones de configuración cuando el plugin está habilitado.

"settings": {
  "agent": {
    "my-agent": {
      "tools": ["Read", "Grep"],
      "model": "haiku"
    }
  }
}

Actualmente solo se soporta la clave "agent". Se fusiona en la cascada de settings cuando está habilitado.

Ejemplo de schema

"userConfig": {
  "API_KEY": {
    "type": "string",
    "title": "Clave API",
    "description": "Tu clave API",
    "required": true,
    "sensitive": true      // guardado en Keychain
  },
  "MAX_RESULTS": {
    "type": "number",
    "title": "Máx. Resultados",
    "default": 10,
    "min": 1,
    "max": 100
  },
  "VERBOSE": {
    "type": "boolean",
    "default": false
  },
  "PROJECT_DIR": { "type": "directory" },
  "CONFIG_FILE": { "type": "file" }
}

extraKnownMarketplaces en settings.json

{
  "extraKnownMarketplaces": [
    {
      "type": "github",
      "repo": "org/plugins",
      "ref": "main"
    },
    {
      "type": "url",
      "url": "https://plugins.example.com/marketplace.json"
    },
    {
      "type": "npm",
      "package": "@org/marketplace"
    },
    {
      "type": "directory",
      "path": "/marketplace/local"
    },
    {
      "type": "settings",
      "name": "marketplace-inline",
      "plugins": [
        { "name": "my-plugin", "source": "./ruta" }
      ]
    }
  ]
}

Nomenclatura de servidores MCP del plugin

plugin:<nombrePlugin>:<nombreServidor>

Se deduplican contra servidores configurados manualmente — el manual gana. Siguen el mismo sistema de permisos que las herramientas MCP regulares.

Formato de ID de plugin

// String
"mi-plugin@mi-marketplace"

// Objeto con opciones
{
  "id": "mi-plugin@mi-marketplace",
  "version": "^1.0.0",
  "required": true,
  "config": { "API_KEY": "valor" }
}

Ambas partes validadas: [a-z0-9][-a-z0-9._]*