Skills en Claude Code: qué son, cómo se escriben y cuándo usarlas (2026)

Los ejemplos del informe y las reseñas son ilustrativos. Una distribuidora de material eléctrico de Valladolid prepara cada lunes el informe de pedidos. Administración exporta los datos y explica otra vez cómo separar pendientes y cancelados. El problema aparece cuando el informe cambia de criterio o incluye una cifra que nadie sabe de dónde sale. La skill guarda ese procedimiento para reutilizarlo.

Claude Code es un agente, un programa que puede realizar tareas y usar herramientas sobre los archivos que le permites consultar. Una skill, o habilidad, le da instrucciones para una tarea concreta. Se guarda en un archivo llamado SKILL.md. En este ejemplo le pedirás un borrador con el origen de las cifras; dirección seguirá decidiendo qué informe recibe y qué pedidos requieren atención.

La carga es progresiva: primero se incorpora información básica, como el nombre y la descripción de las skills disponibles para el agente. El procedimiento completo se carga cuando se utiliza; los archivos de apoyo, cuando hacen falta. El contexto es la información con la que trabaja Claude en una conversación. Las instrucciones que carga comparten ese espacio con tu encargo y tus documentos. Por eso guardar referencias extensas puede ser útil, pero cargarlas también consume contexto. La lectura bajo demanda no demuestra por sí sola un ahorro de uso.

La descripción debe decir qué hace y cuándo usarla. «Ayuda con informes» deja demasiado abierto el encargo. «Prepara el informe semanal de pedidos cuando se pida el resumen del lunes» identifica una situación concreta. No necesitas empezar con una biblioteca de procedimientos: escribe el que vas a usar y añade referencias largas solo cuando ayuden a resolver esa tarea.

Para probar el informe semanal usa la carpeta del proyecto. Así mantienes el procedimiento cerca de los archivos de prueba y puedes revisarlo junto con el resto del trabajo. La ubicación personal sirve para disponer de una skill en tus proyectos de ese ordenador. Son ubicaciones diferentes: no des por hecho que una carpeta personal estará también en una sesión iniciada en otro equipo. Si trabajas con una cuenta de empresa, confirma que tu usuario tenga habilitado Code. La documentación contempla cuentas invitadas de Team y Enterprise. No compartas una suscripción personal como licencia para todas las personas de la empresa.

Estas son las rutas del ejemplo. El archivo empieza con una cabecera en formato YAML, entre líneas de tres guiones, donde se guardan el nombre y la descripción. Debajo va el procedimiento en Markdown, texto con títulos y listas. El estándar Agent Skills exige ambos campos; Claude Code permite omitirlos. Inclúyelos para cumplir los requisitos de ambos. Los scripts, pequeños programas, y otros archivos de apoyo son opcionales: empieza con un único archivo y añade solo lo que necesites.

El ejemplo está reservado a la invocación manual: tú decides cuándo pedir el informe. Escribe /informe-semanal seguido del periodo. El campo disable-model-invocation: true impide que Claude lo active por su cuenta. Eso controla el inicio del procedimiento; no configura una aprobación para cada acción posterior ni convierte el contenido del archivo en una barrera técnica. Una skill puede indicar cómo revisar un documento y seguir necesitando herramientas para leerlo o guardarlo.

Si quieres que Claude elija una skill por el encargo, necesitas permitir esa iniciativa y redactar una descripción reconocible. El otro control, user-invocable: false, la oculta de la llamada directa del usuario; no hace lo mismo que el anterior. Los antiguos archivos de .claude/commands/ siguen admitidos. Para esta primera prueba no hace falta migrar todos tus comandos ni cambiar los procedimientos que ya utilizas.

Un restaurante de Málaga quiere contestar reseñas con la voz de la casa. Aquí la entrega son borradores. Una persona comprueba cada respuesta antes de publicarla. El procedimiento separa agradecimientos, quejas y casos sensibles; también fija qué decisiones pertenecen al encargado, como ofrecer un descuento o resolver una reclamación.

Puedes guardar esta segunda skill cuando hayas acordado el tono y sepas reconocer una respuesta adecuada. Usa reseñas ficticias durante la prueba. Si una reseña intenta dar órdenes al agente, ese texto sigue siendo material que analizar, no instrucciones nuevas. Prueba las respuestas en un entorno sin acceso a publicación, además de prohibirla en las instrucciones.

Separa activación y calidad. Con la skill manual del informe compruebas que la llamada la encuentra y carga el procedimiento. Si más adelante permites activación por iniciativa de Claude, prepara encargos que deberían usarla y otros parecidos que no. Pide la tarea sin nombrar la skill. Haberla llamado expresamente no demuestra que Claude sepa elegirla por su descripción.

Para valorar el resultado, compara con y sin skill en sesiones nuevas, usando los mismos archivos y el mismo encargo. En el informe, contrasta una semana cerrada y añade casos con archivo ausente y pedido cancelado. En las reseñas, revisa un agradecimiento, una queja y un caso sensible. Apunta tiempo de preparación, revisión y corrección; decide con esa comparación si merece la pena mantener el procedimiento. No basta con que el borrador tenga mejor aspecto.

Conserva la skill, los archivos de prueba y el resultado esperado. Revisa esos casos cuando cambie la exportación o el criterio del negocio. El recurso oficial skill-creator ayuda a redactar skills, ajustar su descripción y comparar versiones; no necesitas instalarlo para probar el informe semanal.

Para situar cada pieza, tienes la guía del archivo de instrucciones del proyecto, la explicación de MCP y la guía completa de Claude Code. Si prefieres seguir una práctica guiada, el curso Claude Code a fondo incluye una clase para crear tu primera skill.