Publica un mod

#Antes de empezar

Te hace falta un publicador. La primera vez que entras con Google, Modyard te crea uno: una cuenta con un slug, por ejemplo ana, que es también el nombre de tu marketplace. Un publicador puede ser una persona o un equipo; sus propietarios invitan a otros miembros como propietarios, editores o lectores. Pueden publicar los editores y los propietarios.

También te hace falta un mod que funcione. Compruébalo en local antes de subir nada:

claude plugin validate ./bash-logger
claude plugin test ./bash-logger

Si todavía no tienes ninguno, en escribe tu primer mod montas bash-logger desde cero.

#Qué tiene que llevar el zip

Comprime la carpeta del plugin. Modyard acepta los ficheros en la raíz del zip o dentro de una única carpeta que los envuelva, así que valen las dos formas:

cd bash-logger && zip -r ../bash-logger.zip . && cd ..
# o bien
zip -r bash-logger.zip bash-logger

Antes de aceptarlo, Modyard revisa esto:

Si algo falla, el error te dice qué regla y qué fichero, para que lo corrijas y vuelvas a subirlo.

Modyard no sirve tu zip tal cual. Genera un archivo canónico, con los ficheros ordenados y las fechas fijas, y calcula su sha256. Dos subidas con los mismos ficheros dan los mismos bytes y el mismo hash, y ese hash va a tu marketplace para que Claude Code compruebe cada descarga.

#Forma 1: el formulario web

Entra en publicar, elige el publicador si perteneces a varios y suelta el zip. Modyard te enseña el nombre, la versión y la descripción que ha leído de plugin.json, la lista de ficheros y qué puede tocar el mod. Léelo antes de confirmar: si pone network y tú no pensabas hacer peticiones, algo de tu código las hace. En qué puede tocar un mod tienes cada categoría explicada.

En cuanto lo publicas, el mod tiene su ficha en mods y aparece en tu marketplace.

#Forma 2: curl y una clave de API

Para scripts y CI, crea una clave de API en ajustes. Solo los propietarios pueden crearlas, y una clave que publica necesita permiso de lectura y escritura. Empiezan por mdy_. Después:

curl -X POST https://mods.gonzaloverdugo.com/api/v1/mods \
  -H "Authorization: Bearer mdy_..." \
  -F archive=@bash-logger.zip

La respuesta es la versión publicada, con su sha256. Cada clave pertenece a un solo publicador, así que publica ahí y en ningún otro sitio. No la dejes en el repositorio: guárdala en los secretos de tu CI.

#Forma 3: desde un agente por MCP

Si Claude te está ayudando a escribir el mod, también puede publicarlo. Conecta Claude Code al endpoint MCP de Modyard con una clave de lectura y escritura:

claude mcp add --transport http modyard https://mods.gonzaloverdugo.com/mcp \
  --header "Authorization: Bearer mdy_..."

Luego pídele que publique la carpeta. Usará la tool modyard_publish_mod con el archivo, y con modyard_list_my_mods puede ver qué tiene ya tu publicador. En usa Modyard desde un agente tienes cómo configurarlo en Claude Code y en claude.ai.

#Nombres y versiones

Los nombres son únicos en todo Modyard, no por publicador, y se los queda quien llega primero. Si bash-logger ya existe, te toca elegir otro. Algunos slugs de publicador están reservados (anthropic, claude, official, modyard y otros) para que nadie se haga pasar por ellos.

Las versiones no se pueden modificar. Una vez publicas la 0.1.0, sus ficheros no cambian nunca, así que el código que lee la gente es el que ejecuta. Para sacar un arreglo, sube version en plugin.json y vuelve a publicar. Cada versión nueva tiene que ser mayor que la última: después de la 0.1.0 puede venir la 0.1.1 o la 0.2.0, pero ni otra 0.1.0 ni una 0.0.9.

{ "name": "bash-logger", "version": "0.1.1", "description": "Shows each Bash command in the status line" }

Quien ya tenga el mod instalado recibe la versión nueva al ejecutar /plugin marketplace update ana en Claude Code.

#Ocultar o borrar

Desde la ficha del mod, un publicador puede:

• Ocultarlo. Sale de la búsqueda y del listado de tu marketplace, pero cualquiera con el enlace directo puede seguir instalándolo. Sirve para un mod que ya no promocionas pero del que alguien puede depender.
• Borrarlo. Desaparecen sus versiones y el nombre queda libre, así que otra persona puede quedárselo. Quien lo instaló conserva su copia, pero ya no recibe actualizaciones.

Con una clave, borrar es una sola petición:

curl -X DELETE https://mods.gonzaloverdugo.com/api/v1/mods/bash-logger \
  -H "Authorization: Bearer mdy_..."

Borrar no tiene vuelta atrás, y otro puede quedarse el nombre. Si solo quieres que deje de verse, ocúltalo.

#Repaso rápido antes de publicar

1. claude plugin validate y claude plugin test pasan.
2. version es mayor que la última que publicaste.
3. El zip lleva plugin.json, hooks.json y todos los módulos que nombra.
4. Lo que el mod puede tocar encaja con lo que dice que hace.
5. La descripción le cuenta a un desconocido qué hace en una frase.