Inicio » Software » Cómo crear una Skill en Claude: Guía Definitiva y Buenas Prácticas
Cómo crear una Skill en Claude: Guía Definitiva y Buenas Prácticas
La creación de skills en Claude permite personalizar profundamente el comportamiento de la IA, facilitando la ejecución automática de instrucciones recurrentes, tareas especializadas y conocimiento de dominio.
El archivo SKILL.md, con su frontmatter y contenido markdown, es la base técnica para definir habilidades, controlando cuándo y cómo se activan mediante descripciones optimizadas y permisos sobre herramientas.
Herramientas como skill-creator y la evaluación automática mediante test cases y subagentes son fundamentales para validar la utilidad y eficiencia real de cada skill, asegurando que aporten beneficio concreto al flujo de trabajo.
Crear una skill en Claude puede parecer complicado si no tienes experiencia previa con asistentes de IA avanzados. Sin embargo, el proceso es mucho más accesible de lo que la mayoría imagina y, si le dedicas un poco de atención, puedes personalizar por completo la inteligencia artificial para que se adapte justo a lo que necesitas, tanto en tu día a día profesional como en tareas personales.
En este artículo descubriremos cómo crear una skill personalizada en Claude desde cero, aprovechando todas las características del formato Agent Skills, los archivos SKILL.md, las mejores prácticas de configuración, el uso de herramientas automatizadas como el skill-creator y las claves para evaluar que tu skill realmente merece tener un hueco en tu flujo de trabajo. Si alguna vez te has sorprendido repitiendo siempre los mismos comandos o instrucciones en cada sesión de Claude, este tutorial exhaustivo es para ti.
¿Qué es exactamente una Skill en Claude y para qué sirve?
Las Skills en Claude son extensiones de comportamiento que le permiten a la IA adoptar instrucciones, reglas, conocimientos o tareas repetitivas de forma automática y persistente, sin que tengas que recordárselas en cada sesión. Imagínate, por ejemplo, que siempre le pides que revise los textos con cierto enfoque, que haga comprobaciones de seguridad o que actúe como un asesor con una personalidad concreta. Si todo esto lo pegas a mano cada vez, estás perdiendo tiempo y esfuerzo. Crear una Skill encapsula esas instrucciones en un único archivo y, a partir de ahí, Claude lo aplicará automáticamente cuando sea relevante o cuando tú lo invoques.
La principal ventaja es la personalización global: desde que está activa la Skill, se comportará según las reglas, estilo, objetivos y límites definidos. Puedes tanto crear habilidades muy generales como otras ultra-especializadas para contextos técnicos, comunicación, asistencia empresarial, revisión de código, soporte a equipos…
¿Cuándo merece la pena crear una Skill?
No todo prompt repetitivo justifica crear una Skill. De hecho, uno de los errores más comunes es transformar cualquier instrucción puntual en una skill y acabar con decenas de mini-skills que solo saturan el contexto y hacen lento todo el sistema. La clave es detectar ese momento en que repites algo tan a menudo (listas, comprobaciones, reglas de la empresa, detalles personales, patrones de calidad) que quieres que la IA lo tenga siempre “en mente”. Si solo haces una tarea una vez a la semana, probablemente sea mejor dejarlo como prompt individual o, en su caso, como comando slash.
El uso más efectivo de las Skills surge cuando necesitas que Claude se adapte con conocimientos consolidados de dominio, reglas de negocio o estilo de trabajo personalizable y, además, quieres mantener eso accesible para todo tu equipo si compartís flujo de trabajo.
¿Qué diferencia hay entre Skills, comandos slash y subagentes?
Skills: Son la memoria permanente de Claude. Permiten ampliar su comportamiento, se activan automáticamente cuando tu petición encaja con su descripción o cuando lo llamas directamente por su nombre (/nombre-skill).
Comandos slash: Son instrucciones que disparas de forma explícita, en vez de confiar en que la IA decida. Son ideales para acciones directas (generar informes, ejecutar scripts, tareas administrativas).
Subagentes: Son contextos de ejecución aislados, ideales para análisis que necesitas mantener separados del resto de la conversación (por ejemplo, auditorías técnicas, tareas que requieren independencia para que el contexto no contamine los resultados).
Antes de crear tu primera skill piensa: ¿Quiero que esto sea parte del ‘cerebro’ general de Claude, que lo aplique cuando lo considere relevante? Si es sí, convierte tu prompt frecuente en una Skill.
Primeros pasos: Requisitos y consideraciones iniciales
Antes de meterte a construir tu primera skill, es importante entender su naturaleza técnica y dónde vive dentro del ecosistema Claude. Cualquier usuario puede crear y personalizar Skills, aunque para algunas funciones avanzadas tendrás que disponer de una versión de pago (por ejemplo, en Claude Pro, Claude Code o entornos empresariales con Anthropic).
Claude soporta Skills tanto en su chat general como en versiones específicas para desarrolladores (Claude Code). El formato estándar es simple: un archivo SKILL.md con una sección inicial YAML (frontmatter) donde pones el nombre, descripción y otros parámetros, seguido del contenido markdown con las instrucciones detalladas.
¿Dónde se guardan las Skills y cómo compartirlas?
Skills personales: ubicadas en ~/.claude/skills/<name>/SKILL.md. Funcionan para todos tus proyectos y solo están disponibles para ti.
Skills de proyecto: dentro de .claude/skills/<name>/SKILL.md (en la raíz del repositorio). Se comparten automáticamente entre todos los miembros de tu equipo al hacer pull del código (Git).
Skills de organización: configuradas por administradores para todos los usuarios de la empresa.
Skills en Plugins: integradas dentro de directorios skills/ de cada plugin instalado.
Claude prioriza la ubicación de los Skills en este orden: empresa > personal > proyecto > plugin. Si el mismo skill existe en varios niveles, el de mayor prioridad se impone.
Cómo crear tu primera Skill en Claude paso a paso
1. Elige bien el propósito de tu skill
Evita abstraer en exceso: tu skill debería codificar conocimiento estable, reglas que se aplican casi siempre y aportan valor cada vez que Claude trata temas relacionados. Los mejores ejemplos: listas de comprobación de seguridad, guías de estilo de código, patrones de calidad, instrucciones para comunicación con clientes específicos, etc.
2. Crea la estructura de directorios adecuada
Decide si tu skill será personal, de equipo o de proyecto, y crea la carpeta correspondiente. Por ejemplo, para un skill personal de revisión de código podrías crear:
~/.claude/skills/revision-codigo/SKILL.md
3. Escribe el archivo SKILL.md: estructura y contenido
El archivo SKILL.md es el corazón de cualquier skill en Claude. Está estructurado en dos partes principales:
Frontmatter en YAML (entre líneas —): Aquí defines nombre, descripción y parámetros de comportamiento.
Contenido markdown: Son las instrucciones detalladas, guías, reglas, ejemplos de formatos, scripts, etc., que Claude debe seguir cuando activa la skill.
Ejemplo de frontmatter básico:
---
name: revision-codigo
description: Analiza cambios en el código para detectar errores comunes de seguridad, patrones de malas prácticas y problemas de mantenibilidad en tareas de revisión de Pull Requests, auditorías y merges. Se activa automáticamente cuando la conversación trata de revisar código, buscar bugs o validar calidad en cambios recientes. Incluye recomendaciones sobre estilo y advertencias de posibles vulnerabilidades.
allowed-tools: Read, Grep, Glob #Solo lectura
---
Cada campo del frontmatter añade una capa de comportamiento:
name: Nombre del skill, único e identificativo.
description: Explica qué hace el skill y cuándo debería activarse. Es el campo más importante de todos.
allowed-tools: Restringe las herramientas a las que puede acceder Claude cuando el skill está activo (por ejemplo, solo lectura, acceso limitado a shell, etc.).
disable-model-invocation: (opcional) Si lo estableces en true, el skill no se activará automáticamente.
user-invocable: (opcional) Si se marca como false, solo Claude puede llamar al skill, no será accesible desde el menú de comandos slash.
context: (opcional) Si lo pones en fork, el skill se ejecutará en un subagente para análisis aislados.
En el contenido markdown puedes incluir:
Instrucciones paso a paso de los comportamientos deseados.
Procedimientos de actuación para tareas repetitivas.
Ejemplos de casos útiles (por ejemplo, fragmentos de código).
Referencias a archivos de apoyo (e.g., especificaciones, listas, documentación de APIs).
Cuidado con la longitud: Mantén el SKILL.md bajo las 500 líneas
Claude inyecta las descripciones y nombres de todos los skills activos en el contexto de la sesión. El presupuesto de memoria compartido para descripciones de skills escala al 2% de la ventana de contexto (en torno a 16.000 caracteres), por lo que si tienes muchos skills y las descripciones son muy largas, algunos podrían quedarse fuera. Mantén la descripción clara, específica y corta.
4. Añade archivos de apoyo si lo necesitas
A veces las instrucciones necesitan adjuntar documentación, ejemplos, listas, scripts, etc. Guarda estos archivos en el mismo directorio que tu SKILL.md y haz referencia a ellos en las instrucciones. Claude los cargará solo cuando sean necesarios, lo que ayuda a no saturar el contexto general.
5. Prueba el skill activándolo y ajustando las descripciones
La descripción es la clave: cuando envías un mensaje a Claude, el modelo compara tu tarea con la descripción de cada skill usando razonamiento semántico, no solo palabras clave. Si la descripción es vaga o generalista, se activarán skills fuera de lugar, o, al contrario, el relevante podría pasar desapercibido.
¿Tu skill nunca se activa? Añade frases disparadoras, acciona con prompts realistas.
¿Se activa cuando no debe? Haz la descripción más precisa, o desactiva la invocación automática.
6. Itera el skill según el uso real en el equipo
Ningún skill es definitivo desde el principio. Usa Claude en modo real, observa cuándo y cómo se activa la skill, qué respuestas ofrece y qué casos no cubre bien. Ajusta instrucciones, amplía o reduce alcance, refina las restricciones de herramientas y, sobre todo, revisa que la descripción refleje los usos que de verdad quieres cubrir.
Configuraciones avanzadas en Skills de Claude: Saca el máximo provecho
Personalización a través de variables y argumentos
Las skills pueden ser parametrizables utilizando marcadores como $ARGUMENTS, $USER_PROMPT y $SLASH_PROMPT. Al invocarlas por su nombre (por ejemplo, /revisar-codigo archivo.js), puedes capturar partes variables de la petición y usarlas dentro de las instrucciones.
---
name: migrar-componente
description: Migra componentes entre frameworks.
argument-hint:
---
Analiza el componente $ARGUMENTS y migra de $ARGUMENTS a $ARGUMENTS.
Cuando ejecutas /migrar-componente SearchBar React Vue, el skill sustituye los argumentos por los valores que pases.
Control total sobre quién y cómo se pueden activar los Skills
disable-model-invocation: true — solo desde comandos slash manuales.
user-invocable: false — oculto del menú slash, solo lo activa Claude en segundo plano.
Control de herramientas permitidas
allowed-tools permite restringir drásticamente lo que puede hacer Claude al activar un skill. Por ejemplo, si quieres evitar que pueda modificar archivos, puedes limitarle solo a herramientas de lectura (Read, Grep, Glob). Si necesitas que use APIs, puedes habilitar acceso a shell o conexiones HTTP desde scripts internos.
Skills agrupados y subagentes
Claude permite skills agrupados distribuidos automáticamente en instalaciones determinadas (por ejemplo, subdirectorios en monorepos). Cada paquete puede tener su propio set de skills en .claude/skills/nombre/, que Claude descubrirá automáticamente en función de la carpeta que estés editando o el contexto de trabajo.
Si añades context: fork en el frontmatter, forzarás la ejecución en un subagente aislado.
Creación asistida de Skills: Skill-Creator y la automatización inteligente
¿Qué es skill-creator y cómo acelera el desarrollo de Skills?
Crear un SKILL.md desde cero está bien, pero existen soluciones como skill-creator que automatizan muchas fases. Este sistema, disponible en el marketplace de Skills.sh, puede:
Entrevistarte para entender con precisión qué necesitas del skill.
Analizar proyectos existentes y ayudar a transformar flujos manuales en skills reutilizables.
Proponer instrucciones, frontmatter y archivos de apoyo según el contexto técnico real.
La instalación es muy sencilla. Si usas Claude Code, OpenCode, Gemini CLI, Codex o cualquier otro sistema compatible:
Interfaz guiada para definir objetivos y mejores prácticas
Una de las aportaciones más valiosas de skill-creator es su sistema de entrevista guiada antes de generar el markdown. Te preguntará:
¿Qué debe hacer exactamente la skill?
¿Cuándo debe dispararse?
¿Qué formato de salida esperas?
¿Se puede validar el resultado objetivamente?
Esta reflexión previa garantiza que el skill generado tenga sentido práctico y sea medible en sus resultados, algo clave si quieres ahorrar tiempo y tokens en tareas recurrentes.
Automatización en investigación y extracción técnica
Skill-creator no solo rellena plantillas, sino que explora el entorno real del proyecto, detecta archivos, configuraciones, acceso a APIs, scripts auxiliares, etc., optimizando las instrucciones finales y anticipándose a preguntas técnicas que ahorrarás en el futuro.
Si tu skill requiere ejecutar scripts internos, skill-creator puede generarlos automáticamente y organizarlos dentro del directorio del skill. Por ejemplo, analiza qué parte del proceso se puede automatizar (llamadas HTTP, procesado de textos, consultas semánticas) y crea archivos auxiliares (en Python, Node.js u otros) completamente integrados.
Evaluación y comparación de skills creadas: ¿Aporta valor real?
La diferencia de calidad entre una skill improvisada y una bien validada está en la fase de evaluaciones de rendimiento. Skill-creator ejecuta pruebas automáticas con subagentes en paralelo: compara los resultados de Claude con y sin el skill, analiza métricas como pass rate, consumo de tokens, tiempo de respuesta y ejecución de comandos. Si el skill no mejora claramente la eficiencia, no merece la pena mantenerlo.
La clave es definir buenos test cases (evals.json): prompts realistas, medibles y variados, que simulan cómo los usuarios hacen peticiones en realidad. Así sabrás cuándo tu skill es fiable y qué casos concretos hay que mejorar.
Iteración, optimización y benchmark: Mejorando tus Skills de forma profesional
Loop de iteración con feedback humano
Skill-creator da un paso más allá: cada ejecución de test genera un visor HTML con resultados y benchmarks. Analiza los outputs, escribe tus comentarios sobre lo que no funciona o falta, y el sistema reelabora la skill para mejorar el resultado global. Es un proceso cíclico donde, tras pocas iteraciones, pasas de una skill funcional a una herramienta verdaderamente afinada.
Benchmark automatizado: todo queda registrado y medido
Todos los resultados de las tests se agregan en archivos resumen tipo benchmark.json. Así puedes saber de un vistazo si la nueva versión realmente funciona mejor (más pass rate, menos tokens, menos tiempo por tarea) y decidir cuál mantener o repartir.
Comparación ciega (A/B) para eliminar sesgos
¿Tienes dudas entre dos versiones similares de una skill? Puedes activar una comparación ciega: tanto los outputs como la revisión se hacen en anonimato, evitando que el evaluador sepa cuál es la versión nueva. Así se eliminan sesgos y solo se mantiene lo que realmente aporta valor.
Automatización de la optimización de descripciones
El campo description es el verdadero disparador de tus skills. A menudo merece la pena dedicar varias pasadas a optimizarlo. Skill-creator realiza un loop interno de pruebas, generando decenas de queries que sí y que no deberían activar el skill, afinando la redacción hasta lograr máxima eficacia sin activaciones no deseadas.
Análisis profundo (analyst pass) para detectar patrones ocultos
Más allá de los números brutos, el analista automático explora los gradings en busca de assertions que siempre fallan, casos limítrofes, gaps no cubiertos… Es el último paso antes de dar por buena una skill para su publicación o distribución en equipos grandes.
Empaquetar y compartir tus Skills
Cuando tu skill está lista, puedes empaquetarla en un archivo .skill y distribuirla dentro de tu organización o entre tus colegas. Recuerda borrar o filtrar credenciales sensibles en archivos .env antes de distribuir.
Tips para skills compartidas:
Documenta bien por qué existe cada skill.
Revisa los cambios en skills antes de compartirlos mediante pull requests, igual que el código fuente.
Mantén separadas skills de dominio compartido (reglas empresariales) y skills personales (tus propios trucos).
Recomendaciones, buenas prácticas y solución de problemas
Cómo escribir la mejor descripción para tus skills
Explica claramente qué hace.
Incluye frases y términos que escribirían los usuarios de forma natural (palabras disparadoras).
Evita vaguedades como «ayuda con el código» o «soluciona problemas». Detecta casos, traza límites.
Mantén la descripción breve y concisa. Recuerda que compite por espacio en el contexto.
Errores comunes
Skills demasiado generales que se activan siempre y contaminan el contexto.
Descripción muy larga (excluye el skill del contexto por falta de espacio).
No restringir las herramientas, permitiendo que el skill tenga efectos secundarios no deseados.
Uso de skills para flujos demasiado esporádicos, que solo aportan ruido.
No probar la activación real con prompts del día a día.
Solución de problemas típica
¿Claude no activa tu skill? — Ajusta la descripción, asegúrate de que las palabras clave estén presentes, o invócalo directamente usando /nombre-skill.
¿Se activa el skill fuera de contexto? — Haz la descripción más específica o restringe invocación manual únicamente.
¿La descripción se corta? — Mantén las frases clave al principio de la descripción, limita la longitud a 250 caracteres si tienes muchos skills, o amplía el límite de entorno si puedes.
Patrones avanzados e integración con proyectos reales
Skills como biblioteca de prompts
No te limites a pensar las skills como extensiones para una sola tarea. Pueden formar una auténtica biblioteca personal de instrucciones, reglas y conocimiento experto. Un conjunto bien afinado de skills puede transformar la productividad de equipos enteros (por ejemplo, con reglas de negocio, guías de commit, gestión de incidencias, patrones de desarrollo, checklist de calidad, etc.).
Skills y subagentes: análisis o generación en contexto aislado
Cuando una tarea de la skill debe ejecutarse sin contaminar el contexto de la conversación principal (e.g., auditorías, investigación en profundidad), añade context: fork a tu skill. Esto dispara un subagente, que trabaja de forma independiente y devuelve resultados sin influir en el histórico de la sesión general.
Ejemplo de integración con scripts y generación de informes visuales
Las skills pueden enlazarse con scripts en cualquier lenguaje. Por ejemplo, puedes crear scripts en Python, JavaScript o Shell para procesar bases de datos, analizar árboles de directorios, generar diagramas, obtener datos en vivo (usando comandos tipo !<comando> en el markdown), y hacerte un informe visual descargable o navegable en HTML desde Claude Code.
Evaluación y evolución continua
No crees una skill y la dejes olvidada. Cuando cambian las APIs, los modelos de IA, o detectas cambios en el tipo de tareas recurrentes, vuelve a evaluar los pass rate y la eficiencia de tus skills. Si la skill ya no mejora resultados, puede ser mejor eliminarla para evitar saturar el contexto.
A lo largo de este artículo has visto en profundidad por qué, cuándo y cómo crear una skill en Claude puede multiplicar tu eficiencia y la de tu equipo, evitando la repetición constante de instrucciones y afianzando mejores prácticas. Dedica tiempo a definir bien las descripciones, estructurar los directorios, evaluar el rendimiento y compartir skills de dominio entre tus compañeros. Así transformarás el uso diario de la IA en una experiencia mucho más inteligente y personalizada.
