En pocas palabras
Catálogo de plugins para distribuir comandos, skills y otras capacidades de Claude Code.
Qué problema resuelve
Instrucciones compartidas por copia manual que divergen entre desarrolladores.
Cuándo utilizarlo
Equipos con flujos de IA estandarizados. Ejemplo: distribuir una revisión de APIs aprobada.
De la idea a la práctica
Funcionamiento, ejemplos y decisiones para pasar al siguiente nivel.
En el Radar compartido: Trial (valoración de la edición aportada).
Cómo funciona
Un repositorio publica el catálogo y sus referencias a plugins. Los clientes incorporan los paquetes y actualizan capacidades siguiendo una configuración compartida.
Ejemplo de uso
Crear un plugin interno con una skill de revisión, plantillas y comprobaciones. Probarlo en un repositorio piloto, etiquetar una versión y documentar su actualización para el equipo.
Qué contiene un plugin
| Componente | Ubicación en el plugin | Uso |
|---|---|---|
| Manifiesto | .claude-plugin/plugin.json |
Nombre, versión, autor, descripción |
| Comandos | commands/*.md |
Slash commands reutilizables |
| Skills | skills/<nombre>/SKILL.md |
Procedimientos que el agente carga bajo demanda |
| Subagentes | agents/*.md |
Agentes especializados |
| Hooks | hooks/hooks.json |
Comprobaciones automáticas en eventos del agente |
| Servidores MCP | .mcp.json |
Herramientas externas que el plugin activa |
Estructura de un marketplace
Un marketplace es un repositorio (o ruta local) con un archivo .claude-plugin/marketplace.json que lista plugins y su origen:
{
"name": "krediya-plugins",
"owner": { "name": "Plataforma de ingeniería" },
"plugins": [
{
"name": "revision-segura",
"source": "./plugins/revision-segura",
"description": "Skill de revisión de seguridad y hooks de secretos",
"version": "1.2.0"
}
]
}
Uso desde Claude Code
/plugin marketplace add krediya/claude-plugins
/plugin install revision-segura@krediya-plugins
/plugin # gestionar, activar o desactivar plugins
Para que un equipo los tenga disponibles sin pasos manuales, se declaran en el .claude/settings.json del repositorio con extraKnownMarketplaces y enabledPlugins.
Gobernanza de un marketplace interno
| Riesgo | Control |
|---|---|
| Hooks que ejecutan comandos arbitrarios | Revisión de código obligatoria en el repositorio del marketplace |
| Servidores MCP con acceso a datos | Inventario de permisos y credenciales por plugin |
| Cambios silenciosos de comportamiento | Versionado semántico y changelog; fijar versiones en proyectos críticos |
| Plugins abandonados | Propietario explícito y revisión periódica |
Trata el marketplace como una dependencia de la cadena de suministro: lo que se instala se ejecuta con los permisos del desarrollador.
Criterios de implementación
Gestionar propietarios, versiones y acceso al repositorio. Revisar scripts, hooks y servidores incluidos, y evitar actualizaciones sin evaluación que cambien permisos o comportamiento.
Continúa en las fuentes
Documentación oficial para verificar detalles y explorar más.