Blank white background with no objects or features visible.

¡Hola, EMEA! TrueFoundry está ampliando su presencia en Europa, Oriente Medio y África. Leer más →

Las mejores Claude Code Skills para desarrolladores en 2026

Published: noviembre 20, 2026

Resumen:

Una habilidad (skill) es la forma más económica de mejorar Claude Code en tu código base, ya que solo consume tokens cuando realmente se utiliza.

  • Una habilidad es un paquete SKILL.md de instrucciones y recursos que se carga bajo demanda cuando la tarea coincide, en lugar de permanecer en el contexto toda la sesión como hace CLAUDE.md.
  • Solo el nombre y la descripción permanecen residentes: unas pocas docenas de tokens por habilidad. El cuerpo y los archivos vinculados se cargan de forma progresiva y únicamente cuando son necesarios.
  • Las habilidades no son subagentes ni herramientas MCP. Una habilidad inyecta conocimiento, un subagente aisla el trabajo en su propia ventana de contexto y un servidor MCP añade herramientas externas. La mayoría de los equipos necesitan los tres.
  • Las mejores habilidades eliminan la exploración. Un codebase-overview, un test-runner, una guía de migración o una lista de verificación de PR evitan que Claude gaste tokens redescubriendo lo que tú ya sabes.
  • Ahorran dinero real. Cada archivo que Claude no necesita leer son tokens de entrada que no pagas, y el efecto se multiplica en todo el equipo.
  • A escala de equipo, las habilidades necesitan control de versiones y gobernanza, no copias dispersas en portátiles, que es donde entran en juego un registro compartido y una pasarela de IA.

Qué es realmente una Claude Code skill

Una habilidad es una carpeta con un archivo SKILL.md en su raíz: una breve descripción de cuándo se aplica, seguida de las instrucciones y los archivos auxiliares que Claude debe usar cuando corresponde. Claude Code solo lee el nombre y la descripción al principio; el cuerpo completo se carga en el contexto únicamente si la tarea coincide. Esta propiedad (la carga bajo demanda) es lo que hace que las habilidades sean económicas.

Esto contrasta con CLAUDE.md, que se carga al inicio de la sesión y permanece en el contexto durante toda la conversación. Las instrucciones detalladas de flujo de trabajo allí consumen tokens en cada mensaje, incluso durante tareas no relacionadas. La recomendación es mantener CLAUDE.md ágil (solo lo esencial) y mover el conocimiento especializado y situacional a habilidades que se carguen cuando sean necesarias. Consulta nuestra nota sobre esto en precios de Claude Code y cómo reducir el gasto.

Anatomía de un SKILL.md y cómo la carga bajo demanda mantiene el contexto reducido

Una habilidad consta de tres partes, y entender dónde se ubica cada una en el contexto es la clave. El frontmatter YAML (un nombre y una descripción) es la única parte siempre residente: Claude Code lee el frontmatter de cada habilidad instalada al inicio de la sesión para saber qué habilidades existen y cuándo se aplica cada una. Un nombre junto con una descripción de una línea ocupa solo unas pocas docenas de tokens, por lo que se puede tener una biblioteca entera de habilidades instaladas prácticamente sin coste.

El cuerpo (el texto Markdown debajo del frontmatter) contiene la guía real: convenciones, listas de pasos, reglas de decisión y fragmentos de código. No se carga al inicio de la sesión. Solo se carga cuando el modelo decide, a partir de la descripción, que la tarea coincide; entonces se lee para ese tramo de trabajo y luego vuelve a quedar fuera de foco. Un cuerpo leído una sola vez, cuando es relevante, cuesta una fracción en comparación con el mismo texto fijado en CLAUDE.md durante toda la sesión.

La tercera parte son los recursos adjuntos: archivos adicionales en la carpeta (documentación de referencia, plantillas, fixtures, pequeños scripts) a los que apunta el cuerpo y que solo se cargan si la tarea sigue un enlace hacia ellos. Esto es divulgación progresiva: cada capa se incorpora solo cuando la anterior indica que es necesaria, de modo que incluso una habilidad grande y detallada tiene un coste de reposo casi nulo. La lección: el coste de una habilidad no depende de su tamaño, sino de la frecuencia con la que se activa.

CapaQué contieneCuándo entra al contextoCoste en reposo
Frontmatter (nombre + descripción)Qué habilidad es y cuándo se aplicaSiempre: se lee al inicio de la sesiónUnas pocas docenas de tokens por habilidad
Cuerpo (instrucciones de SKILL.md)Las convenciones, pasos y reglas en síAl coincidir: cuando la tarea se ajusta a la descripciónCero hasta que se activa
Recursos adjuntosArchivos de referencia, plantillas y scripts enlazadosAl hacer referencia: solo si se necesita el archivoCero hasta que se abre

Habilidades vs subagentes vs herramientas MCP

Estos tres conceptos se confunden constantemente, y elegir el incorrecto es la forma más rápida de agotar el presupuesto de contexto. Resuelven problemas distintos:

DimensiónHabilidad (Skill)SubagenteHerramienta MCP
Qué esUn paquete SKILL.md de instrucciones y recursosUna instancia independiente de Claude con su propia ventana de contextoUna herramienta externa expuesta a través de Model Context Protocol
Cuándo se cargaBajo demanda, cuando la tarea coincide con su descripciónCuando delegas una tarea aislada o de gran volumenLas definiciones se posponen; se carga al usar la herramienta
Qué proporciona a ClaudeConocimiento: qué hacer y cómoUn lugar para delegar trabajo y devolver un resumenAlgo a lo que llamar: una acción o fuente de datos
Efecto en el contextoAñade instrucciones a la conversación de forma breveMantiene el código de salida extenso fuera del contexto principalMantiene los esquemas de herramientas fuera del contexto hasta su uso
Ideal paraConvenciones, guías de actuación, listas de revisiónPruebas, triaje de registros, refactorizaciones grandes, investigaciónAPIs, bases de datos, SaaS y sistemas internos

Una regla general: si estás enseñando a Claude qué hacer, es una habilidad; si le estás dando un lugar para delegar trabajo, es un subagente; si le estás dando algo a lo que llamar, es un servidor MCP. Son complementarios: una habilidad puede describir cómo usar bien una herramienta MCP, y a un subagente se le puede indicar que cargue una habilidad. Dos datos sobre costes a tener en cuenta: los subagentes heredan el modelo de la sesión a menos que configures uno (model: haiku crea un asistente económico) y ejecutar un equipo de agentes completo puede consumir aproximadamente siete veces más tokens que una sola sesión. Analizamos el aspecto de la gobernanza en gobernanza de herramientas vs habilidades vs subagentes.

Las habilidades que vale la pena instalar

Las mejores habilidades codifican el conocimiento que tu equipo repite constantemente. Estas categorías se ganan su puesto en casi cualquier código base serio:

HabilidadQué haceCuándo se activa
Codebase overviewDescribe la arquitectura, directorios clave y convenciones para que Claude no tenga que leer docenas de archivos para orientarseAl inicio del trabajo en un área desconocida
Test runnerCodifica cómo ejecutar y filtrar la suite de pruebas, devolviendo solo los fallos en lugar de miles de líneas de salidaAl ejecutar o depurar pruebas
PR reviewAplica tu lista de revisión (seguridad, estilo, casos límite) en un orden constanteAl revisar un diff o preparar una PR
Migration playbookCaptura los pasos exactos y posibles problemas para una migración de base de datos o frameworkEn un cambio de esquema o actualización de dependencias
Doc generationConvierte código y comentarios en documentación siguiendo el formato de la empresaAl escribir o actualizar documentación
Data / file format handlingReglas para analizar y generar tus formatos CSV, JSON o propietariosAl procesar un archivo de datos o fixture

El porqué importa tanto como el qué, por lo que vale la pena examinar algunas en detalle:

Visión general del código base (Codebase overview)

La habilidad de mayor impacto en la mayoría de los repositorios. Define la arquitectura, los directorios principales, los límites de los módulos y las convenciones de nombres en unos pocos cientos de tokens, y se activa cada vez que Claude empieza a trabajar en una parte del código base que no ha visto en esa sesión, exactamente el momento en el que, de otro modo, abriría diez archivos para inferir la estructura. Esa inferencia es un coste directo en tokens de entrada sin ningún resultado tangible, por lo que reemplazarla con un mapa residente es uno de los beneficios más evidentes.

Ejecutor de pruebas y triaje de fallos (Test runner)

Una suite de pruebas puede generar miles de líneas de salida, y enviar todo ese contenido de vuelta supone un ruido costoso. Esta habilidad codifica el comando exacto, cómo delimitarlo al paquete relevante y cómo devolver únicamente los fallos y sus trazas de pila (stack traces). Se activa con cualquier solicitud para ejecutar, corregir o añadir pruebas, ahorrando tanto los tokens de salida de una ejecución completa como los turnos desperdiciados al reintentar tras un comando incorrecto.

Lista de verificación para revisión de PR (PR review)

La calidad de las revisiones disminuye cuando se improvisan. Una habilidad de revisión fija el orden y los criterios (primero la seguridad, luego la corrección y los casos límite, y finalmente el estilo) para que cada diff reciba la misma evaluación. Se activa cuando Claude revisa o prepara un cambio, y ahorra tokens al evitar que el modelo tenga que deducir tus estándares de nuevo y termine explorando archivos que la revisión no necesita.

Guía de migración (Migration playbook)

Los cambios de esquema, las actualizaciones de framework y los cambios de dependencias son donde residen los problemas no documentados. Una habilidad de migración captura los pasos ordenados, el rellenado de datos (backfill), el proceso de reversión (rollback) y las trampas específicas con las que tu entorno ha chocado antes. Se activa ante una migración o actualización. El ahorro de tokens aquí es secundario; el beneficio real es la precisión: el modelo sigue tu camino probado en lugar de uno plausible pero erróneo.

Documentación y manejo de formatos de datos

Una habilidad de generación de documentación convierte el código y los comentarios en documentos con el formato de tu empresa y se activa cada vez que se redacta documentación. Una habilidad de formato de datos codifica las reglas para tus fixtures CSV, JSON o propietarios (columnas requeridas, codificación, validación y casos límite), evitando que Claude tenga que reanalizar muestras para deducir un esquema que se le podría haber proporcionado directamente. Ninguno de estos son trucos complejos; son conocimiento institucional redactado una sola vez para que cada desarrollador, y cada sesión de Claude, lo aproveche gratis.

¿Ejecutas habilidades en todo un equipo en lugar de en un solo portátil?

Por qué las habilidades ahorran dinero y no solo tiempo

El coste de los tokens escala con el tamaño del contexto. Cada archivo que Claude lee para entender tu proyecto representa tokens de entrada que pagas, y un prompt vago en un código base desconocido puede desencadenar un análisis amplio y costoso. Una habilidad ataja ese proceso: en lugar de leer diez archivos candidatos para inferir tu arquitectura, Claude invoca la habilidad codebase-overview y obtiene la respuesta de inmediato.

El ahorro es acumulativo. En una suscripción, el trabajo consume de una cuota compartida por usuario (una ventana móvil de 5 horas más una semanal, que abarca Claude Code, chat y Cowork), por lo que una menor exploración significa más trabajo real antes de alcanzar un límite. En la API o en un proveedor cloud, se factura por token a tarifas como las de Sonnet 5.5 a $2 por entrada / $10 por salida por millón, por lo que cada lectura evitada es dinero que no gastas. Este mismo principio se explica en la guía de enrutamiento entre Opus, Sonnet y Haiku y en el seguimiento de costes para Claude Code.

Un matiz: en Amazon Bedrock, Google Vertex o Microsoft Foundry, el uso se factura por token directamente a tu cuenta cloud, y los paneles de control de Anthropic no lo muestran. Las habilidades reducen el recuento de tokens de la misma manera, pero para atribuir ese gasto por desarrollador necesitas OpenTelemetry o una pasarela LLM en la ruta, que es el rol que desempeña TrueFoundry AI Gateway.

Cómo escribir tu propia habilidad

Crear una habilidad es un proceso diseñado para ser sencillo. El frontmatter le asigna un nombre y, fundamentalmente, describe cuándo debe activarse; esa descripción es lo que Claude compara para determinar la coincidencia:

En resumen, los pasos son: (1) elige una tarea repetitiva; si se la has explicado a los nuevos miembros más de dos veces, es una buena candidata; (2) crea .claude/skills/<nombre>/SKILL.md en el repositorio para que viaje junto con el código; (3) escribe una descripción del contexto o situación, no del mecanismo (“Usar al ejecutar o depurar pruebas” se activa de forma fiable; “Utilidades de prueba” no lo hace); (4) incluye instrucciones concretas en el cuerpo y divide el material de referencia largo en archivos vinculados que solo se carguen cuando sean necesarios; (5) prueba la activación con una tarea que deba ejecutarla y con otra que no, y ajusta la descripción hasta que solo se cargue cuando realmente justifique el uso de tokens.

Una habilidad que pretende aplicarse a todo se cargará constantemente, anulando su propósito. Analizamos este concepto con más detalle en qué son las Claude Skills.

Gobernanza de habilidades en un equipo

La habilidad de un desarrollador en su portátil es una ventaja personal. Treinta copias desincronizadas son un riesgo: nadie sabe qué versión es la correcta y una instrucción errónea se propaga en silencio. A escala de equipo, conviene que las habilidades estén versionadas, compartidas y con control de acceso en un único lugar, del mismo modo que se gestiona el código.

Eso es lo que proporciona un registro de habilidades: una única fuente de verdad para los paquetes SKILL.md, con control de versiones y permisos a nivel de repositorio, publicados una vez y utilizados por todos los desarrolladores y agentes. Esto transforma una habilidad de un archivo personal a un artefacto gobernado: puedes ver quién publicó una versión, revertir una defectuosa y asegurarte de que todos apliquen la misma guía. Hemos desarrollado exactamente esto; consulta explicación del registro de habilidades de TrueFoundry y por qué introdujimos un registro de habilidades reutilizables.

El registro resuelve la distribución y el versionado; la pasarela gestiona el resto. Al combinarlo con una pasarela de IA, obtienes atribución por desarrollador, políticas de modelos, límites de gasto y un único plano de control entre proveedores: gobernanza sobre qué herramientas, habilidades y modelos puede utilizar cada desarrollador, con solo unos 3–4 ms de latencia adicional y trazas compatibles con OpenTelemetry. Esto es especialmente crítico en Bedrock, Vertex o Foundry, donde los paneles nativos no pueden atribuir el gasto individualmente.

AspectoEn portátiles individualesEn un registro + pasarela (gateway)
Fuente de verdadCada copia es independiente; la desalineación es invisibleUna versión publicada que todos utilizan
Control de versionesAd hoc; sin historial ni opción de reversiónVersionado, con posibilidad de reversión y trazabilidad auditable
Control de accesoCualquiera puede editar su propia copiaSe controla quién tiene permiso de publicación
Atribución de costesNinguna por desarrollador, especialmente en la nubeGasto detallado por desarrollador en cada proveedor
Alcance de instrucciones erróneasSilencioso e ilimitadoSe detecta en la revisión antes de su despliegue

Este patrón refleja la forma en que las empresas ya gestionan otras herramientas de desarrollo basadas en IA: el mismo plano de control que centraliza el control de costes y observabilidad para Claude Code, Cursor, Gemini CLI y demás se extiende de forma natural a las habilidades que consumen dichas herramientas.

Errores comunes a tener en cuenta

  • Una descripción demasiado amplia es contraproducente. Una habilidad que coincide con todo se carga en cada tarea y satura el contexto, lo opuesto al objetivo perseguido. Define el activador con precisión.
  • Las habilidades son conocimiento, no acciones. Si una habilidad necesita interactuar con una API o base de datos, ese es el trabajo de una herramienta MCP; la habilidad debe guiar a Claude sobre cómo usarla, no intentar asumir esa función.
  • No vuelques CLAUDE.md en una habilidad sin cambios. El beneficio radica en mover instrucciones situacionales fuera del contexto permanente; mantén los elementos esenciales continuos en su lugar correspondiente.
  • Las habilidades sin versión se desalinean. Las copias en máquinas individuales divergen; trata las habilidades como artefactos compartidos con una única fuente de verdad.
  • Las habilidades superpuestas confunden la activación. Dos habilidades con descripciones casi idénticas generan ambigüedad en la coincidencia; asigna a cada una un alcance claro y diferenciado.

Lecturas relacionadas

Conclusión

Las mejores Claude Code skills no son las más complejas, sino las que documentan lo que tu equipo ya sabe para que nadie, sea humano o modelo, tenga que redescubrirlo. Una buena habilidad se carga exactamente cuando es relevante, le entrega la respuesta a Claude y vuelve a retirarse, manteniendo el contexto reducido y el gasto bajo.

El mayor riesgo no es escribir pocas habilidades, sino permitir que se dispersen por los portátiles sin versionado, revisión ni control sobre quién las publica. Trata las habilidades como código (una sola fuente de verdad, versionada y gobernada) y se convertirán en una ventaja sostenible en lugar de un inconveniente.

Proporciona a cada desarrollador las mismas habilidades gobernadas y una visión unificada de los costes.

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Inscríbase
Tabla de contenido

Controle, implemente y rastree la IA en su propia infraestructura

Reserva 30 minutos con nuestro Experto en IA

Reserve una demostración

La forma más rápida de crear, gobernar y escalar su IA

Demo del libro
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Descubra más

No se ha encontrado ningún artículo.
noviembre 20, 2026
|
5 minutos de lectura

GPT-6.1 Terra: API, benchmarks, precios y cómo usarlo

No se ha encontrado ningún artículo.
noviembre 20, 2026
|
5 minutos de lectura

Alternativas a Bifrost: las mejores herramientas que puede considerar en 2026

No se ha encontrado ningún artículo.
noviembre 20, 2026
|
5 minutos de lectura

GPT-5.1 frente a GPT-5: 9 mejoras clave que debes conocer

LLMS y GenAI
TrueFoundry AI gateway is an enterprise alternative to Bifrost and Portkey
noviembre 20, 2026
|
5 minutos de lectura

Bifrost vs. Portkey: comparativa de precios, funciones de AI Gateway e idoneidad empresarial

No se ha encontrado ningún artículo.
No se ha encontrado ningún artículo.
Realice un recorrido rápido por el producto
Comience el recorrido por el producto
Visita guiada por el producto