Claude Code Skills: Crea flujos de trabajo personalizados para tu asistente de programación con IA

Puntos clave

• Las habilidades (skills) de Claude Code son archivos Markdown que inyectan reglas de equipo, convenciones y plantillas de comandos directamente en el contexto del agente.
• Una habilidad puede ser tan sencilla como una instrucción de un párrafo o tan completa como un flujo de trabajo de varios pasos con plantillas, ejemplos y referencias a variables de entorno.
• Las habilidades reemplazan el antiguo directorio de comandos personalizados y ofrecen una forma unificada de enseñar al agente una vez y reutilizarlo en todas las sesiones.
• Cuando fijas una habilidad a una versión específica del modelo, los costos de token y la calidad de salida se vuelven predecibles; compara modelos en el directorio de modelos de TokenLab y en la página de precios de Anthropic antes de seleccionar uno para producción.

---

Entendiendo las habilidades de Claude Code

Las habilidades son archivos Markdown de texto plano que residen en .claude/skills/ dentro de tu proyecto (o globalmente en ~/.claude/skills/). Cuando invocas una habilidad, Claude Code inyecta el contenido del archivo directamente en su system prompt, instruyendo al agente para que siga esas directrices específicas primero.

Esta inyección significa que controlas el comportamiento del agente con precisión. Un archivo de habilidad puede enumerar patrones prohibidos, bibliotecas requeridas, formatos de salida o una lista de verificación de arquitectura completa. Debido a que las instrucciones están bajo control de versiones junto con tu código, cada miembro del equipo obtiene automáticamente el mismo conjunto de salvaguardas.

Los escenarios comunes que se benefician de una habilidad dedicada incluyen:

• Hacer cumplir tipos estrictos de TypeScript sobre objetos genéricos.
• Estandarizar las formas de respuesta de la API.
• Automatizar la generación de migraciones de bases de datos.
• Ejecutar suites de pruebas antes de confirmar (commit) el código.

Al definir estos flujos de trabajo como habilidades, evitas que el agente alucine comandos o utilice bibliotecas obsoletas. Esto es particularmente útil cuando se trabaja con modelos de codificación avanzados. Si estás eligiendo entre diferentes LLMs para tu pipeline de desarrollo, puedes leer nuestra guía sobre los mejores modelos de IA para codificación en 2026 para ver cómo se compara Claude Sonnet 5 con alternativas como Kimi K2.7 Code o DeepSeek V4 Pro.

---

Cómo crear una habilidad personalizada

Crear una habilidad es sencillo. Escribes un archivo Markdown, lo guardas en el directorio correcto y luego lo referencias durante tu sesión de Claude Code. Vamos a recorrer el proceso de creación de una habilidad que impone una arquitectura limpia y ejecuta suites de pruebas.

Primero, crea el directorio local en la raíz de tu proyecto:

mkdir -p .claude/skills

A continuación, crea un archivo llamado verify-and-test.md dentro de ese directorio. Este archivo instruirá a Claude Sonnet 5 para que revise la base de código, escriba una prueba unitaria usando Vitest y ejecute la suite de pruebas para verificar los cambios.

# Habilidad de verificación y prueba (Verify and Test)

Eres un ingeniero de software experto. Tu tarea es revisar los cambios de código, escribir una prueba unitaria completa y ejecutar la suite de pruebas.

## Instrucciones

1. Revisar código: Analiza los archivos modificados. Asegúrate de que no utilicen APIs obsoletas.
2. Escribir prueba unitaria: Crea un archivo de prueba en el directorio `tests/`. Usa Vitest.
3. Ejecutar pruebas: Ejecuta `npm run test` para verificar que todas las pruebas pasen.
4. Informar: Proporciona un resumen de los resultados de las pruebas y cualquier problema encontrado.

## Ejemplos

Si el usuario te pide verificar una nueva función de utilidad:
- Busca `src/utils/math.ts`.
- Crea `tests/math.test.ts`.
- Ejecuta `npm run test`.

Una vez que guardas este archivo, Claude Code lo detecta automáticamente. Puedes invocarlo pidiéndole al agente que "ejecute la habilidad verify-and-test en los cambios más recientes" o haciendo referencia al nombre de la habilidad directamente en tu prompt.

Para entender cómo los diferentes modelos manejan estos flujos de trabajo agentes complejos y de varios pasos, puedes consultar nuestra comparativa de OpenRouter para evaluar la latencia y la fiabilidad entre diferentes proveedores de API.

---

Gestión de costos de tokens y selección de modelos

Cuando ejecutas Claude Code, cada habilidad que inyectas se suma a tu recuento de tokens de entrada. Debido a que las habilidades se añaden al system prompt, los archivos de habilidades largos con ejemplos extensos pueden aumentar rápidamente tu factura de API.

Según la página de precios de Anthropic (observada el 07-07-2026), los tokens de entrada y los tokens de salida tienen estructuras de costos diferentes. Por ejemplo, Claude Sonnet 5 tiene una tarifa específica por millón de tokens de entrada y una tarifa más alta por millón de tokens de salida. Si ejecutas una habilidad en cada prompt, esos tokens de entrada se acumulan.

Para mantener tus costos de desarrollo bajo control, considera estas estrategias:

• Mantén las habilidades concisas: Evita añadir bases de código masivas como ejemplos dentro del archivo de habilidad. Usa fragmentos cortos y representativos en su lugar.
• Usa habilidades globales frente a locales: Mantén las reglas específicas del proyecto en .claude/skills/ y las preferencias generales en ~/.claude/skills/ para evitar saturar tu contexto.
• Compara modelos alternativos: Aunque Claude Sonnet 5 es excelente para tareas de codificación complejas, es posible que desees dirigir tareas más sencillas a modelos de menor costo. Puedes revisar la guía de comparación de precios para ver cómo los diferentes proveedores valoran sus tokens de entrada y salida.

---

Mejores prácticas para las habilidades de Claude Code

Para aprovechar al máximo tus flujos de trabajo personalizados, sigue estas directrices prácticas.

Práctica	Descripción	Beneficio
Control de versiones	Haz commit de .claude/skills/ en tu repositorio Git.	Asegura que todo el equipo utilice los mismos estándares de codificación.
Definir entradas	Especifica qué variables o archivos espera la habilidad.	Reduce la ambigüedad y evita que el agente adivine.
Proporcionar ejemplos negativos	Incluye secciones de "Qué no hacer" en tu Markdown.	Evita que el modelo repita errores comunes del pasado.
Probar cambios incrementales	Ejecuta la habilidad primero en cambios de código pequeños.	Facilita mucho la depuración de las instrucciones de la habilidad.

Al escribir habilidades, trátalas como código. Si una habilidad no produce el resultado deseado, refina el prompt, añade ejemplos más claros o restringe el alcance de las instrucciones. Si tu flujo de trabajo requiere generar activos más allá del código, como maquetas de interfaz de usuario o medios promocionales, puedes explorar la mejor API de modelos de imagen de IA en 2026 o la mejor API de modelos de video de IA en 2026 para encontrar las APIs adecuadas para esas tareas.

---

Preguntas frecuentes

¿Dónde debo almacenar mis habilidades de Claude Code?

Puedes almacenarlas localmente en la raíz de tu proyecto en .claude/skills/ para reglas específicas del proyecto, o globalmente en ~/.claude/skills/ para reglas que desees aplicar en todos tus proyectos en tu máquina.

¿Puedo usar otros modelos con Claude Code?

Claude Code está diseñado por Anthropic principalmente para sus propios modelos, como Claude Sonnet 5. Sin embargo, puedes comparar las capacidades y los precios de varios modelos en el directorio de modelos de TokenLab para ver cómo funcionan en los benchmarks de codificación.

¿Cómo deshabilito una habilidad durante una sesión?

Si no quieres que Claude Code utilice una habilidad específica, puedes mover el archivo Markdown fuera del directorio .claude/skills/ o cambiar la extensión del archivo para que el agente no lo reconozca como una habilidad activa.

---

Comienza con TokenLab

¿Listo para optimizar tu flujo de trabajo de desarrollo con IA? Encontrar el modelo adecuado con la mejor relación precio-rendimiento es fundamental para escalar tus aplicaciones. Explora la Categoría de Modelos de Código de TokenLab para comparar los últimos modelos, analizar los precios de los tokens y encontrar el LLM perfecto para tus agentes de codificación.