Crea tu propio marketplace de plugins para Claude Code paso a paso

Aprende a crear tu propio marketplace para distribuir agentes, comandos, hooks, skills y MCPs de Claude Code, estandarizando el uso de IA en tu equipo de desarrollo.

Hay una tendencia que he visto crecer últimamente en el desarrollo de software que es el caso del “solo developer”, esto consiste en que un desarrollador tenga a un equipo de software completo usando agentes de IA.

La verdad es que eso es bastante cool si eres freelancer o un consultor independiente, ya que puedes crear soluciones robustas sin una inversión fuerte en tener a un equipo de personas.

Ahora, para el resto del mundo la verdad es que no trabajamos solos, tenemos un equipo y como equipo se tiene que llegar a acuerdos sobre qué y cómo usar ciertas tecnologías. Esto para tener un workflow similar y que el software sea mantenible.

Imagina este escenario. Tu equipo usa tabs para indentar código y tu usas espacios, ciertamente no sería algo muy agradable trabajar en el mismo proyecto (especialmente si usas python).

El uso de agentes de IA para programar ya no es opcional, pero estas herramientas se manejan en un entorno local, en un silo personal. Compartirlo no forma parte del scope de las plataformas.

Se han creado soluciones alternativas para resolver estas limitaciones pero es algo externo. En el caso de Claude Code tenemos estas propuestas: Claude Code Plugins y Claude Code Plugins Marketplaces.

Claude Code Plugins: Nos permite extender la funcionalidad de Claude Code y compartir comandos, hooks, agentes y servidores MCP. Estos deben vivir en un marketplace.
Claude Code Plugin Marketplaces: Es un catálogo de plugins.

En este post vamos realizar las siguientes actividades:

1. Crear un Claude Code marketplace para distribuir nuestro plugin.
2. Crear un Claude Code plugin para auditorías de performance web.
3. Configurar nuestro MCP de chrome.
4. Probar nuestro plugin.

El código terminado está en este repositorio

La estructura es la siguiente:

.claude-plugin/marketplace.json  
└─plugins  
  └─performance-auditor/  
    ├──.claude-plugin/plugin.json  
    ├──.mcp.json  
    └──agents/  
       └─web-performance-auditor.md

En la siguiente imagen podemos ver la estructura de archivos en detalle:

Creando nuestro Claude Code marketplace

Lo primero que tenemos que hacer es crear un repositorio en github, puedes elegir el nombre que tu quieras, sugiero el nombre enterprise-marketplace.

Abre una consola, clona el repositorio, entra al repositorio local y ejecuta el comando claude.

Dentro del repositorio que te compartí creé unos comandos que van a hacer nuestra vida más fácil así que vamos a instalar el plugin que creé.

/plugin marketplace add dezkareid/claude-code-marketplace

Donde dezkareid sería el owner(username u organización) y claude-code-marketplace, el nombre de mi repositorio.

Nota: hay muchas maneras de agregar un marketplace.

Verificamos que se haya instalado como en la imagen:

Una que se haya instalado el marketplace, procederemos a instalar el plugin con el siguiente comando:

/plugin install marketplace-manager@dezkareid-marketplace

Cuando la instalación comienza podemos ver algunos detalles del plugin:

Al terminar de instalar el plugin veremos algo similar a la siguiente imagen que indica que tenemos que reiniciar la consola de claude:

Ahora tenemos disponible el comando /marketplace-manager:create-claude-marketplace, el cual necesita de manera obligatoria el nombre del marketplace. Ejecutaremos el comando así:

/marketplace-manager:create-claude-marketplace enterprise-marketplace

El comando te dirá que hace en cada paso, te preguntará algunos detalles hasta que finalice.

Como resultado tendremos el archivo marketplace.json dentro de .claude-plugin con un contenido similar a este:

{  
  "name": "enterprise-marketplace",  
  "metadata": {  
    "version": "0.0.1"  
  },  
  "owner": {  
    "name": "Tu nombre"  
  }  
}

Creando nuestro Claude Code plugin

Ahora es tiempo de crear nuestro plugin, simplemente ejecutamos el comando:

/marketplace-manager:create-claude-plugin performance-auditor

Este comando nos preguntará la descripción del plugin, entre otros datos.

También se nos preguntará sobre si queremos crear algún agente, skill, comando, etc. Yo le dije que creará el agente web-performance-analyzer.

El template es bastante simple solo agrega nombre, la descripción y otras cosas necesarias según claude por nuestra descripción.

Te recomiendo que le eches un ojo al curso de prompt engineering para hacer un prompt más preciso y efectivo.

Una vez terminado el flujo, veremos que dentro de plugins se ha creado el folder performance-auditor, te animo a revisar el código generado.

Los cambios más significativos son el plugin.json y el marketplace.json.

El plugin.json solo contiene metadata

{  
  "name": "performance-auditor",  
  "description": "A collection of agents and tools to make performance auditories",  
  "version": "0.0.1",  
  "author": {  
    "name": "Joel Humberto Gomez Paredes"  
  }  
}

Y en el marketplace.json simplemente se agregó la propiedad plugins:

{  
 "plugins": [  
    {  
      "source": "./plugins/marketplace-manager",  
      "name": "marketplace-manager",  
      "description": "A collection of tools to create a marketplace or plugins for claude code",  
      "version": "0.0.1"  
    },  
    {  
      "source": "./plugins/performance-auditor",  
      "name": "performance-auditor",  
      "description": "A collection of agents and tools to make performance auditories",  
      "version": "0.0.1"  
    }  
  ]  
}

Para terminar este paso vamos a validar que nuestro marketplace es válido,abre una terminal (no la de claude) y ejecuta el comando claude plugin validate ..

Ahora continuamos con el paso final.

Creando nuestro mcp

Un plugin también sirve para compartir la configuración de nuestros MCP. Vamos a compartir la configuración de nuestro MCP de Chrome.

Por cierto si quieres crear tus propios MCPs existe un Curso de MCP con Microsoft Azure.

Creamos el archivo .mcp.json dentro del folder performance-auditor con el siguiente contenido:

{  
  "mcpServers": {  
    "chrome-devtools": {  
      "command": "npx",  
      "args": [  
        "chrome-devtools-mcp@latest",  
        "--headless=true",  
        "--isolated=true"  
      ]  
    }  
  }  
}

Al finalizar simplemente hacemos push de nuestros cambios.

Probando nuestro plugin

Para finalizar vamos a instalar nuestro marketplace y después nuestro plugin

/plugin marketplace add tu-usuario/enterprise-marketplace

Y ahora instalamos el plugin

/plugin install performance-auditor@enterprise-marketplace

Al instalar veremos los siguientes detalles:

Reinicia la consola de Claude Code y agrega el siguiente prompt “Audit web performance of page ” y coloca la URL de tu preferencia. Ejemplo:

Claude Code ejecutará nuestro MCP y te entregará un reporte de performance:

Nota: Aquí literalmente estamos probando en producción, hay otras maneras de hacer pruebas en entorno de desarrollo local pero eso lo abordaremos en otros posts.

Conclusiones

El plugin marketplace es una feature muy poderosa para potenciar y estandarizar el uso de agentes, herramientas y mcps en nuestro equipo.

El método de distribución puede ser algo tan simple como un repositorio. La configuración no es compleja y esto rompe una barrera de entrada para empezar a probar y experimentar.

Gracias por leer este post, espero que lo compartas y lo más importante que te sea útil. Cuéntame en los comentarios, ¿qué soluciones crearías con lo que aprendiste?.

Y recuerda si quieres seguir aprendiendo sobre agentes y automatización con IA, explora los cursos de IA y desarrollo en Platzi.