Claude Code: guía para devs, hooks, skills, SDK y CLI

Una skill es una carpeta con un archivo SKILL.md que le enseña a Claude Code cómo hacer una tarea concreta: clonar un carrusel, auditar el SEO de un sitio, armar una campaña de ads. Vive en ~/.claude/skills/<nombre>/ y se invoca por su nombre. La diferencia con un prompt suelto es que la skill queda guardada, versionada y reutilizable: la escribís una vez y Claude la aplica igual siempre. Es el bloque base para organizar tu trabajo como un equipo, porque cada skill se comporta como un empleado con una función clara. Para ver ejemplos concretos ya armados, mirá 50 Claude skills para 2026 y, si querés extender Claude Code con herramientas externas, 5 herramientas pro de Claude Code. La documentación oficial está en Claude Code Skills.

El CLAUDE.md es el archivo de contexto que Claude Code lee automáticamente al arrancar en una carpeta. Ahí ponés las reglas del proyecto, tus preferencias, la estructura, y las instrucciones de ruteo: qué skill usar para cada tipo de pedido. Funciona como el cerebro del equipo, porque le pasa el mismo contexto a todas las skills que invoques y evita que le repitas lo mismo en cada sesión. Es también la principal palanca para ahorrar tokens: en vez de re-explicar el proyecto cada vez, lo escribís una sola vez. Profundizamos ese punto en cómo ahorrar tokens con CLAUDE.md, y la referencia oficial está en la doc de memoria de Claude Code. Antes de escribirlo, conviene dejar el terreno listo con 3 cosas que hacer antes de abrir Claude Code: un buen CLAUDE.md es lo que separa un montón de skills sueltas de un equipo que trabaja coordinado.

Agrupás las skills en carpetas por función, igual que los departamentos de una agencia: contenido, SEO, ads, ingeniería, negocio. Cada carpeta junta las skills de ese rubro y el CLAUDE.md de la raíz mapea la intención al departamento correcto ("si el pedido es sobre pauta, usá las skills de ads"). No hace falta una carpeta física obligatoria: lo importante es que el ruteo esté escrito en el CLAUDE.md, así Claude elige la skill correcta sin que se la nombres. Este patrón escala: podés tener cientos de skills y seguir encontrándolas, porque la organización vive en el cerebro y no en tu cabeza. Es el mismo criterio de un equipo de sub-agentes tipo Superpowers, pero aplicado a tu propio catálogo. Para poblar cada departamento con ideas concretas, 50 Claude skills para 2026 te da un catálogo listo, y la doc de referencia está en Claude Code Skills.

Ninguna cantidad mágica: se empieza con las 3 o 4 que más repetís y el equipo crece solo a medida que detectás tareas repetitivas. Cada vez que hacés algo dos veces a mano, esa es una candidata a skill. Un equipo maduro puede tener decenas o cientos de skills, pero el valor no está en el número sino en el ruteo: que el CLAUDE.md sepa cuál usar para cada pedido. Arrancar con pocas y bien organizadas es mejor que copiar cientos que no vas a usar. Si querés ideas para las primeras, 50 Claude skills para 2026 es un buen punto de partida, y 3 cosas que hacer antes de abrir Claude Code te deja el terreno listo. La doc oficial de Claude Code cubre el resto.

Sí. Como cada skill es solo una carpeta con un SKILL.md en texto plano, las versionás en un repo de git y las compartís igual que cualquier código. Tu equipo clona el repo, corre un script de sync que las copia a ~/.claude/skills/, y ya tiene el mismo equipo que vos. Esto convierte tu catálogo en un activo real de la agencia: onboardeás a alguien nuevo y en minutos trabaja con las mismas capacidades. También podés mantener un CLAUDE.md compartido con las reglas de la marca para que todos ruteen igual. Es el mismo principio de reutilización que explicamos en 5 herramientas pro de Claude Code y en 5 proyectos gratis para mejorar Claude. La estructura de carpetas está documentada en Claude Code Skills.