Las habilidades de codificación de ClaudeSe trata de archivos de instrucciones en formato Markdown (.md) que transforman a Claude en un experto en cualquier campo. En lugar de repetir las mismas instrucciones cada vez que abres la terminal, instala una habilidad y Claude comienza a responder con marcos, reglas y contexto profesional, automáticamente, sin tener que copiar y obtener nada.
Si alguna vez has utilizado Claude Code para escribir código, crear textos o analizar datos, sabes que el resultado depende en gran medida de cómo lleves a cabo la solicitud. Las habilidades resuelven este problema: dale a Claude el contexto que necesitaantesque preguntes cualquier cosa.
En esta guía, explicaré en detalle técnico cómo funcionan las habilidades en Claude Code, cuál es la estructura de archivos, cómo Claude detecta y carga estas instrucciones y cómo instalarlo y comenzar a usarlo hoy.
¿Qué son las habilidades en Claude Code?
Skills for Claude Code son archivos de texto en formato Markdown que contienen instrucciones especializadas. Cada habilidad funciona como un "manual del experto" que Claude lee antes de responder a sus preguntas.
En la práctica, una habilidad y un archivo..mddentro de una carpeta específica de su proyecto o sistema. Cuando Claude Code inicia una sesión, escanea estas carpetas, identifica los archivos de habilidades y carga el contenido como contexto adicional.
La diferencia con un mensaje común y fundamental:
- Mensaje común:escribes instrucciones cada vez. Si cierras la terminal, lo pierdes todo. El contexto desaparece.
- Habilidad:archivo permanente en su disco. Claude carga automáticamente. Nunca más necesitarás repetir esa instrucción.
Piense en las habilidades como la diferencia entre contratar a un profesional independiente sin una sesión informativa (prompt) y contratar a un profesional que ya ha leído todo el manual de su empresa (habilidad). El segundo ofrecerá mejores resultados desde el primer día.
Las habilidades pueden contener cualquier tipo de instrucción:fraseología, reglas técnicas de SEO, estándares de código, plantillas de correo electrónico, listas de verificación de auditoría, flujos de trabajo de desarrollo completos. No hay límite para lo que una habilidad puede enseñarle a Claude.
Cómo Claude Code detecta las habilidades
Claude Code tiene un sistema automático de detección de habilidades. Cuando inicia una sesión, busca archivos de instrucciones en ubicaciones específicas del sistema de archivos. El orden de prioridad es:
- Alfombra del proyecto:
.claude/skills/dentro del directorio de su proyecto actual - Tarjeta de usuario global:
~/.claude/skills/en el directorio de inicio del usuario
El mecanismo funciona así: al iniciar Claude Code en un directorio, verifica si la carpeta existe.claude/. Si existe, lee los archivos dentro.claude/skills/. Archivos con la extensión.mdSe interpretan como habilidades y se llevan a cabo en el contexto de la conversación.
Esto significa que puedes tener habilidadespor proyecto(útil para reglas específicas para un cliente o repositorio) y habilidadesglobal(útil para las reglas que desea en cada sesión, como su estilo de código preferido o tono de voz).
# 1. Habilidades para proyectos (específicas)
./projeto/.claude/skills/
# 2. Habilidades Globales (todas las sesiones)
~/.claude/habilidades/
# Claude lee TODOS los archivos .md de estas carpetas
# y se carga como contexto automáticamente
Cuando Claude encuentra un archivo de habilidades, no solo lee el texto: interpreta las instrucciones comoreglas de comportamiento. Si una habilidad dice "responda siempre en portugués y use un tono profesional", Claude la seguirá durante toda la sesión.
Estructura de carpetas y archivos
La organización de habilidades en el sistema de archivos sigue un patrón simple. Vea la estructura típica de un proyecto con habilidades instaladas:
├── .claude/
├ ├── habilidades/
├ ├ ├── redacción.md
├ ├ ├── seo-tecnico.md
├ ├ ├── google-ads.md
├ ├ └── marketing-correo electrónico.md
├ └── configuración.json
├── src/
└── índice.html
Cada archivo.mdadentro.claude/skills/y una habilidad independiente. El nombre del archivo no importa para la operación: Claude lee el contenido, no el nombre. Pero es una buena práctica utilizar nombres descriptivos para ayudarle a mantenerse organizado.
Puedes tener tantas habilidades como quieras en una carpeta. Claude los lleva a todos. Si dos habilidades tienen instrucciones contradictorias, la más específica (la del proyecto) tiene prioridad sobre la global.
Habilidades Globales vs. Habilidades del proyecto Global Skills
Cuándo usar cada uno:
- habilidades globales (
~/.claude/skills/): reglas que deseas en CADA sesión. Ejemplo: "responder siempre en portugués", "usar tabuladores en lugar de espacios", "mi tono de voz es profesional y directo". - Habilidades de proyecto (
./projeto/.claude/skills/): reglas específicas para ese repositorio. Ejemplo: "este proyecto usa Next.js 14 con App Router", "la marca del cliente es formal", "el seguimiento usa GTM del lado del servidor".
Formato de archivo SKILL.md
Una habilidad y un archivo Markdown común. No existe un formato rígido: cualquier instrucción de texto funciona. Pero hay una estructura que produce mejores resultados, según cómo Claude interpreta el contexto.
Un expediente de habilidades bien estructurado suele tener:
# SEO técnico: habilidad para Claude Code
## Papel
Eres un experto técnico en SEO con más de 10 años.
de experiencia en auditoría de sitios web, Core Web Vitals
y optimización del seguimiento.
## Normas
- Siempre priorice el móvil primero
- Utilice datos estructurados de Schema.org cuando corresponda
- Recomendar URL canónicas para evitar contenido duplicado.
- Nunca sugiera técnicas de sombrero negro.
## Marcos de referencia
- Core Web Vitals: LCP < 2,5 s, CLS < 0,1, ENT < 200 ms
- Lista de verificación de auditoría: [lista de más de 20 elementos]
- Plantilla de informe: [formato estándar]
## Ejemplos de salida
[ejemplos de formato de respuesta esperado]
Los bloques más importantes de una habilidad son:
- Role:define quién "es" Claude en esta habilidad. Cuanto más específico, mejor será el resultado.
- Normas:límites y pautas que Claude debe seguir. Qué hacer y qué NO hacer.
- Marcos:modelos, plantillas, listas de verificación y referencias técnicas que Claude debe utilizar.
- Ejemplos:muestras de resultados esperados. Esto calibra el nivel de detalle y formato de las respuestas.
También puede incluir: enlaces a documentación, tablas de referencia, fragmentos de código, flujos de trabajo paso a paso. Cuanto más contexto útil tenga la habilidad, más preciso se volverá Claude.
¿Quieres dominar esto más rápido?
Todo lo que estás aprendiendo aquí se vuelve 10 veces más poderoso con habilidades ya preparadas. En lugar de escribir comandos manualmente, las habilidades hacen el trabajo pesado. Más de 748 habilidades profesionales.
Quiero las Habilidades — R$ 19Cómo instalar habilidades en Claude Code
Instale habilidades en Claude Code y copie archivos a una carpeta. No hay compilación, compilación, instalación de npm ni ningún otro paso técnico. Todo el proceso dura menos de 2 minutos.
Paso 1: Crea la carpeta de habilidades (si no existe)
$ mkdir -p ~/.claude/skills
# Para habilidades de proyecto (solo este repositorio):
$ mkdir -p .claude/skills
Paso 2: copia los archivos de habilidades
$ cp redacción publicitaria.md ~/.claude/skills/
# Copiar un paquete de habilidades completo:
$ cp -r habilidades/* ~/.claude/skills/
Paso 3: abre el código Claude
Código Claude v1.x
# Claude ya ha cargado las habilidades automáticamente.
# No se requiere configuración adicional.
> escribir un título para una página de destino SaaS
# Con la habilidad de redacción publicitaria instalada, Claude usará
# marcos como PAS, AIDA, 4Us automáticamente, sin
# necesitas preguntar.
Listo. No hay paso 4. Las habilidades están instaladas y Claude Code ya las está usando.
Ejemplos prácticos de habilidades en acción
Para mostrar la diferencia que hace una habilidad, observe la misma solicitud con y sin una habilidad instalada:
Ejemplo 1: redacción publicitaria: sin habilidad
Aprenda marketing digital de cero a avanzado
# Genérico. Sin marco. Sin especificidad.
Ejemplo 1: Redacción publicitaria: con la habilidad instalada
Cómo generar 3 veces más clientes potenciales en 30 días usando lo mismo
Herramientas que ya tiene, incluso si nunca las tuvo
Publicar un anuncio en la vida
# PAS Framework aplicado automáticamente.
# Resultado específico + plazo + reducción de objeciones.
# La habilidad le enseñó a Claude a pensar como un redactor.
Ejemplo 2: SEO: con la habilidad instalada
## Auditoría técnica SEO
- Etiqueta de título: 62 caracteres (OK, límite: 60)
- Meta descripción: ausente (CRÍTICO)
- H1: presente, contiene la palabra clave principal (OK)
- Marcado de esquema: ninguno detectado (RECOMENDADO)
- Core Web Vitals estimado: LCP alto (imágenes sin pereza)
- Móvil: meta ventana gráfica presente (OK)
- Canónico: faltante (IMPORTANTE)
...
# La habilidad le dio a Claude una lista de verificación de más de 20 elementos,
# formato de informe y criterios de prioridad.
Ejemplo 3: Desarrollo: con habilidad instalada
# Con la habilidad Node.js/Express instalada, Claude:
# - Utiliza la estructura de carpetas predeterminada del proyecto.
# - Aplicar validación con Zod
# - Implementa un manejo de errores consistente
# - Sigue el estándar de autenticación del proyecto.
# - Crea pruebas automáticamente
Habilidades de marketing: lo que está incluido
O o Mega paquete de habilidades para Claude Codees parte del Mega Paquete con más de 748 habilidades en 7 categorías. Cada habilidad fue escrita por profesionales con experiencia real, no por generadores de contenido.
Áreas cubiertas:
- Editorial publicitaria:titulares, páginas de ventas, correos electrónicos, anuncios, guiones de vídeo
- SEO:auditoría técnica, investigación de palabras clave, optimización en la página, construcción de enlaces
- Anuncios de Google:estructura de campaña, texto del anuncio, palabras clave negativas, ofertas
- Metaanuncios:creatividades, copias, estructura de campaña, audiencias
- Comercialización por correo electrónico:secuencias, temas, segmentación, automatizaciones
- Analítica:GTM, GA4, Meta Pixel, API de conversiones, paneles
- CRO:optimización de conversión, pruebas A/B, mapas de calor, embudos
Cada habilidad contiene entre 500 y 3000 palabras de instrucciones, marcos, plantillas y ejemplos. No se trata de indicaciones de una sola línea: son manuales completos que transforman a Claude en un verdadero experto en el campo.
Habilidades de desarrollo: qué está incluido
O o Mega pack con más de 748 habilidades para Claude Codeincluye 284 habilidades para desarrollar plataformas y herramientas reales, además de más de 464 habilidades para marketing, SEO, redacción publicitaria, redes sociales y flujos de trabajo.
Plataformas incluidas:
- Antrópico:Claude API, Agent SDK, integración con herramientas
- Vercel:Next.js, implementación, funciones perimetrales, análisis
- raya:pagos, suscripciones, webhooks, pago
- Supabase:base de datos, autenticación, almacenamiento, funciones perimetrales
- Nube de Google:Firebase, funciones en la nube, BigQuery
- Llamada en la nube:Trabajadores, Páginas, R2, DNS
- Y más de 40 plataformas malas.
Cuando instale estas habilidades, Claude Code conocerá la documentación actualizada para cada plataforma. En lugar de generar código genérico, genera código que sigue las mejores prácticas y API actuales de cada herramienta.
Siguiente paso: instale skills y vea la diferencia
Ya sabes lo básico. Ahora imagina a Claude Code sabiendo cómo hacer todo esto solo. Eso es lo que hacen las habilidades. Acceso de por vida, actualizaciones incluidas.
Ver el Mega Paquete – R$ 19Preguntas frecuentes sobre las habilidades de Claude Code
No. Las habilidades son archivos de texto (.md) que copia a una carpeta en su computadora. El proceso dura menos de 2 minutos y no requiere ningún conocimiento de programación. Claude Code lee estos archivos automáticamente.
Sí. Las habilidades funcionan con cualquier plan de Claude Code: gratuito, Pro o Enterprise. Lo que cambia entre planes es el límite de mensajes, no la capacidad de utilizar habilidades. El mecanismo de detección de habilidades es el mismo en todos los planes.
Las indicaciones son instrucciones individuales que escribe durante cada conversación. Si cierras la terminal, lo pierdes todo. Las habilidades son archivos permanentes con marcos completos, reglas, plantillas y contexto especializado. Claude carga automáticamente habilidades cuando detecta que son relevantes para su sesión, sin que usted copie ni pegue nada. Es la diferencia entre dar una instrucción verbal y entregar un manual completo.