Cómo crear skills personalizados en Claude: guía práctica para equipos

Introducción

Claude puede revisar datos, chequear código, escribir reportes y preparar presentaciones. Sin embargo, muchos equipos terminan escribiendo una y otra vez las mismas reglas, la misma estructura de salida y las instrucciones de control final en cada conversación. Ese trabajo repetitivo consume tiempo y genera resultados inconsistentes.

Los skills personalizados solucionan este problema empaquetando instrucciones reutilizables, flujos de trabajo, plantillas, ejemplos y archivos de referencia que Claude carga automáticamente cuando detecta una tarea relacionada. Abordaremos cómo funcionan los skills, las opciones de configuración y construiremos un skill práctico para auditar archivos CSV.

¿Qué es un skill en Claude?

Un skill es, en su forma más simple, un directorio con un archivo obligatorio llamado SKILL.md. Ese archivo define qué hace el skill, cuándo debe activarse y los pasos que Claude debe seguir. Opcionalmente, el directorio puede incluir recursos adicionales: scripts, plantillas, ejemplos y archivos de referencia.

Los skills siguen el estándar abierto Agent Skills (agentskills.io), lo que garantiza portabilidad básica: nombre, descripción y Markdown funcionan en distintas aplicaciones de Claude, como Claude Code y la plataforma de desarrolladores. Cada producto puede extender el estándar con características propias.

Skills vs comandos personalizados

Si han usado Claude Code, es probable que tengan archivos en .claude/commands/. Esos comandos personalizados se han unificado con los skills. Un archivo en .claude/commands/deploy.md y un skill en .claude/skills/deploy/SKILL.md crean el mismo comando /deploy. Los skills agregan funcionalidades opcionales: un directorio para archivos de soporte, frontmatter que controla si ustedes o Claude invoca el skill, y carga automática cuando la tarea es relevante. Si existe un skill y un comando con el mismo nombre, el skill prevalece.

¿Hace falta programar para crear un skill?

No. Un skill básico puede ser solo Markdown. Un SKILL.md bien redactado ya funciona. El código se vuelve útil cuando necesitan:

• Analizar datos de manera determinística
• Procesar o validar archivos automáticamente
• Generar visualizaciones o transformar estructuras
• Integrar sistemas externos o ejecutar utilidades de línea de comandos

Regla simple: si su flujo es puramente de instrucciones y juicio humano → no necesitan código; si requieren procesamiento determinista o automatización → el código ayuda.

Cómo funcionan los skills: carga progresiva

Claude usa una estrategia de divulgación progresiva para no cargar todo en la ventana de contexto de una vez.

• Etapa 1 — Descubrimiento: al inicio Claude solo lee la metadata (nombre y descripción). La descripción es crucial porque Claude la usa para decidir si el skill coincide con la petición del usuario. Por eso es importante que la descripción sea precisa y orientada a las consultas que esperan activar el skill.

• Etapa 2 — Carga de instrucciones: si Claude considera relevante el skill, carga el cuerpo de SKILL.md, donde viven el flujo de trabajo, las reglas, las comprobaciones y el formato de salida.

• Etapa 3 — Recursos de soporte: scripts, ejemplos y archivos de referencia se leen solo si son necesarios. Los archivos de referencia no consumen tokens hasta que se abren; los scripts suelen ejecutarse y solo el resultado entra al contexto.

Una consecuencia práctica: cuando un skill se invoca en Claude Code, el SKILL.md renderizado entra a la conversación como un único mensaje y permanece para toda la sesión. Claude Code no relee el archivo en turnos posteriores. Durante la auto-compacción, Claude Code reanexa la invocación más reciente de cada skill después del resumen, manteniendo los primeros 5.000 tokens de cada uno dentro de un presupuesto combinado de 25.000 tokens. Si un skill deja de influir en una sesión larga, puede ser necesario invocarlo de nuevo.

Anatomía de un skill

Un skill típico tiene esta estructura mínima:

• SKILL.md (obligatorio): encabezado YAML con frontmatter y cuerpo en Markdown con instrucciones.
• references/ (opcional): estándares de codificación, reglas de negocio, listas de validación.
• examples/ (opcional): ejemplos de entrada/salida buenos y malos.
• templates/ (opcional): estructura fija de salida para que Claude la complete.
• scripts/ (opcional): scripts que realizan procesamiento determinista.

Empaquetar archivos no basta: deben referenciarse explícitamente desde SKILL.md para que Claude sepa cuándo abrirlos.

Consejo práctico: mantengan SKILL.md por debajo de unas 500 líneas y pasen los detalles extensos a archivos en references o examples.

Frontmatter y campos esenciales

El frontmatter YAML en SKILL.md contiene los metadatos que permiten a Claude y a las aplicaciones entender el skill. En su núcleo portátil, al menos deben incluir nombre y descripción. Productos específicos pueden ofrecer campos adicionales para controlar invocación automática, privacidad, permisos o alias.

Buenas prácticas para equipos y entornos latinoamericanos

• Centralicen reglas locales: empaqueten políticas de validación que reflejen formatos de identificación fiscal o estructuras de datos comunes en la región en references/.
• Versionen skills: mantengan control de cambios si varios equipos usan el mismo skill para evitar roturas en flujos críticos.
• Mantengan ejemplos reales pero anonimicen datos sensibles para cumplir con regulaciones locales.
• Empujen la lógica determinista a scripts cuando necesiten resultados reproducibles entre usuarios.

Proyecto práctico: construir un auditor de calidad para CSV

1. Crear el directorio del skill, por ejemplo data-auditor/.

2. Añadir SKILL.md con frontmatter simple: nombre y descripción concisa orientada a la detección de problemas en CSV (valores faltantes, tipos incorrectos, duplicados, rangos fuera de lo esperado). En el cuerpo, definan:

   • Qué comprueba el auditor
   • Formato de salida esperado (por ejemplo, tabla con fila, columna, problema, severidad)
   • Ejemplos de resultados buenos y malos
   • Instrucciones sobre cómo aceptar o rechazar correcciones propuestas

3. Incluir una carpeta examples/ con muestras de CSV mal formados y bien formados para que Claude pueda ver ejemplos.

4. Opcional: scripts/ con un script que valide columnas comúnmente estructuradas (si necesitan comprobaciones deterministas). Recuerden referenciar ese script desde SKILL.md para que Claude lo ejecute solo cuando sea necesario.

5. templates/ con la estructura de reporte que el equipo usa internamente (cabeceras, niveles de severidad, checklist de aceptación).

6. Probar localmente con Claude Code: invoquen el skill con una petición tipo “Revisa este CSV de clientes por problemas de calidad” y confirmen que el output cumple el formato. Si el comportamiento varía, ajusten las instrucciones o pasen reglas a scripts.

Usar y subir el skill a Claude

En Claude Code, coloquen el directorio en la ruta esperada (.claude/skills/) y el skill estará disponible como comando. Para compartirlo entre equipos, suban el paquete a la plataforma de Claude o distribúyanlo vía repositorio interno, siempre mencionando dependencias y permisos.

En las aplicaciones web o de escritorio de Claude, el proceso para cargar skills puede variar según la versión del producto; consulten la documentación del cliente para los pasos precisos. En todos los casos, asegúrense de probar el skill con ejemplos reales y verificar que las instrucciones sean suficientemente explícitas para producir salidas consistentes.

Conclusión

Los skills personalizados permiten transformar prácticas repetitivas y propensas a errores en procesos reutilizables y coherentes. Empiecen con Markdown claro y lean: agreguen código solo cuando necesiten determinismo o automatización. Para equipos en Latinoamérica, los skills son una oportunidad para encapsular estándares locales, cumplir con normativas y acelerar la entrega de análisis y reportes sin sacrificar consistencia.

Crear y mantener skills bien diseñados reduce la fricción en flujos colaborativos y mejora la calidad del trabajo asistido por IA. Empiecen por un pequeño auditor de CSV y escalen hacia skills que integren plantillas, validaciones y automatizaciones específicas de su organización.