Crea tu extensión

Todo lo que ves en el marketplace lo ha publicado alguien. Puedes ser tú. El camino tiene cinco tramos: crear → probar → empaquetar → publicar → mantener, y la aplicación te acompaña en todos.

El camino completo

1. Crear

   En la Galería de extensiones hay una pestaña de creación. Empieza por elegir el tipo: servidor MCP, habilidad, complemento, agente o equipo.

   No arrancas de una página en blanco: cada tipo parte de una plantilla que ya funciona. Encima de ella rellenas nombre, descripción, icono y las credenciales que tu extensión necesitará.

   Y el modelo ayuda: describe con tus palabras qué quieres que haga y te genera el esqueleto completo, manifiesto incluido. Tú lo revisas y lo ajustas.

2. Probar antes de publicar

   La extensión se instala en local y se ejecuta ahí mismo. Ves sus herramientas, ves lo que devuelve y ves sus errores con el texto completo.

   Precaución

   No se puede publicar nada que no se haya podido ejecutar al menos una vez. Si la prueba falla, la aplicación te dice por qué —un comando que no existe, una credencial que falta, un manifiesto incompleto— y no te deja seguir hasta que arranque.

3. Empaquetar

   Al empaquetar se escribe el manifiesto: versión, requisitos, plataformas compatibles, permisos que declara y nombres de las credenciales que pide. Se añade además el checksum SHA-256 del paquete, para que quien lo instale pueda comprobar que recibe exactamente lo que publicaste.

   Si empaquetas un agente que ya tienes configurado (la opción de publicar este agente, desde su propia ficha), la aplicación quita tus credenciales: viajan los nombres de lo que hay que conectar, nunca sus valores. Tu clave de API se queda en tu equipo.

4. Publicar

   Te identificas con tu cuenta de Context Code — la misma con la que entras en la aplicación, no hay una cuenta aparte para publicar.

   La entrada queda en revisión hasta que un administrador la aprueba. Cuando la aprueba, pasa a publicada y aparece en la galería de todo el mundo. Si la rechaza, vuelve a borrador con el motivo escrito, que tú lees.

   borrador ──▶ en revisión ──▶ publicada ──▶ retirada
                    │
                    └──▶ borrador   (rechazada, con el motivo)

5. Actualizar y retirar

   Publicar una versión nueva vuelve a dejarla en revisión: cada versión se mira. Puedes retirar tu extensión cuando quieras; deja de ofrecerse a instalaciones nuevas.

   En tu ficha ves cuántas instalaciones acumula. Es un contador orientativo, para hacerte una idea del alcance.

Crear una extensión: se elige el tipo, se parte de una plantilla que ya funciona y el modelo genera el esqueleto.

Crear una extensión: se elige el tipo, se parte de una plantilla que ya funciona y el modelo genera el esqueleto.

El manifiesto

El manifiesto es el documento que describe tu extensión. Es lo que lee la galería para pintar la ficha y lo que lee la aplicación para instalarla.

Manifiesto de un agente

Este agente redacta informes financieros. Fíjate en tres cosas: modeloRecomendado es el que su autor considera mejor, alternativas incluye al menos una local ("local": true, con proveedor context-forge) para poder usarlo sin coste, y en mcp viajan solo los nombres de las credenciales, nunca sus valores.

{
  "formato": 1,
  "permisos": ["lectura-archivos", "red"],
  "agente": {
    "rol": "Analista de informes financieros",
    "instrucciones": "Lee los datos del trimestre, compáralos con el anterior y redacta un informe con resumen ejecutivo, tabla de cifras y tres conclusiones. Nunca inventes una cifra: si falta un dato, dilo.",
    "tono": "Sobrio y directo, sin adjetivos de más.",
    "queSabeHacer": [
      "Comparar dos periodos y explicar las desviaciones",
      "Redactar el resumen ejecutivo para dirección",
      "Detectar cifras que no cuadran y señalarlas"
    ],
    "modeloRecomendado": {
      "proveedor": "anthropic",
      "modelo": "claude-sonnet-4-5",
      "local": false
    },
    "alternativas": [
      { "proveedor": "openai", "modelo": "gpt-5", "local": false },
      { "proveedor": "context-forge", "modelo": "qwen3-27b-instruct", "local": true }
    ],
    "herramientas": ["leer_archivo", "escribir_archivo", "buscar"],
    "permisos": ["lectura-archivos"],
    "habilidades": ["redaccion-informes"],
    "mcp": [
      { "id": "postgres", "credenciales": ["POSTGRES_URL"] },
      { "id": "hoja-calculo", "credenciales": ["SHEETS_TOKEN"] }
    ],
    "planPrevio": true,
    "delegaEnSubagentes": false,
    "limiteGastoSugerido": "2.00",
    "ejemplos": [
      "Prepara el informe del tercer trimestre con los datos de la base",
      "Compara ventas de este mes con el mismo mes del año pasado",
      "Revisa este informe y dime qué cifras no cuadran"
    ]
  }
}

• rol, instrucciones y tono son la identidad del agente: quién es y cómo habla.
• queSabeHacer es la lista que se enseña en la ficha, para que se entienda de un vistazo.
• herramientas, permisos, habilidades y mcp son lo que necesita para trabajar. Todo eso se le muestra al usuario antes de instalar.
• planPrevio dice si propone un plan antes de actuar; delegaEnSubagentes, si abre agentes auxiliares; limiteGastoSugerido, cuánto conviene dejarle gastar por tarea.
• ejemplos son las peticiones que aparecen en la ficha para lanzar de un clic.

Manifiesto de un equipo

Un equipo de redes sociales: un coordinador de campaña reparte el trabajo y cada agente escribe para su red.

{
  "formato": 1,
  "equipo": {
    "coordinador": {
      "nombre": "Coordinador de campaña",
      "rol": "Recibe el mensaje de la campaña, decide qué publica cada red, reparte el trabajo y revisa que todo cuente lo mismo antes de dar el visto bueno."
    },
    "agentes": [
      {
        "id": "redes-instagram",
        "nombre": "Agente de Instagram",
        "rol": "Escribe pies de foto cortos y visuales, propone la imagen y elige los hashtags."
      },
      {
        "id": "redes-x",
        "nombre": "Agente de X",
        "rol": "Condensa el mensaje en publicaciones muy breves y prepara el hilo cuando hace falta desarrollar."
      },
      {
        "id": "redes-linkedin",
        "nombre": "Agente de LinkedIn",
        "rol": "Redacta en tono profesional, con el porqué del anuncio y una llamada a la acción sobria."
      }
    ],
    "repartoTareas": "El coordinador crea una tarea por red a partir del mensaje de campaña, la envía a su agente, recoge los borradores, comprueba que no se contradicen y devuelve el paquete listo para revisar."
  }
}

Nota

Los ejemplos van comentados en el texto de alrededor, no dentro del JSON: el JSON no admite comentarios y un archivo con // dentro no se puede instalar.

Reglas de publicación

• Identificador en minúsculas y con guiones: redes-instagram, no Redes Instagram ni redes_instagram.
• Un agente debe ofrecer siempre una alternativa de modelo local. Nadie debería necesitar una suscripción para probar tu agente.
• Nada de subir credenciales. Viajan los nombres de lo que hay que conectar; los valores se quedan en el equipo de cada usuario. Un paquete con una clave dentro se rechaza.
• Oficial y Verificada las concede solo el equipo de Context Code, nunca el autor. No las pongas en tu manifiesto.
• Todo lo de fuera pasa por revisión antes de ser público. Sin excepciones, y en cada versión nueva.

Consejo

Si ya tienes un agente que te funciona bien, empaquetarlo cuesta unos minutos y le sirve a mucha gente. Publícalo y aparecerá en el marketplace de extensiones junto a los demás.