Skills de Claude Code: cómo construirlos + catálogo abierto
Un skill es una de las seis piezas que componen un agente IA — la que orquesta procesos completos. Esta es la guía técnica de cómo construir uno + los 4 skills reales que viven en producción en este sitio, con su SKILL.md abierto.
¿Primera vez con agentes IA? Empieza por la anatomía completa de un agente — modelo, skills, tools, MCPs, comandos y hooks.
Qué es un skill — en profundidad
Un skill es la unidad de proceso de un agente. Mientras un prompt es una instrucción puntual y una tool es una capacidad atómica (leer un archivo, hacer un fetch), un skill orquesta varios prompts + tools en un proceso completo con voz, validaciones y output predecible.
Vive en ~/.claude/skills/<nombre>/SKILL.md (personal, cross-proyecto) o <repo>/skills/<nombre>/SKILL.md (del proyecto). El agente lee ambos automáticamente.
Anatomía del archivo
mi-skill/
SKILL.md # índice corto (≤200 líneas)
steps/
paso-1-investigar.md
paso-2-redactar.md
paso-3-publicar.md
references/
voz-de-marca.md
ejemplos.md
scripts/
deploy.py
sync.shEl SKILL.md es el índice. Cuando el proceso pasa de 3 pasos, mueves el detalle a steps/ y referencias a references/. El agente carga solo lo que necesita en cada paso, no el archivo entero. Eso ahorra tokens y mantiene el contexto limpio.
Frontmatter mínimo
---
name: mi-skill
description: "Una línea: qué hace, para quién, cuándo activarse.
Incluye 3-5 frases-trigger en lenguaje natural."
triggers: ["/mi-skill", "frase 1", "frase 2"]
extends: [voz-gnb] # skills que hereda
related: [skill-a, skill-b]
---extends permite herencia: el skill carrusel-gnb hereda de voz-gnb automáticamente — no repites las reglas de voz en cada skill de contenido.
Cómo construir tu primer skill
Las cuatro reglas que aprendí construyendo y rompiendo skills durante un año.
La regla de las 3 veces
Si escribiste un prompt parecido 3 veces, agentízalo. Antes de eso es prompt — no skill. Después de eso, cada repetición es tiempo perdido.
Modular > monolito
Si tu SKILL.md pasa de 200 líneas, mueve los pasos largos a steps/. El agente lo agradece — y tú, cuando lo edites en 3 meses.
Triggers en lenguaje natural
En el frontmatter pon 3-5 frases-trigger reales: “reescribe este email”, “hazlo más específico”. Así Claude lo invoca aunque no escribas el slash command.
Skill personal vs de proyecto
Skills personales globales en ~/.claude/skills/. Skills de marca o proyecto locales al repo. No contamines proyectos con voces ajenas.
Atajo: en vez de armar un skill desde cero, corre el skill /agentiza — toma tu SOP, transcripción de Loom o “así lo hago a mano” y devuelve un skill modular bien estructurado en 20 minutos. Lo cubrí a detalle en este post:
Catálogo: skills que uso en producción
Estos skills viven en el repo de gabrielneuman.com y operan a diario. Cada uno tiene su SKILL.md abierto — puedes leerlo, copiarlo y adaptarlo a tu negocio.
Visual
Aprendiendo de skills y agentes
Lo último que escribí sobre construir, debuggear y operar con skills, agentes y MCPs. Llevo casi un año iterando — esto son los aprendizajes en bruto.
CodeBurn: por fin una TUI para ver a dónde se van los tokens de Claude, Codex y Cursor
Probé CodeBurn, un dashboard TUI open-source que lee las sesiones de Claude Code, Codex, Cursor, OpenCode, Pi y Copilot desde disco y te dice exactamente en qué se quemó cada dólar. Sin proxy, sin API keys.
Caveman: el skill que ataca el otro lado del pipe para reducir costos de IA
Empecé a usar Caveman, un skill open-source que reduce los tokens de salida del modelo entre 22% y 87% cambiando solo el estilo de respuesta. Complementa a RTK, no lo reemplaza.
Cuando el rate limit te obliga a diseñar mejor: radar diario con prospect + growth priorizado
Construí el radar diario para que cada mañana me llegue un prospecto nuevo y una idea de growth priorizada. Y descubrí que la IA gratis no es gratis: los rate limits te obligan a decidir qué tareas merecen el cupo.
Le instalé un cerebro al repo: Wiki Karpathy en gnbsite
Instalé el sistema de Wiki + Raw inbox tipo Karpathy en el repo de mi sitio personal. Menos ruido, más contexto, y reglas que Claude realmente sigue entre sesiones.
Cómo ahorrar en tu infra de agentes (y planificar mejor en el proceso)
Dos aprendizajes del mismo día: cómo correr colas de trabajo serias casi gratis, y por qué un wiki corto en el repo te hace planificar mejor los agentes antes de escribir código.
Liam tiene herramientas propias: 11 micro tools financieras migradas
Migramos 11 herramientas financieras de miCFO a gabrielneuman.com. Liam, CFO de IA, ya tiene su suite de calculadoras y validadores fiscales con marca propia.
¿Construyes tu primer agente conmigo?
Te ayudo a tomar un proceso que ya repites mucho y convertirlo en un agente IA que opere por ti — desde el SOP, ensamblando skills, tools y MCPs, hasta el dogfooding en producción. Una sesión de 60 minutos en vivo.
Agendar diagnóstico¿Listo para automatizar tu negocio?
Ayudo a empresas a escalar mediante automatización inteligente y estrategias de IA. Sin fricción, sin complicaciones, resultados en semanas.