Claude Code Skills Guide: Build Custom AI Workflows 2026

Resumen rápido: Las Claude Code Skills son archivos de instrucciones modulares que extienden las capacidades de codificación de Claude al enseñarle flujos de trabajo personalizados, estándares de codificación y tareas específicas del dominio. La configuración de Claude Code y las instrucciones personalizadas se gestionan principalmente a través del archivo CLAUDE.md en la raíz del proyecto o a través de los servidores del Protocolo de Contexto del Modelo (MCP).

Claude Code se ha convertido en algo más que otro asistente de codificación de IA. Según la documentación oficial, Claude sobresale en tareas que involucran lenguaje, razonamiento, análisis y codificación, pero esto es lo que la mayoría de los desarrolladores pasan por alto: la extensibilidad de la plataforma a través de Skills transforma una herramienta útil en una potencia de desarrollo personalizada.

Las Skills representan un cambio fundamental en la forma en que funcionan los asistentes de IA. En lugar de explicar repetidamente tus preferencias, estándares de codificación o flujos de trabajo complejos, los codificas una vez. Claude aplica este conocimiento automáticamente cada vez que aparece el contexto relevante.

El momento no podría ser mejor. La comunidad de desarrolladores ha creado Skills especializadas, y Anthropic continúa expandiendo el ecosistema de Skills. Pero la función sigue estando sorprendentemente infrautilizada: las discusiones de la comunidad sugieren que una parte significativa de los usuarios de Claude Code puede no ser consciente de las Skills.

¿Qué son las Claude Code Skills y por qué son importantes?

Las Agent Skills son capacidades modulares empaquetadas como archivos Markdown que extienden la funcionalidad de Claude. Cada Skill agrupa instrucciones, metadatos y recursos opcionales que Claude utiliza automáticamente cuando son relevantes.

Piensa en las Skills como módulos de aprendizaje. Cuando instalas una Skill, Claude adquiere conocimientos especializados sobre cómo manejar tareas específicas dentro de tus proyectos. Esto sucede sin indicaciones manuales: Claude reconoce cuándo se aplica una Skill e incorpora sus instrucciones sin problemas.

Según la documentación oficial de Claude Code, las Skills admiten sustitución de cadenas para valores dinámicos en el contenido de la Skill. Esto permite una automatización flexible y consciente del contexto que se adapta a diferentes escenarios.

El sistema de carga de tres niveles

Las Skills utilizan un enfoque de carga jerárquico que equilibra la capacidad con la eficiencia:

Este sistema escalonado significa que tu ventana de contexto se mantiene eficiente. Los metadatos se cargan inmediatamente para que Claude sepa qué Skills existen, pero las instrucciones detalladas solo consumen tokens cuando son realmente necesarios.

¿Cómo se diferencian las Skills de otros métodos de personalización?

Claude Code ofrece varios enfoques de personalización. Las Skills ocupan un nicho específico:

• Los archivos CLAUDE.md almacenan instrucciones y contexto de todo el proyecto que siempre se cargan. Úsalos para información de alto nivel del proyecto, decisiones arquitectónicas y directrices persistentes que se aplican ampliamente.
• Los comandos barra diagonal son atajos invocados manualmente almacenados en .claude/commands/. Estos requieren una acción explícita del usuario para activarse.
• Las Skills se activan automáticamente según el contexto. Son perfectas para flujos de trabajo especializados que deben aplicarse en situaciones específicas sin intervención manual.
• Los subagentes se ejecutan como instancias de agente separadas con su propio contexto, selección de modelo y acceso a herramientas. Según la documentación oficial, los subagentes ayudan a gestionar tareas complejas delegando a agentes especializados.

Skills integradas que vienen con Claude Code

Claude Code incluye varias Skills empaquetadas que demuestran las capacidades del sistema. Estas manejan flujos de trabajo de desarrollo comunes de inmediato.

La Skill /batch orquesta cambios a gran escala en una base de código en paralelo. Investiga la base de código, descompone el trabajo en 5 a 30 unidades independientes y presenta un plan antes de la ejecución. Esto resulta particularmente valioso para operaciones de refactorización o para aplicar cambios consistentes en múltiples archivos.

Las Skills integradas cumplen un doble propósito. Proporcionan utilidad inmediata y ofrecen plantillas para la creación de Skills personalizadas. Examinar su estructura revela las mejores prácticas para la claridad de las instrucciones, la organización de recursos y la configuración de metadatos.

Encuentra créditos de Claude y herramientas de IA en un solo lugar

Si estás investigando las Claude Code Skills, también puede ser útil ver qué ventajas están disponibles para Claude y otras herramientas en tu flujo de trabajo. Get AI Perks recopila créditos iniciales y descuentos de software para herramientas de IA y en la nube en un solo lugar. La plataforma ofrece a los fundadores acceso a más de 200 ofertas, junto con requisitos, orientación de aprobación e instrucciones para reclamarlas.

¿Buscas créditos y ventajas de Claude?

Consulta Get AI Perks para:

• Navegar por las ofertas de Claude y Anthropic
• Comparar las condiciones de las ventajas de las herramientas de IA
• Encontrar otros descuentos de software para startups en un solo lugar

👉 Visita Get AI Perks para explorar las ventajas actuales de las herramientas de IA.

Crea tu primera Skill personalizada en cinco minutos

Construir una Skill básica requiere una configuración mínima. El proceso sigue un patrón sencillo que se vuelve natural después del primer intento.

Paso uno: Crea el directorio de Skills

Navega hasta la raíz de tu proyecto y crea la estructura del directorio de Skills:

Este directorio .claude sirve como ubicación central de configuración para las personalizaciones de Claude Code. El subdirectorio skills alberga todos tus archivos SKILL.md.

Paso dos: Escribe tu primer archivo SKILL.md

Crea un nuevo archivo en .claude/skills/code-review.md con esta estructura:

Al revisar código:
1. Busca vulnerabilidades de seguridad comunes (inyección SQL, XSS, problemas de autenticación)
2. Identifica cuellos de botella de rendimiento (consultas N+1, algoritmos ineficientes)
3. Verifica el manejo de errores y los casos extremos
4. Evalúa la mantenibilidad y legibilidad del código
5. Sugiere mejoras específicas con ejemplos de código

El frontmatter YAML (entre los marcadores —) define los metadatos. El nombre aparece cuando Claude hace referencia a la Skill. La descripción ayuda a Claude a determinar cuándo se aplica esta Skill.

Todo lo que está debajo del frontmatter se convierte en el conjunto de instrucciones que Claude sigue cuando la Skill se activa.

Paso tres: Prueba la Skill

Inicia Claude Code en el directorio de tu proyecto. La Skill se carga automáticamente. Pídele a Claude que revise un archivo de código y aplicará las directrices de la Skill code-review sin indicaciones adicionales.

Eso es todo. Tres pasos, cinco minutos, y has ampliado las capacidades de Claude con lógica personalizada.

Patrones avanzados de Skills y sustitución de cadenas

Las Skills básicas funcionan bien para instrucciones estáticas. El verdadero poder surge cuando las Skills se adaptan dinámicamente a diferentes contextos.

Argumentos dinámicos con sustitución de cadenas

Las Skills admiten sustitución de variables que inyecta valores en tiempo de ejecución en las instrucciones. La documentación oficial define estas sustituciones disponibles:

• $ARGUMENTS captura todos los argumentos pasados al invocar la Skill. Si $ARGUMENTS no aparece en el contenido, los argumentos se añaden automáticamente como ARGUMENTS: <valor>.
• $ARGUMENTS[N] accede a un argumento específico por posición (indexado desde cero).

Aquí tienes un ejemplo práctico: una Skill de migración de bases de datos que acepta nombres de tablas:

Cuando se invoca con argumentos, Claude sustituye los valores antes de procesar las instrucciones. Esto elimina las indicaciones repetitivas para tareas similares con diferentes parámetros.

Empaquetado de recursos para Skills complejas

Las Skills pueden hacer referencia a recursos externos: plantillas, scripts o documentación de referencia. Estos recursos se cargan bajo demanda (Nivel 3 en la jerarquía de carga), manteniendo el contexto eficiente hasta que sea realmente necesario.

Crea un directorio de recursos junto a tu archivo SKILL.md:

Haz referencia a estos recursos dentro de las instrucciones de la Skill. Claude los carga al procesar esa sección de las instrucciones.

Skills esenciales que todo desarrollador debería tener

Ciertos patrones de desarrollo se repiten con suficiente frecuencia como para que las Skills preconstruidas proporcionen un valor inmediato. Basándose en las discusiones de la comunidad y el repositorio oficial de Skills, estas categorías resultan las más beneficiosas.

Skills de calidad de código y revisión

La revisión automatizada de código detecta problemas antes de la revisión humana. Una Skill de revisión integral podría comprobar:

• Vulnerabilidades de seguridad específicas de tu pila
• Antipatrones de rendimiento en tu base de código
• Consistencia con los estándares de codificación del equipo
• Lagunas en la cobertura de pruebas
• Completitud de la documentación

Las Skills de validación de seguridad mencionadas en recursos comunitarios demuestran altas tasas de precisión en la detección de vulnerabilidades.

Pruebas y garantía de calidad

Las Skills de pruebas automatizan la generación de pruebas basándose en tus preferencias de framework. Una Skill de pruebas bien diseñada entiende:

• Tu framework de pruebas (Jest, Pytest, RSpec)
• Requisitos de cobertura y umbrales
• Patrones y estrategias de mocking
• Identificación de casos extremos
• Distinciones entre pruebas de integración y unitarias

Generación de documentación

La documentación a menudo se queda atrás respecto a los cambios de código. Las Skills pueden mantener la consistencia generando automáticamente:

• Documentación de API a partir de comentarios de código
• Archivos README a partir de la estructura del proyecto
• Entradas de registro de cambios a partir de mensajes de commit
• Comentarios de código en línea para lógica compleja

Skills específicas del framework

Las Skills específicas del dominio codifican las mejores prácticas para frameworks o bibliotecas particulares. Estas garantizan que Claude aplique las convenciones del framework correctamente sin recordatorios constantes.

Las Skills de React podrían imponer patrones de uso de hooks. Las Skills de Django podrían garantizar el uso adecuado del ORM y la gestión de migraciones. Las Skills de ciencia de datos, como se menciona en la documentación oficial, pueden deshabilitar explícitamente las herramientas de ejecución de código y centrarse en los flujos de trabajo de análisis.

Configuración y gestión de Skills

A medida que las colecciones de Skills crecen, la organización se vuelve crítica. Claude Code proporciona varios mecanismos para gestionar Skills en diferentes ámbitos.

Descubrimiento y carga de Skills

Según la documentación oficial, las Skills se pueden configurar en varios niveles con prioridad definida:

Este sistema de prioridades permite anulaciones específicas de la sesión mientras se mantienen valores predeterminados sensatos. Las Skills del proyecto anulan las Skills del usuario, evitando que las configuraciones globales entren en conflicto con los requisitos específicos del proyecto.

Compartir Skills entre equipos

Los equipos se benefician de Skills estandarizadas. Varios enfoques de distribución funcionan bien:

• Control de versiones: Guarda .claude/skills/ en tu repositorio. Los miembros del equipo reciben automáticamente las actualizaciones de Skills al extraer los cambios.
• Repositorio centralizado: Mantén un repositorio de Skills del equipo al que hagan referencia los proyectos. Utiliza submodules de git o gestión de paquetes para distribuir actualizaciones.
• Empaquetado de plugins: Agrupa Skills relacionadas en plugins para facilitar la distribución y la gestión de versiones.
• El repositorio oficial de Skills de Anthropic en GitHub demuestra este patrón. Contiene Skills aportadas por la comunidad que cualquiera puede consultar o clonar.

Skills vs. Subagentes: Cuándo usar cada uno

Las Skills y los subagentes extienden las capacidades de Claude, pero sirven a diferentes necesidades arquitectónicas. Comprender la distinción evita implementaciones torpes.

Las Skills funcionan dentro del contexto principal de la conversación. Modifican la forma en que Claude aborda las tareas, pero no crean instancias de agente separadas. Usa Skills cuando:

• Agregues conocimiento especializado a la conversación principal
• Apliques estándares o convenciones
• Proporciones plantillas o patrones
• Automatices flujos de trabajo sencillos

Los subagentes se ejecutan como instancias de agente independientes con contexto aislado. Según la documentación oficial, los subagentes admiten la compactación automática utilizando la misma lógica que la conversación principal, con la compactación automática activándose al 95% de capacidad aproximadamente por defecto.

Usa subagentes cuando:

• Las tareas requieran diferentes selecciones de modelo (Haiku para tareas simples, Opus para razonamiento complejo)
• El aislamiento del contexto evite confusiones
• La ejecución paralela acelere los flujos de trabajo
• El acceso a herramientas especializadas deba restringirse

La documentación oficial proporciona ejemplos como el subagente Bash (para ejecutar comandos de terminal en un contexto separado) y statusline-setup (que utiliza Sonnet al configurar líneas de estado).

Aquí está el marco de decisión: si Claude necesita diferentes capacidades o límites de contexto, usa subagentes. Si Claude necesita conocimientos especializados dentro de la conversación actual, usa Skills.

Integración con el Protocolo de Contexto del Modelo

El Protocolo de Contexto del Modelo (MCP) proporciona otro mecanismo de extensión. Las Skills y MCP cumplen propósitos complementarios.

Los servidores MCP exponen fuentes de datos y herramientas externas a Claude. Manejan la autenticación, la recuperación de datos y las interacciones API. Piensa en MCP como la expansión de lo que Claude puede acceder.

Las Skills definen cómo Claude debe utilizar las capacidades disponibles. Codifican flujos de trabajo, estándares y conocimientos de dominio. Piensa en Skills como la expansión de lo que Claude sabe hacer.

Los dos sistemas trabajan juntos. Un servidor MCP podría proporcionar acceso al sistema de documentación interna de una empresa. Una Skill enseña a Claude cómo escribir documentación que coincida con los estándares de la empresa y publicarla a través del servidor MCP.

Según la documentación oficial, las Skills se pueden limitar a servidores MCP específicos, lo que permite un control detallado sobre qué Skills se activan cuando hay fuentes de datos particulares disponibles.

Optimización del rendimiento y gestión de tokens

Las Skills consumen tokens de contexto. Las Skills mal diseñadas pueden inflar las ventanas de contexto y ralentizar los tiempos de respuesta.

Conciencia del presupuesto de tokens

Según la documentación oficial, el pensamiento utiliza un presupuesto fijo de hasta 31.999 tokens del presupuesto de salida en modelos más antiguos. El sistema de carga de tres niveles ayuda a gestionar esto:

Los metadatos de Nivel 1 (~100 tokens por Skill) se cargan siempre. Mantén las descripciones concisas pero lo suficientemente informativas para que Claude determine la relevancia.

Las instrucciones de Nivel 2 se cargan cuando se activan. Escribe instrucciones centradas que aborden el propósito específico de la Skill sin información tangencial.

Los recursos de Nivel 3 se cargan bajo demanda. Agrupa materiales de referencia extensos como recursos en lugar de incrustarlos en las instrucciones.

Configuración del nivel de esfuerzo

Claude Code permite ajustar el nivel de esfuerzo que afecta la profundidad del pensamiento. Según la documentación oficial, esta es la forma recomendada de ajustar el equilibrio entre la velocidad y la profundidad del razonamiento.

Para Skills complejas que requieren un razonamiento profundo, considera incrustar la palabra clave ultrathink en las instrucciones de la Skill. Esto asegura que Claude aplique el esfuerzo adecuado sin intervención manual.

Patrones de implementación en el mundo real

La teoría importa menos que la práctica. Estos patrones surgen de despliegues en producción.

El patrón de especialista en depuración

Crea una Skill de depuración dedicada que aplique la solución de problemas sistemática. La documentación oficial sugiere una estructura como:

Para cada problema, proporciona: Explicación de la causa raíz, evidencia que respalda el diagnóstico, corrección de código específica, enfoque de prueba, recomendaciones de prevención. Enfócate en solucionar el problema subyacente, no los síntomas.

Este patrón cambia a Claude de sugerir soluciones rápidas hacia la resolución integral de problemas.

El patrón de procesamiento por lotes

Para operaciones que afectan a varios archivos, aprovecha la Skill integrada /batch o crea patrones similares. El procesamiento por lotes:

• Investiga el alcance completo antes de comenzar
• Descompone el trabajo en unidades independientes
• Presenta el plan de ejecución para su revisión
• Ejecuta los cambios en paralelo cuando sea posible

Este enfoque evita errores en cascada y permite la reversión si el plan resulta incorrecto.

El patrón de aplicación de estándares

Codifica las convenciones del equipo como Skills que se activan automáticamente. Una Skill de estándares de TypeScript podría hacer cumplir:

• Anotaciones de tipo estrictas en los parámetros de las funciones
• Tipos de retorno explícitos para funciones exportadas
• Patrones de manejo de errores consistentes
• Organización específica de importaciones

Estas Skills actúan como revisores de código automatizados, detectando violaciones de convenciones antes de la revisión humana.

Skills para flujos de trabajo científicos y de investigación

Los equipos de investigación tienen requisitos únicos. Según el estudio de caso oficial sobre cómo los científicos utilizan Claude, el Laboratorio Lundberg en Stanford utiliza Claude para invertir la generación de hipótesis convencional.

En lugar de curar manualmente listas de genes, utilizan Claude para explorar sistemáticamente posibilidades basadas en la literatura y los datos. Según el estudio de caso de Anthropic, las pantallas enfocadas representan inversiones financieras significativas para los laboratorios de investigación. Las Skills pueden codificar esta metodología de investigación.

Una Skill de investigación podría:

• Buscar sistemáticamente en bases de datos de literatura
• Cruzar hallazgos entre estudios
• Generar hipótesis basadas en patrones de datos
• Sugerir diseños experimentales
• Formatear resultados para su publicación

El ejemplo del científico de datos de la documentación oficial muestra cómo crear subagentes específicos del dominio que deshabilitan explícitamente las herramientas de ejecución de código y se centran en los flujos de trabajo de análisis.

Solución de problemas comunes de Skills

Las Skills ocasionalmente se comportan mal. La mayoría de los problemas se reducen a un puñado de causas comunes.

Skill no se carga

Verifica la ubicación y el nombre del archivo. Las Skills deben residir en .claude/skills/ con extensión .md. Asegúrate de que el frontmatter utilice sintaxis YAML válida: un dos puntos faltante o una indentación incorrecta rompen el análisis.

Ejecuta Claude Code con registro detallado para ver qué Skills se cargaron correctamente. Las Skills que faltan suelen indicar problemas de ruta de archivo o de permisos.

Skill se activa incorrectamente

Las descripciones demasiado generales hacen que las Skills se activen en contextos no deseados. Haz que las descripciones sean específicas sobre cuándo se aplica la Skill.

En lugar de "ayuda con el trabajo de la base de datos", escribe "crea migraciones de PostgreSQL siguiendo nuestras convenciones de versión de esquema".

Instrucciones ignoradas

Claude podría no seguir las instrucciones de la Skill si entran en conflicto con indicaciones explícitas del usuario. Las instrucciones del usuario siempre tienen prioridad sobre los valores predeterminados de la Skill.

Alternativamente, las instrucciones pueden ser demasiado vagas. Ejemplos concretos dentro del contenido de la Skill mejoran significativamente la adherencia. Muestra a Claude cómo se ve la buena salida.

Presupuesto de tokens excedido

Demasiadas Skills o instrucciones demasiado verbosas agotan el contexto. Audita las Skills cargadas: elimina las que se usan raramente. Mueve materiales de referencia detallados a recursos de Nivel 3.

La variable de entorno CLAUDE_AUTOCOMPACT_PCT_OVERRIDE puede desencadenar la compactación antes si el contexto se llena regularmente.

El impacto en la formación de habilidades de los desarrolladores

Anthropic publicó investigaciones que examinan cómo la asistencia de IA impacta el desarrollo de habilidades de codificación. El estudio, un ensayo controlado aleatorio con desarrolladores de software, investigó si la descarga cognitiva previene el crecimiento de habilidades.

Según la investigación, los participantes que encontraron más errores probablemente mejoraron sus habilidades de depuración al resolver estos errores de forma independiente. Cuando se agruparon por patrones de interacción con IA, la alta dependencia de la IA para la generación o depuración de código se correlacionó con puntuaciones promedio en cuestionarios inferiores al 40%.

La investigación señala: "Los beneficios de productividad pueden venir a costa de las habilidades necesarias para validar el código escrito por IA si el desarrollo de habilidades de los ingenieros junior se ha visto frenado por el uso de IA en primer lugar".

Este hallazgo tiene implicaciones para el diseño de Skills. Las Skills deben aumentar la experiencia, no reemplazar el aprendizaje. Considera estas directrices:

Explica, no solo ejecutes: Las Skills deben incluir contexto educativo explicando por qué funcionan ciertos enfoques.

Fomenta la verificación: Incorpora pasos de revisión en los flujos de trabajo de Skills en lugar de asumir la corrección automática.

Divulgación progresiva: Los desarrolladores junior pueden beneficiarse de Skills más verbosas que enseñen conceptos, mientras que los desarrolladores senior prefieren Skills concisas y orientadas a la acción.

Direcciones futuras y crecimiento del ecosistema

El ecosistema de Skills continúa expandiéndose. Las Skills aportadas por la comunidad se están proliferando. El repositorio oficial de Anthropic Skills demuestra cómo la colaboración abierta acelera el crecimiento de capacidades. Los desarrolladores aportan Skills especializadas para frameworks, lenguajes y flujos de trabajo de nicho.

Los sistemas de plugins están madurando. Según la documentación oficial, las Skills se pueden empaquetar con comandos personalizados, agentes y servidores MCP mediante programación a través de plugins. Esto permite paquetes de capacidades complejas distribuidos como unidades únicas.

Están surgiendo colecciones de Skills específicas de dominio. Equipos de investigación médica, analistas financieros y grupos de computación científica están creando bibliotecas de Skills especializadas que codifican las mejores prácticas específicas del campo.

La integración con pipelines de CI/CD se está expandiendo. Las Skills que realizan revisiones automáticas de código, escaneo de seguridad y verificación de cumplimiento se están incorporando en flujos de trabajo automatizados.

Preguntas frecuentes

Conclusión: Construye tu estrategia de Skills

Las Claude Code Skills transforman la asistencia de codificación de IA de reactiva a proactiva. En lugar de recordar constantemente a Claude sus preferencias y estándares, codifícalos una vez. Claude aplica este conocimiento automáticamente, de manera consistente y fiable.

Empieza poco a poco. Crea una Skill que aborde tu indicación manual más frecuente. Pruébala. Refínala. Luego, amplía gradualmente.

Las implementaciones de Skills más exitosas comparten características comunes: resuelven puntos débiles reales, se mantienen como código (con control de versiones, revisadas, documentadas) y equilibran la automatización con el aprendizaje.

Las Skills representan más que atajos de productividad. Son sistemas de captura de conocimiento que preservan la experiencia del equipo en forma ejecutable. A medida que los equipos evolucionan, las Skills documentan no solo qué hacer, sino por qué.

¿Listo para empezar? Crea .claude/skills/ en tu proyecto actual. Escribe una Skill sencilla que aborde una tarea recurrente. Inicia Claude Code y obsérvalo trabajar. Ese es el comienzo de un flujo de trabajo de desarrollo más inteligente.

Explora el repositorio oficial de Anthropic Skills para ver ejemplos aportados por la comunidad. Revisa la documentación de Claude Code para patrones avanzados. Únete a discusiones sobre estrategias de implementación y comparte lo que funciona para tu equipo.

El ecosistema de Skills se fortalece con cada contribución. Crea algo útil, luego compártelo.