Conceptos básicos de Habilidades de Claude

10 ejemplos para empezar con las Habilidades de Claude: 7 básicos y 3 intermedios.

Requisitos previos

• Acceso a una superficie de Claude que admita Habilidades: Claude Code, Cowork o claude.ai.
• No se requiere ninguna instalación especial más allá de tu cuenta y plan de Claude habitual: las Habilidades son una característica de la superficie, no un producto separado.
• Un buen punto de partida es tener en mente una tarea recurrente: un formato de informe, una lista de verificación, una convención de nomenclatura o cualquier proceso que te encuentres reexplicando.

Ejemplos básicos

1. Reconocer una tarea que vale la pena convertir en una Habilidad

No todas las preguntas puntuales necesitan una Habilidad; los buenos candidatos son tareas que repites con la misma forma cada vez.

Señales de que una tarea es una buena primera Habilidad:
- Has explicado los mismos pasos o formato a Claude más de dos veces.
- La salida necesita seguir una estructura específica cada vez (un informe, una lista de verificación, una plantilla).
- Alguien más en tu equipo se beneficiaría de las mismas instrucciones.

• Una Habilidad vale la pena por la repetición; una tarea que solo harás una vez no merece la pena empaquetarla.
• Las primeras Habilidades más claras son aquellas con una frase desencadenante obvia, como "informe semanal" o "revisión de código".
• Si no puedes describir en una sola frase cuándo querrías que se activara, vale la pena acotar la idea antes de crearla.
• Los informes recurrentes, las listas de verificación de revisiones y las guías de incorporación son los puntos de partida más comunes que los equipos eligen.

2. Crear una carpeta de Habilidad

Una Habilidad comienza como una carpeta con un único archivo requerido dentro, llamado SKILL.md.

Carpeta mínima de Habilidad:
informe-semanal/
  SKILL.md

• El nombre de la carpeta no tiene que coincidir exactamente con nada, pero un nombre corto y descriptivo hace que tu biblioteca de Habilidades sea más fácil de escanear más tarde.
• SKILL.md es el único archivo requerido; todo lo demás en la carpeta es opcional.
• Dónde vive esta carpeta depende de la superficie: una ubicación de Habilidades a nivel de proyecto en Claude Code, un área de Habilidades en Cowork o una sección de Habilidades en la configuración de tu claude.ai.
• No necesitas reiniciar una conversación para que una nueva Habilidad esté disponible; una vez añadida, Claude puede encontrarla en la próxima tarea coincidente.

3. Escribir el Frontmatter

SKILL.md se abre con un bloque de metadatos corto que le dice a Claude qué es la Habilidad y cuándo usarla.

---
name: weekly-report
description: >-
  Generates the weekly team status report in our standard format.
  Use when asked for a weekly update, status report, or team summary.
---

• name es un identificador corto para la Habilidad; mantenlo en minúsculas y específico.
• description es el campo que Claude realmente compara con las tareas entrantes, por lo que debe indicar tanto lo que hace la Habilidad como cuándo se aplica.
• Una descripción que solo dice lo que hace la Habilidad, sin nombrar cuándo usarla, es la razón más común por la que una Habilidad no se utiliza.
• Dos o tres frases desencadenantes concretas en la descripción (las palabras que una persona realmente escribiría) funcionan mejor que un solo nombre de categoría abstracto.

4. Escribir el cuerpo de las instrucciones

Debajo del frontmatter, el resto de SKILL.md son instrucciones en lenguaje claro sobre cómo realizar la tarea.

Cuerpo de SKILL.md (después del frontmatter):
1. Extrae las tres actualizaciones principales de las notas de esta semana.
2. Agrupa las bajo "Logros", "Riesgos" y "Próximos pasos".
3. Limita cada punto a una oración.
4. Termina con un resumen de una línea para la dirección.

• Escribe el cuerpo de la misma manera que le explicarías la tarea a un nuevo compañero de equipo capaz: pasos específicos, no objetivos vagos.
• Los pasos numerados funcionan bien para los procesos; la prosa sencilla funciona bien para las guías de estilo o tono.
• Puedes ser tan detallado como la tarea lo necesite; el cuerpo solo se carga cuando se activa la Habilidad, por lo que la longitud aquí no ralentiza las conversaciones no relacionadas.
• Mantén las instrucciones centradas en una sola tarea; una Habilidad que intenta cubrir varios trabajos no relacionados se vuelve más difícil de que Claude la empareje de manera fiable.

5. Darle a Claude una tarea que coincida

Una vez que existe una Habilidad, no la invocas por su nombre; simplemente pides la tarea y Claude la compara con tus Habilidades.

Mensaje de ejemplo:
"¿Puedes preparar el informe de estado de esta semana?"

• Si la redacción de tu mensaje se superpone con la descripción de la Habilidad, Claude carga sus instrucciones antes de responder.
• Nunca tienes que decir "usa la habilidad informe-semanal"; eso anula el propósito del descubrimiento automático.
• La primera vez que pruebes una nueva Habilidad, usa el tipo exacto de redacción que esperas usar en las solicitudes reales, no una oración de prueba genérica.
• Si la respuesta no sigue el formato de la Habilidad, es una señal para revisar la descripción o las instrucciones, no una señal de que las Habilidades no funcionan.

6. Confirmar que se usó una Habilidad

La mayoría de las superficies muestran alguna indicación de que se cargó una Habilidad, para que no te quedes adivinando si se activó.

Qué comprobar:
- ¿La salida sigue la estructura que escribiste en el cuerpo de la Habilidad?
- ¿La superficie muestra un indicador de Habilidad o una referencia en la respuesta?
- ¿Preguntar "¿qué Habilidad usaste para eso?" obtiene una respuesta directa?

• La comprobación más fiable es simplemente si la salida coincide con lo que escribiste en la Habilidad; si lo hace, se activó.
• Preguntar directamente a Claude qué Habilidad usó es una forma legítima de confirmar, especialmente mientras todavía estás probando una nueva.
• Si una Habilidad no se activa cuando debería, la descripción es el primer lugar donde buscar, no las instrucciones del cuerpo.
• Este tipo de comprobación rápida vale la pena hacerla justo después de crear cualquier Habilidad nueva, antes de depender de ella para el trabajo real.

7. Editar una Habilidad después del hecho

Las Habilidades no son fijas una vez creadas; puedes abrir SKILL.md y revisar las instrucciones o la descripción en cualquier momento.

Ediciones tempranas comunes:
- Ajustar la descripción después de notar que la Habilidad no se activó.
- Añadir un paso que olvidaste la primera vez.
- Eliminar una instrucción que produjo el formato incorrecto.

• No hay un paso de "publicación" separado; guardar el archivo editado es suficiente para que la próxima tarea coincidente use la nueva versión.
• Al principio, espera revisar la descripción más que el cuerpo; conseguir que Claude reconozca de manera fiable el desencadenante suele ser la parte más difícil.
• Las ediciones pequeñas y específicas después de observar un resultado real son más efectivas que intentar escribir una Habilidad perfecta en el primer intento.
• Mantener una Habilidad en un solo lugar significa que una edición la actualiza en todas partes donde se usa esa Habilidad, en lugar de tener que arreglar copias dispersas.

Ejemplos intermedios

8. Agrupar un archivo de referencia

La carpeta de una Habilidad puede contener más que SKILL.md; los archivos adicionales viajan con ella y se pueden referenciar desde las instrucciones.

Carpeta de Habilidad con un archivo de referencia:
informe-semanal/
  SKILL.md
  plantilla-informe.md

• Mueve material largo y detallado, como una plantilla completa o una guía de estilo, a un archivo de referencia separado y mantén el cuerpo de SKILL.md centrado en los pasos.
• Esto mantiene las instrucciones principales fáciles de escanear y, al mismo tiempo, proporciona a Claude acceso a tantos detalles como necesite la tarea.
• Los archivos de referencia son opcionales; la mayoría de las Habilidades simples nunca los necesitan.
• Aquí es también donde puede residir un script pequeño, si el ámbito de allowed-tools de la Habilidad permite a Claude ejecutarlo.

Relacionado: Anatomía de un archivo SKILL.md - qué pertenece al frontmatter, al cuerpo o a un archivo agrupado.

9. Escribir una descripción que se active de forma fiable

El campo de descripción merece una segunda revisión una vez que hayas visto cómo se comporta la Habilidad en la práctica.

Antes: "Maneja informes."
Después: "Genera el informe de estado semanal del equipo en nuestro
formato estándar. Úsalo cuando se te pida una actualización semanal,
un informe de estado o un resumen del equipo."

• Una descripción vaga como "maneja informes" le da a Claude muy poco con qué coincidir y a menudo no se utiliza.
• La versión revisada indica lo que hace la Habilidad y enumera las frases específicas que una persona escribiría para solicitarla.
• Si las descripciones de dos Habilidades se superponen mucho, Claude puede elegir la incorrecta; acotar cada descripción reduce ese riesgo.
• Esta es la edición de mayor impacto que puedes hacer en una Habilidad que no se activa cuando se espera.

Relacionado: Cómo Claude descubre y carga Habilidades automáticamente - la mecánica detrás de por qué la redacción de la descripción importa tanto.

10. Usar la misma Habilidad en diferentes superficies

Una Habilidad creada una vez no está ligada a una única superficie de Claude; la misma carpeta funciona de la misma manera en Claude Code, Cowork y claude.ai.

Una Habilidad, tres superficies:
- Claude Code: se activa mientras trabajas en un repositorio.
- Cowork: se activa durante una tarea en un espacio de trabajo en equipo.
- claude.ai: se activa en una conversación normal de chat.

• No necesitas una versión separada de una Habilidad para cada superficie; el mecanismo de coincidencia de descripciones se comporta igual en todas partes.
• Esto hace que las Habilidades sean un buen lugar para poner convenciones de equipo que deseas que se sigan de manera consistente, independientemente de la superficie en la que alguien esté trabajando.
• Dónde se almacena la Habilidad y cómo se habilita difiere ligeramente por superficie; el contenido y el comportamiento de la Habilidad una vez cargados no lo hacen.
• Si una Habilidad funciona bien en una superficie pero no en otra, la causa casi siempre es una configuración de habilitación, no la Habilidad en sí.

Relacionado: Habilitar y administrar Habilidades en Claude Code, Cowork y Claude.ai - dónde activar las Habilidades por superficie.

Versiones de la pila: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026: Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.