Referencia

Esquema de 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 legible del marketplace
`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í	Arreglo 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	Arreglo de palabras clave de búsqueda
`tags`	No	Arreglo de etiquetas para filtrado
`repository`	No	URL del repositorio

Tipos de origen de 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
Abreviación 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 de 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 localmente:

claude plugin validate .

Esto verifica:

Cumplimiento del esquema de marketplace.json
Que todos los directorios de plugins referenciados existan
Que cada plugin tenga un plugin.json válido
Que las habilidades tengan frontmatter de SKILL.md correctamente formateado
Que los comandos tengan los campos de frontmatter requeridos

Configuración de equipo

Preconfigurar marketplaces

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

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

Preactivar plugins

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

Solución de problemas

Marketplace no encontrado

Verifique que el marketplace haya sido agregado:

/plugin marketplace list

Si no aparece, vuelva a agregarlo:

/plugin marketplace add f5-sales-demo/marketplace

Plugin no se activa

Confirme que el plugin está instalado: /plugin list
Verifique que su versión de Claude Code sea compatible con 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 de su campo description en el frontmatter de SKILL.md. Si una habilidad no se activa cuando se espera:

Compruebe 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 solución alternativa

Errores de compilación tras la revisión

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