Claude Code es la única interfaz de Claude que realmente instala Skills desde el disco, lo que significa que los consejos para esta herramienta son diferentes de todo lo escrito sobre las instrucciones personalizadas. Esta es una guía práctica: cómo funciona la carpeta, qué hace que una Skill merezca conservarse y en qué pierde la gente el tiempo.
Cómo funcionan las Skills en Claude Code
Las Skills se encuentran en el directorio .claude/skills/. Cada Skill es una subcarpeta que contiene un archivo SKILL.md. Hay dos ubicaciones importantes:
-
Proyecto:
.claude/skills/dentro del repositorio. La Skill viaja con el código, así que todo el equipo la obtiene. Aquí debe ir todo lo específico del proyecto. - Personal: la misma ruta en tu directorio personal. Se aplica a todo en lo que trabajas. Aquí deben ir tus propios hábitos.
A diferencia de las instrucciones personalizadas, que solo pueden contener una cosa a la vez, Claude Code puede contener muchas Skills y utilizar la que corresponda a lo que estás haciendo. Esto cambia el aspecto de una buena Skill: necesita una descripción lo bastante precisa para que se elija la correcta y lo bastante específica para que no se elija para todo.
Qué hace que una Skill realmente merezca su lugar
Después de crear muchas de ellas, el patrón es constante. Las buenas Skills codifican decisiones, no información.
Una Skill que enumera qué es una API REST desperdicia tokens en algo que el modelo ya sabe. Una Skill que dice «en este repositorio, cada endpoint devuelve errores con el formato de RFC 7807, y los tres lugares que no lo hacen son código heredado y no deben copiarse» merece conservarse para siempre, porque esa es una decisión que el modelo no puede inferir.
La prueba es la siguiente: si hubiera que explicárselo a un ingeniero competente que se incorpora a tu equipo, inclúyelo en una Skill. Si ya lo sabría, déjalo fuera.
Las categorías que merece la pena tener
Revisión de código con un estándar propio
Los comentarios de revisión genéricos son ruido. Una Skill de revisión que incluya las convenciones reales de tu equipo, esas cosas sobre las que habéis debatido y llegado a un acuerdo, convierte la revisión de una opinión en una lista de comprobación.
Convenciones de pruebas
Qué framework se utiliza, cómo se llama una prueba, qué se simula y qué nunca se simula, y qué se considera una cobertura suficiente para este código. Sin esto, obtendrás pruebas escritas con el estilo más común en los datos de entrenamiento.
Depuración y gestión de incidentes
Dónde están los registros, qué panel responde a cada pregunta y las cuatro cosas que hay que comprobar antes de escalar el problema. Esta es la Skill que se amortiza a las 3 de la madrugada.
Infraestructura y despliegue
La secuencia de despliegue, qué es seguro ejecutar en producción y qué no, y qué migraciones requieren una ventana de mantenimiento. Codificar las partes peligrosas es precisamente el objetivo.
Documentación y redacción técnica
Dónde se encuentra la documentación, qué estructura sigue una página y la diferencia, según vuestro estilo interno, entre un tutorial y una referencia.
Qué conviene evitar
Tutoriales de lenguajes. Una Skill que explica la sintaxis de Python a Claude es una Skill que explica la sintaxis de Python a algo que ya conoce la sintaxis de Python.
Skills enormes que lo abarcan todo. Una única Skill que cubra frontend, backend, pruebas y despliegue se cargará constantemente y será irrelevante la mayoría de las veces. Divídela.
Cualquier cosa que quede obsoleta en un mes. Números de versión, objetivos del sprint actual o el nombre de quien está de guardia. Las Skills son para decisiones duraderas.
Descripciones vagas. Si la descripción no indica claramente cuándo se aplica la Skill, nunca se seleccionará o se seleccionará siempre. Ambas situaciones son inútiles.
Empezar con una plantilla en lugar de una página en blanco
La parte más difícil no es la idea, sino la estructura: hasta qué punto ser específico, qué dejar fuera y cómo escribir la descripción para que la selección funcione. Esa es la parte que merece la pena copiar de algo que ya se haya probado.
Publicamos archivos de Skills basados en roles para desarrolladores, profesionales de DevOps y arquitectos, escritos como archivos .md sencillos y utilizables tanto como una Skill de Claude Code como pegados en las instrucciones personalizadas:
Skills de Claude Code →
Skills para desarrolladores →
Skills de DevOps →
Skills para arquitectos →
Si no usas Claude Code y has llegado aquí de todos modos, el equivalente para Claude en la web son las instrucciones personalizadas.
KissMySkills es un marketplace independiente y no está afiliado a Anthropic, OpenAI ni a ninguna otra empresa de AI, ni cuenta con su respaldo o está conectado con ellas. Claude Code es un producto de Anthropic.
