Prostir

Caso 09

Un skill de documentación técnica: haz que cualquier IA escriba docs con tu estándar y luego véndelo

Le pides docs a la IA y te las devuelve genéricas, con un tono que no encaja y sin los prerequisitos, así que las reescribes una y otra vez. Aquí metes tu estándar de documentación en un skill de Prostir: un solo SKILL.md con tus reglas (escribe para lo que busca el lector, el tipo de doc adecuado, tu terminología, una checklist de revisión), más references y evals. Claude Code lo valida y lo publica en un pasaporte en tech-docs.skill.prostir.build. Cualquiera —o su IA— lo instala y escribe docs a tu manera. Regálalo para que te conozcan, o ponle precio en tu propio Stripe y véndelo muchas veces.

01

Antes: las docs de la IA salen genéricas y tu criterio se queda atrapado

  • Le pides a la IA que escriba las docs. Vuelven genéricas, con un tono que no encaja y sin los prerequisitos, así que las reescribes igual.
  • Explicas las mismas reglas una y otra vez: el lector, la estructura, la terminología. Un prompt largo se desvía y no se queda nada.
  • Tu criterio, que tanto te costó, vive solo en tu cabeza. Lo cobras por horas, y ahí topas con el techo.
02

Lo que haces dentro de Claude Code (unos 20 minutos)

Te quedas en tu terminal. Prostir empaqueta, valida y publica el skill.

  1. 01
    Añade Prostir como servidor MCP en Claude Code.

    Un comando: claude mcp add prostir https://prostir.ai.prostir.build/mcp. Inicia sesión una vez.

  2. 02
    Crea el skill y trae tu estándar.

    Claude Code llama a prostir_skills_create (slug tech-docs) y luego a prostir_skills_import_files: pega tu SKILL.md, tráelo de un repo de GitHub o sube una carpeta. Un ZIP es solo transporte; se extrae, no se guarda.

  3. 03
    Escribe las reglas que importan.

    En SKILL.md: escribe para lo que busca el lector, deja claros los prerequisitos de entrada, elige el tipo de doc adecuado (tutorial / how-to / reference / explanation) y no los mezcles, fija tu terminología y tu tono, exige ejemplos probados, añade una checklist de revisión. Mete references/ y evals/.

  4. 04
    Valida.

    prostir_skills_validate comprueba que haya un solo SKILL.md, un frontmatter válido (name, description), que las references @file resuelvan, la seguridad de los scripts y que los evals pasen. Arregla lo que bloquee.

  5. 05
    Decide cómo se comparte y se vende.

    Añade un logo, elige el acceso (abierto, con clave u OAuth) y el precio (gratis, o pago único / suscripción en tu propio Stripe). El acceso y el precio van por separado.

  6. 06
    Publica y comparte el pasaporte.

    prostir_skills_publish saca una versión inmutable, en vivo en tech-docs.skill.prostir.build. Los compradores (o su IA) descargan el paquete en .agents/skills/. Saca una 1.1 cuando quieras.

03

Lo que acaba dentro del skill

Una sola carpeta de Agent Skills. Claude Code la empaqueta y la valida mientras lo ves.

doc skills/tech-docs/SKILL.md El frontmatter (name, description) más tus reglas: escribe para lo que busca el lector, deja claros los prerequisitos, elige el tipo de doc adecuado.
doc references/style.md Tu terminología, tu tono (tú frente a nosotros), el uso de mayúsculas y el formato: el estándar que la IA tiene que seguir.
doc references/review-checklist.md Lo que mira un revisor: prerequisitos claros, ejemplos probados, nada que se dé por sabido, una tarea por sección.
data evals/evals.json Tests que prueban que el skill escribe docs a tu manera antes de que publiques una versión nueva.
04

Cómo se ve esto de verdad en Claude Code

Prompt real, llamadas reales, resultado real.

Claude Code

Empaqueta mi guía de estilo de documentación como un skill en Prostir, slug tech-docs. Quiero venderlo. Trae el SKILL.md y las references de mi repo de GitHub.

prostir_skills_create

Creando el paquete del skill tech-docs (borrador, solo para ti). Reservando el slug.

prostir_skills_import_files

Importando de tu repo de GitHub: skills/tech-docs/SKILL.md más references/ y evals/. La vista previa está limpia: lo aplico al borrador.

prostir_skills_validate

Un solo SKILL.md, frontmatter válido (name, description), las references @file resuelven, los evals pasan. Nada que bloquee.

Ponlo a $9 de pago único en mi Stripe, pasaporte abierto, y usa mi icono lima.

prostir_skills_publish

Publicando la versión 1.0: archivo inmutable. Pago único de $9 vía tu Stripe Connect, acceso abierto. En vivo en tech-docs.skill.prostir.build. ✓ Listo.

En vivo. Comparte https://tech-docs.skill.prostir.build: los compradores pagan en tu Stripe, descargan el paquete y lo meten en .agents/skills/. Saca una 1.1 cuando quieras.

Passport

https://tech-docs.skill.prostir.build · Instálalo en .agents/skills/tech-docs/

05

Después: defínelo una vez, véndelo muchas

  • Cualquiera con quien lo compartas añade el skill, y su IA escribe docs con tu estándar —el tipo de doc adecuado, los prerequisitos claros, tu terminología— desde el primer borrador.
  • Tiene versiones: corriges una regla una vez, sacas una 1.1, y cada instalación nueva incluye el estándar mejorado.
  • Regálalo para que te conozcan, o ponle precio en tu propio Stripe y vende el mismo skill muchas veces en vez de cobrarlo por horas.

Qué publicas

Un skill de Prostir publicado en https://tech-docs.skill.prostir.build: un SKILL.md compatible con Agent Skills más tus references y evals, con versiones e inmutable. Déjalo abierto y gratis, con acceso por clave, o con pago único o por suscripción en tu propio Stripe. Los compradores (o su IA) descargan el paquete y lo meten en .agents/skills/. Defínelo una vez, repártelo o véndelo muchas veces. Sin código.

¿Listo para lanzar?

Una tarde de la idea al enlace en vivo.

Mete lo que solo tú tienes. Escribe las reglas en lenguaje plano. Abre el enlace en ChatGPT, Claude o tu sitio. Publica el agente que solo tú podías publicar.

¿Necesitas escala a medida, white-label o un setup dedicado? Habla con ventas.