Claude Skills: skills vs prompts repetidos

El prompt repetido y la skill comparados: deriva, contexto, descubrimiento y activación frente a invocación directa, automática y archivos de apoyo.

Jonathan Canales

Todo el que trabaja con Claude Code unas cuantas semanas acumula el mismo gesto: abrir la nota donde guarda esa instrucción que ya escribió, copiarla y pegarla en la sesión. El checklist de revisión de código, el formato de los commits, la receta para desplegar, la forma de preparar un reporte. El prompt repetido es la herramienta más vieja del repertorio, y funciona. La pregunta que vale la pena hacerse en agosto de 2026 es cuándo ese gesto debería convertirse en una skill, porque las dos piezas resuelven el mismo problema con economías distintas.

Esta guía compara ambos caminos con criterio práctico: qué hace bien cada uno, dónde empieza a costar la repetición, qué compra exactamente una skill y cómo migrar un prompt maduro conservando lo que ya funciona.

Doodle de una fotocopiadora apilando hojas idénticas, la esquina doblada de la hoja superior naranja

Lo que el prompt repetido hace bien

El prompt pegado a mano tiene virtudes reales. Es inmediato: cero preparación, cero estructura, cero archivos. Es flexible: cada vez que lo pegas puedes retocarlo para el caso concreto, quitar una sección, añadir una salvedad, cambiar el énfasis. Y es desechable, lo cual es una ventaja cuando la tarea misma es desechable.

Para trabajo de una sola vez, el prompt manual gana siempre. Explorar una librería nueva, pedir un análisis que probablemente quede en una sola pasada, probar una idea de formato para ver si te convence. Crear infraestructura para algo que ocurre una vez es sobredimensionar, y la sobredimensión también cuesta: archivos que mantener, nombres que recordar, decisiones prematuras sobre cómo se hará una tarea que todavía está cambiando.

Hay además una virtud social del prompt manual: circula con facilidad informal. Lo pegas en un mensaje al equipo, alguien lo prueba, lo comenta, propone un cambio, y la mejora viaja en la conversación. Durante la fase de exploración esa ligereza acelera el aprendizaje colectivo, aunque la misma ligereza es la que después produce la deriva cuando cada quien conserva su copia.

El prompt repetido es también el laboratorio natural de la skill futura. Las primeras cinco veces que haces una tarea, el procedimiento todavía se mueve: descubres qué paso sobra, qué detalle falta, qué orden conviene. Esa fase de exploración le pertenece al prompt, y congelarla antes de tiempo produce skills que estorban en lugar de ayudar.

Dónde empieza a costar la repetición

El costo del prompt repetido crece en cuatro direcciones, y las cuatro son silenciosas.

La primera es la deriva. Cada copia del prompt vive su propia vida: mejoras la versión en una nota, olvidas actualizar la otra, y tres meses después tienes cuatro variantes del checklist de revisión que piden cosas ligeramente distintas. La consistencia, que era la razón de tener el checklist, se erosiona justo donde más importaba.

La segunda es el costo de contexto en cada sesión. Un procedimiento largo pegado a mano ocupa contexto completo cada vez, lo uses entero o solo en parte. Multiplicado por varias veces al día, ese contexto es capacidad que le quitas a la conversación real.

La tercera es el descubrimiento. Un prompt guardado en tus notas existe solo para ti y solo cuando te acuerdas de buscarlo. El compañero de equipo que podría usarlo jamás lo ve; tú mismo, seis meses después, puedes haber olvidado que lo tenías.

La cuarta es la activación. Con el prompt manual, la carga de reconocer "esto es la tarea X, toca el prompt X" es tuya en cada ocasión. En los días rápidos, el checklist se queda en el cajón precisamente cuando más falta hacía.

Qué compra una skill exactamente

Una skill empaqueta ese mismo procedimiento en una pieza que Claude Code carga y ejecuta como parte de su caja de herramientas. La pieza mínima es un directorio con un archivo SKILL.md: un encabezado YAML entre marcadores con el nombre y la descripción, y debajo el cuerpo en markdown con las instrucciones. La guía de qué son las skills y cómo crear una cubre la anatomía completa; aquí importa lo que el formato compra frente al prompt repetido.

Compra invocación directa: el nombre del directorio se convierte en comando, y escribir /revisar-pr ejecuta tu procedimiento igual que cualquier comando de la herramienta. El gesto de buscar-copiar-pegar desaparece.

Compra invocación automática: la descripción del encabezado le dice a Claude cuándo la skill aplica, y Claude la carga por sí mismo cuando la tarea encaja. Pides "revísame este diff" y tu checklist de revisión entra en juego aunque se te haya pasado pensar en él. La carga de reconocer la ocasión pasa de ti a la herramienta.

Compra contexto barato: el nombre y la descripción están siempre visibles para Claude, pero el cuerpo completo de la skill carga solo cuando se usa. Una biblioteca de diez procedimientos detallados ocupa en reposo una fracción mínima de lo que ocuparía uno solo pegado a mano cada día.

Compra archivos de apoyo: una skill es un directorio, así que puede llevar plantillas, scripts auxiliares y documentos de referencia que se cargan cuando el procedimiento los necesita. El formato de salida ya cabe en un archivo de plantilla en lugar de vivir dentro del prompt.

Y compra compartición real: las skills de proyecto viven en .claude/skills dentro del repositorio, de modo que llegan al equipo con el mismo clone. El procedimiento deja de ser un bien personal y pasa a ser una pieza del proyecto, versionada junto al código que describe.

Doodle de una caja en un estante con una chispa encima, la chispa naranja

La señal de migración: la tercera repetición

La propia documentación de Claude Code da el criterio en una frase: crea una skill cuando te descubres pegando las mismas instrucciones, el mismo checklist o el mismo procedimiento de varios pasos en el chat, o cuando una sección de tu CLAUDE.md ha crecido hasta convertirse en procedimiento en lugar de dato. El cuerpo de una skill carga solo cuando se usa, así que el material de referencia largo cuesta muy poco hasta que lo necesitas.

Traducido a una regla operativa: la tercera vez que buscas el mismo prompt, la tarea ya es candidata. La primera vez es exploración; la segunda, coincidencia; la tercera, patrón. En ese momento el procedimiento ya se estabilizó lo suficiente para que valga la pena congelarlo, y el ahorro de cada ejecución futura empieza a acumularse.

Hay tres pruebas rápidas para confirmar la candidatura. La prueba de frecuencia: la tarea vuelve al menos semanalmente. La prueba de estabilidad: los pasos ya varían poco entre ejecuciones. La prueba de longitud: las instrucciones ocupan más de un párrafo o incluyen una lista de verificación. Un prompt que pasa las tres pruebas y sigue viviendo en tus notas está pagando renta de más.

Cómo migrar un prompt maduro a skill

La migración bien hecha toma menos de una hora y sigue un orden concreto.

Empieza por la mejor versión del prompt, que suele ser la más reciente. Compárala con las variantes viejas y quédate con lo que cada una aportó; la migración es el momento natural de cerrar la deriva.

Después separa instrucciones de referencia. Lo que Claude debe hacer en cada ejecución va al cuerpo del SKILL.md; los formatos, ejemplos largos y documentos de consulta van a archivos de apoyo en el mismo directorio. Esta separación es la que mantiene barato el contexto.

El paso más delicado es escribir la descripción del encabezado, porque esa frase gobierna la invocación automática. Una buena descripción dice qué hace la skill y cuándo aplica, con el vocabulario con el que pedirías la tarea: "Resume los cambios pendientes del repositorio y prepara un mensaje de commit; usar cuando se pregunte qué cambió o se pida un commit". La descripción genérica deja la skill dormida; la descripción bien apuntada la convierte en reflejo de la herramienta.

Prueba los dos caminos de activación antes de dar la migración por cerrada: invoca la skill a mano con su comando y confirma que ejecuta el procedimiento completo, y luego pide la tarea en lenguaje natural y observa si Claude la carga solo. Cuando la carga automática se queda corta, la descripción es el primer sitio donde mirar.

Cierra el ciclo con una iteración real: usa la skill una semana y ajusta. El primer congelado rara vez es el definitivo, y editar un archivo es mucho más barato que editar cuatro notas.

Para ver skills terminadas resolviendo trabajo cotidiano, la colección de ejemplos útiles para el trabajo diario muestra varios patrones en acción.

El prompt como etapa, el sistema como destino

Mirado con distancia, el prompt repetido y la skill son etapas del mismo ciclo de vida: la tarea nace como exploración, madura como prompt estable y se gradúa como skill cuando la repetición confirma que vale la pena. Saltarse la etapa de prompt congela procedimientos inmaduros; quedarse siempre en ella paga el impuesto de la repetición indefinidamente.

El ecosistema empuja en la misma dirección. Anthropic presentó Agent Skills el 16 de octubre de 2025 como formato común para Claude y Claude Code, y la actualización del 18 de diciembre de 2025 añadió administración para organizaciones, un directorio de skills de socios y la publicación del formato como estándar abierto portable entre herramientas. Una skill que empaquetas hoy es un activo que viaja contigo, se comparte con tu equipo y funciona en más de una superficie.

Vale la pena subrayar lo que el formato aporta a la memoria del equipo: una skill de proyecto revisada en el mismo flujo que el código queda sometida al mismo cuidado que cualquier pieza del repositorio. Los cambios al procedimiento pasan por revisión, la historia de ajustes queda registrada y la versión vigente es la misma para todos. El prompt suelto en una nota personal vive fuera de ese circuito, con todo lo que ello implica para la calidad compartida.

La regla final queda simple: el prompt para descubrir cómo se hace la tarea, la skill para ejecutarla la vigésima vez con la misma calidad que la primera. La tercera repetición es la señal, la descripción es la pieza delicada y una semana de uso real es la prueba que cierra el ciclo.

Fuentes

¿Te fue útil este artículo?

Tecnología y herramientas