Saltar al contenido
Gabriel Neuman
Gabriel Neuman

Skill de Claude Code · gratis

Están escritas por IA para IA. Nadie las toma.

El board tiene cuarenta tickets y ninguno dice qué hay que hacer. Títulos que son sustantivos, contexto de seis párrafos hasta arriba, y cero definición de cuándo termina. Repartir ese trabajo exige explicarlo ticket por ticket.

El costo real

Un ticket que solo un modelo entiende es un ticket que nadie toma.

Se mide fácil: de 53 issues en review de un solo board, 42 tenían el título sin verbo de acción. No es un problema cosmético. Si nada más el agente que lo escribió sabe qué se espera, repartir el trabajo cuesta una junta por ticket o una reescritura completa.

El contexto largo arriba es el otro asesino. Quien está decidiendo si toma el ticket lee de pie, en el celular, entre dos cosas. Si los primeros tres párrafos son el porqué, nunca llega al qué.

Y sin un “listo cuando” observable, el ticket no cierra: se discute.

El formato

El orden no es estético: es el orden en que alguien decide si lo toma.

Cuatro capas, siempre en esta secuencia. Nunca al revés:

Título2 segundos

¿de qué se trata?

TL;DR15 segundos

¿qué tengo que hacer?

Listo cuando30 segundos

¿cuándo termino?

Contextosolo si ya lo tomó

¿por qué y con qué datos?

La regla del verbo, aplicada

Project brief

Crear el project brief del proyecto Acme

Bug en el login

Corregir el login que rechaza correos con +

Mejoras al dashboard

Agregar filtro por fecha al dashboard de ventas

API de usuarios

Exponer GET /users con paginación

Verbo en infinitivo, una sola acción y objeto concreto. Si el título necesita una “y”, son dos issues.

Regla 1

Vertical, nunca por capa

Cada slice cruza schema, API, interfaz y test en una tajada angosta que se puede demostrar sola. Una slice de una sola capa se fusiona con la que la consume.

Regla 2

Apruebas antes de que publique

Primero ves el desglose y ajustas la granularidad. Nada de “ya creé 47 tickets, ojalá te gusten”.

Instalar

Tres comandos y ya está corriendo.

# 1. Agrega el marketplace
claude plugin marketplace add gneuman/gnb-plugins

# 2. Instala el plugin
claude plugin install gnb-prd-to-issues@gnb-labs

# 3. Úsalo
/prd-to-issues                        # toma el PRD de la conversación
/prd-to-issues _build_plan/prd.md     # o el que le pases
/prd-to-issues OP-1751                # o reescribe un issue que no se entiende

También se dispara solo cuando dices “desglosar este PRD”, “crear tickets”, “vertical slices” o “este ticket no se entiende”.

El tracker al que apuntas, el mapa de labels y el largo máximo del título viven en un bloque [CUSTOMIZE] al final del skill. Los valores que trae funcionan tal cual: forkear es sobreescribir, no rellenar vacíos. El formato del issue no se toca.

Por qué este y no otro

Cada ticket dice cómo nació.

Traza por label, no por firma

El label de agente y el de origen marcan lo que el skill creó o reescribió, y la fuente rastreable va en el cuerpo. Sin eso no se puede distinguir el trabajo de un agente del de una persona, ni mejorar el skill que lo produjo.

El output se puede migrar

Markdown con frontmatter, no llamadas a una API. Si mañana cambias de Linear a Jira, el backlog se mueve con un script simple en vez de rehacerse a mano.

Se niega a publicar lo que no pasa el gate

Antes de escribir el archivo o llamar al tracker corre un gate de formato sobre cada issue. El que no pasa no se publica: se corrige, y te reporta cuántos falló y por qué.

Precio

Gratis. Licencia MIT.

El skill es tuyo sin pagar nada y sin dejar el correo. Si lo que quieres es montar esto adentro de tu operación —tus procesos, tu equipo, tus skills— eso se trabaja en el Club de IA: taller quincenal en vivo, cupo de 10 empresas.

El paso anterior

¿Todavía no tienes el PRD?

`/idea-to-prd` hace la entrevista de diez fases que convierte un brain dump en el spec que este skill parte en tickets. Los dos se usan seguido, en ese orden.

Preguntas

Lo que se pregunta antes de instalarlo.

¿Me va a llenar Linear de tickets sin avisar?

No. Primero te muestra el desglose numerado con el título, el TL;DR de una línea, si lo puede hacer un agente solo y de qué depende. Iteras la granularidad ahí. Sin tu aprobación explícita no publica nada: la idea es que no existan los 47 tickets que nadie pidió.

¿Solo funciona con Linear?

El output por default es markdown universal con frontmatter, más un grafo de dependencias en Mermaid y un README de cómo importarlo. Eso se adapta a Jira, GitHub Projects, Notion o ClickUp. Si tienes el MCP de Linear, hay un modo que además publica directo, en orden de dependencias, y pide confirmación antes de la primera llamada.

¿Qué es una vertical slice?

Una tajada angosta que cruza todas las capas —schema, API, interfaz, test— y entrega algo que se puede demostrar solo. Lo contrario es cortar por capa: "crear el schema de users" no se puede demostrar y no le sirve a nadie hasta que llegue la slice que lo consume. Si una slice toca una sola capa, el skill la fusiona.

¿Qué es eso de HITL y AFK?

Cada slice se marca según quién la puede hacer: HITL necesita un humano en el proceso, AFK la puede correr un agente sin supervisión. Sirve para repartir: lo AFK se despacha en lote y lo HITL se agenda con quien tenga el contexto. El skill prefiere AFK donde se pueda.

¿También arregla tickets que ya existen?

Sí, en modo reescritura. Le pasas el issue que quedó en "need clarification" y lo reescribe con el formato: verbo al frente, TL;DR arriba y definición de listo. El label de agente se aplica también al reescribir, para que la traza no se pierda.

Las vertical slices y los tracer bullets vienen de The Pragmatic Programmer, de Hunt y Thomas. Lo que agrega esta versión: el orden obligatorio del issue con su tiempo de lectura, la regla del verbo al frente, el gate que se niega a publicar lo que no lo pasa, la marca HITL/AFK para repartir, y la traza por label. La regla de formato es la misma que corre adentro de GNB Labs, no una versión recortada.

Antes de instalar nada más

Te mando cómo se construyen estos skills por dentro.

Cada viernes: una táctica aplicable, la herramienta que la resuelve y qué costó. 3,000+ founders en LATAM. Gratis.