Saltar al contenido
Pathrule

skills

Nombra la tarea.
No los pasos.

Skills reutilizables para agentes de programación con IA: procedimientos con nombre que el agente invoca en lugar de volver a deducir los pasos, para que el cuarto paso deje de perderse.

Claude Codeejemplo
Reproduce en local el pago fallido de ayer.

Sin la skill

Evento encontrado, servidor arrancado y payload enviado al webhook.

Webhook rechazado: falló la comprobación de la firma.3 de 5 pasos

Con la skill

skill replay-stripe-webhook

  • Evento obtenido por su id
  • Secreto de firma local cargado
  • Servidor arrancado con los webhooks activados
  • Reproducido con una clave de idempotencia nueva
  • Log del handler revisado

El handler devolvió 200.5 de 5 pasos

Los mismos pasos. Cada semana.

  1. Semana 1tú, a claude code

    «Incrementa la versión, compila las dos marcas, súbelas y después etiqueta.»

  2. Semana 2tú, a codex

    «Primero la versión. Luego las dos marcas, no solo una.»

  3. Semana 3tú, a claude code

    «Has vuelto a etiquetar antes de subir.»

  4. Semana 4tú, a cualquier agente

    ::release-mobile

3 explicaciones1 skill0 pasos olvidados desde entonces

La señal no es la complejidad, sino que te repitas. A partir de tres pasos, o con cualquier orden obligatorio, debería ser una skill. Por debajo de eso, una memoria basta.

La descripción hace el trabajo.

SKILL.md
---name: replay-stripe-webhookdescription: Reproduce un evento de pago de producción contra el servidor local.---# Reproducir un webhook de Stripe1. Obtén el evento por su id2. Carga el secreto de firma local3. Reprodúcelo con una clave de idempotencia nueva
prompt«Reproduce el pago fallido de ayer»
  • «Utilidades de Stripe»stripe-helpersdescartada
  • «Reproduce un evento de pago de producción contra el servidor local»replay-stripe-webhookinvocada

Una skill que el agente nunca invoca suele ser un problema de descripción. Nombra el desencadenante, no el tema, o ganará el propio plan del agente.

Una skill. Todas las rutas que la necesitan.

replay-stripe-webhook

Se escribe una vez, a nivel de espacio de trabajo. Se vincula allí donde se hace la tarea, sin copiarla nunca.

  • /services/billingvinculada
  • /services/webhooksvinculada
  • /apps/admin/paymentsvinculada
  • /apps/mobileaquí no
llega a
  • Claude Code.claude/skills
  • Codex.agents/skills
  • Cursor, Copilot, Windsurfpor MCP
manual
Escrita en Pathrule
template
Una plantilla de partida, copiada
github_ref
Descargada y después en caché

Quien se incorpore al equipo el mes que viene recibirá la skill sin que nadie le diga que existe. Las skills obsoletas o en conflicto aparecen como sugerencias, y una persona aprueba la corrección.

Preguntas frecuentes.

¿Qué es una skill para agentes de IA?

Un procedimiento con nombre y reutilizable que un agente de programación con IA puede invocar en lugar de volver a deducir los pasos: reproducir en local un webhook de Stripe, regenerar los fixtures de seed, recorrer la lista de comprobación previa al lanzamiento. El cuerpo es un pequeño archivo Markdown cuyo frontmatter da nombre a la skill y describe para qué sirve.

¿Cuándo debería algo ser una skill y no una memoria?

Cuando es una secuencia y el orden importa. Recurre a una skill a partir de tres pasos, o siempre que alguna parte exija "haz esto en este orden". Una o dos líneas, o un hecho que el agente solo necesita saber y no ejecutar, es una memoria.

¿Por qué mi agente no usa la skill que escribí?

Lo más habitual es que la descripción no diga para qué sirve la skill. Las skills se seleccionan por su descripción, así que una vaga pierde frente al plan que el agente seguiría por defecto: nombra el desencadenante y no el tema. Las otras causas habituales son un ámbito que nunca coincide con las rutas donde se hace el trabajo y un procedimiento que todavía tiene una decisión real a mitad de camino. En profundidad: por qué no se activan las skills de Claude Code.

¿Se puede compartir una skill con todo el equipo?

Sí, y para eso se guarda fuera de un prompt. Las skills pertenecen al espacio de trabajo y se vinculan a los nodos mediante una relación, así que una misma skill se reutiliza en muchas rutas y el agente de cada compañero puede invocarla. La pertenencia a la organización y el acceso al espacio de trabajo se controlan en el servidor. Consulta roles y permisos.

¿Puedo usar skills que haya publicado otra persona?

Sí. Una skill puede tener como fuente una URL externa de GitHub, y Pathrule descarga el cuerpo y lo guarda en caché. La copia en caché es la última instantánea servida, y el espacio de trabajo recoge los cambios de upstream en la siguiente actualización. Úsalo para skills publicadas por un ecosistema en el que confías.

¿Qué diferencia hay entre una skill y un patrón de Pathrule?

Una skill es un procedimiento. Un patrón es un pequeño paquete de memorias, reglas y skills para un tema, con cada pieza ya vinculada a la ruta a la que pertenece, porque una convención real casi nunca cabe en un solo archivo. En profundidad: qué es un patrón de Pathrule y por qué no es una skill.

¿Las skills sustituyen a mis prompts?

No, les quitan la repetición. Vale la pena escribir una skill cuando notas que vuelves a explicar el mismo procedimiento. A partir de ahí, el prompt nombra el trabajo en lugar de describirlo, y los pasos dejan de variar de una explicación a la siguiente.

Escribe los pasos una vez.
Después, nombra la tarea.