Referencia

Esquema marketplace.json

El manifiesto del marketplace se encuentra en .claude-plugin/marketplace.json en la raíz del repositorio.

Campos de nivel superior

Campo	Requerido	Descripción
`$schema`	No	URL del esquema JSON para validación
`name`	Sí	Identificador único del marketplace
`version`	No	Versión del esquema del marketplace (semver)
`metadata.description`	Sí	Descripción del marketplace legible por humanos
`owner.name`	Sí	Organización o usuario propietario del marketplace
`owner.url`	No	URL al perfil o sitio web del propietario
`owner.email`	No	Correo electrónico de contacto
`plugins`	Sí	Array de entradas de plugins

Campos de entrada de plugin

Campo	Requerido	Descripción
`name`	Sí	Identificador del plugin (debe coincidir con `plugin.json`)
`description`	Sí	Descripción breve del plugin
`version`	Sí	Cadena de versión semántica
`author.name`	Sí	Autor del plugin
`source`	Sí	Ruta o URL al plugin (véase Tipos de origen)
`category`	Sí	Categoría del plugin (p. ej., `productivity`)
`homepage`	No	URL a la documentación o página principal del plugin
`license`	No	Identificador de licencia SPDX
`keywords`	No	Array de palabras clave de búsqueda
`tags`	No	Array de etiquetas para filtrado
`repository`	No	URL del repositorio

Tipos de origen del plugin

El campo source en marketplace.json admite múltiples formatos:

Tipo	Ejemplo	Descripción
Ruta relativa	`./plugins/example-plugin`	Plugin en el mismo repositorio
Abreviatura de GitHub	`owner/repo`	Plugin en la raíz del repositorio
GitHub con ruta	`owner/repo/path/to/plugin`	Plugin en subdirectorio
URL de Git	`https://github.com/owner/repo.git`	Repositorio Git
Paquete npm	`npm:@scope/package`	Paquete npm publicado

Esquema plugin.json

Cada plugin tiene un manifiesto en .claude-plugin/plugin.json dentro de su directorio.

Campo	Requerido	Descripción
`name`	Sí	Identificador del plugin
`description`	Sí	Lo que hace el plugin
`version`	Sí	Versión semántica
`author.name`	Sí	Autor del plugin
`author.url`	No	URL al perfil o sitio web del autor
`homepage`	No	URL de documentación
`keywords`	No	Palabras clave de búsqueda
`license`	No	Identificador de licencia SPDX
`repository`	No	URL del repositorio

Estructura de directorios del plugin

plugins/example-plugin/
  .claude-plugin/
    plugin.json          # Manifiesto del plugin (requerido)
  skills/
    skill-name/
      SKILL.md           # Definición de habilidad (requerida por habilidad)
      references/        # Archivos de datos de referencia (opcional)
  commands/
    command-name.md      # Definición de comando (uno por comando)
  agents/
    agent-name.md        # Definición de agente (uno por agente)
  README.md              # Documentación del plugin (recomendado)

Variables de entorno

Los plugins pueden usar estas variables en sus archivos de habilidades y comandos:

Variable	Descripción
`$\{CLAUDE_PLUGIN_ROOT\}`	Ruta absoluta al directorio raíz del plugin

Validación

Valide sus manifiestos de marketplace y plugin de forma local:

claude plugin validate .

Esto verifica:

Conformidad con el esquema de marketplace.json
Que todos los directorios de plugins referenciados existen
Que cada plugin tiene un plugin.json válido
Que las habilidades tienen el frontmatter de SKILL.md con el formato correcto
Que los comandos tienen los campos de frontmatter requeridos

Configuración de equipo

Preconfiguración de marketplaces

Agregue a .claude/settings.json en cualquier repositorio:

{
  "extraKnownMarketplaces": [
    "f5-sales-demo/marketplace"
  ]
}

Habilitación previa de plugins

{
  "enabledPlugins": [
    "f5xc-docs-tools@f5-sales-demo-marketplace"
  ]
}

Solución de problemas

Marketplace no encontrado

Verifique que el marketplace fue agregado:

/plugin marketplace list

Si no aparece, agréguelo de nuevo:

/plugin marketplace add f5-sales-demo/marketplace

El plugin no se activa

Confirme que el plugin está instalado: /plugin list
Verifique que su versión de Claude Code admite plugins (v1.0.33+)
Compruebe que las condiciones de activación de la habilidad coincidan con su contexto actual

Las habilidades no se activan automáticamente

Las habilidades se activan en función del campo description en el frontmatter de SKILL.md. Si una habilidad no se activa cuando se esperaba:

Verifique que la descripción describa con precisión el contexto de activación
Use el comando directamente (p. ej., /f5xc-docs-tools:review-mdx) como alternativa

Errores de compilación tras la revisión

El plugin reporta los problemas pero no los corrige automáticamente. Aplique las correcciones sugeridas de forma manual y luego vuelva a ejecutar la revisión para confirmar la resolución.