PodcastsHear the voice. See the shape of the thought.

Claude Code incluye subagentes integrados, pero los subagentes personalizados permiten incorporar comportamientos especializados para tareas concretas. Este tutorial crea un subagente de revisión de código desde cero, recorriendo el comando `/agents`, la selección de herramientas, la elección del modelo y los campos de configuración que controlan cuándo y cómo Claude delega. ## [00:03] Qué son los subagentes personalizados Claude Code viene con subagentes integrados, pero también puedes crear los tuyos propios especializados en tareas particulares. Un subagente personalizado es un archivo Markdown con front matter YAML: el front matter le dice a Claude cuándo enrutar hacia ese agente y qué capacidades tiene, mientras que el cuerpo Markdown es el prompt de sistema bajo el que ejecuta el subagente. > *"Custom sub aents are markdown files with YAML front matter. These markdown files contain configuration that helps claude understand when to use the sub aent and provides directions to the sub aent itself."* ## [00:28] Crear un subagente con /agents El comando `/agents` abre el panel de gestión de agentes. Al seleccionar "Crear nuevo agente" se plantean dos preguntas: el alcance (proyecto actual o compartido en todos los proyectos de la máquina) y el método de generación. La opción recomendada es dejar que Claude genere el agente automáticamente: en el tutorial, el narrador escribe en lenguaje natural una solicitud para un subagente que revise calidad de código y problemas de seguridad, y Claude se encarga del resto. > *"Now, the easiest way to create a sub agent is with the / agents command. Next, you can create a sub agent manually, but we recommend using claw code to automatically generate it for you."* ## [00:56] Configurar herramientas, modelo y color Antes de que Claude genere el archivo, eliges a qué herramientas puede acceder el subagente. Un agente de revisión de código no necesita estrictamente las herramientas de edición, pero dejar la ejecución habilitada le permite inspeccionar los cambios pendientes con mayor facilidad. Tras las herramientas, se elige el modelo: haiku para velocidad, opus para profundidad, sonnet como punto intermedio. La última elección es un color que aparece en la interfaz para identificar el subagente de un vistazo. > *"Now, given that our sub agent is only responsible for reviewing code, you might decide to disallow tools for editing, but I'll leave an execution to allow the sub agent to more easily identify pending changes."* ## [01:43] Entender el archivo de configuración El archivo generado se guarda en el proyecto en la ruta que aparece en la ventana de resumen. Cuatro campos son los más importantes. `name` es el identificador único; puedes referenciarlo escribiendo `@agent-code-quality-reviewer` en un mensaje. `description` es lo que Claude lee para decidir si delega; debe ocupar una sola línea (los caracteres `\n` escapados son literales). Añadir "proactively" a la descripción hace que Claude recurra al agente con más frecuencia; incluir conversaciones de ejemplo mejora la precisión del enrutamiento. `tools` refleja los accesos concedidos durante la generación, pero puede editarse directamente en el archivo. > *"If you want Claude to use the sub agent automatically more often, add in the word proactively to the description."* ## [02:41] El prompt de sistema y cómo lo usa Claude El campo `model` acepta `haiku`, `sonnet`, `opus` o `inherit`; con `inherit`, el subagente usa el mismo modelo que la conversación principal. Todo lo que aparece después del front matter es el prompt de sistema: guía al subagente en su tarea y le indica cómo devolver los resultados al agente principal. > *"The system prompt will provide guidance to the sub agent, helping it understand how to complete its task and how it should return information back to the main agent."* ## [03:15] Probar tu subagente Tras guardar la configuración, realiza algunos cambios en el código y pídele a Claude que los revise. Si el subagente no se activa cuando se espera, el campo `description` es lo primero que hay que ajustar: ejemplos más específicos afinan el criterio de Claude para saber cuándo delegar. > *"If the sub agent isn't being used when you expect, check your description. Adding more specific examples helps Claude understand when to delegate."* ## Entidades - **Anthropic Tutorial Narrator** (Persona): único presentador de este episodio; conduce la serie de tutoriales Claude Code subagents en el canal oficial de YouTube de Anthropic - **Claude Code** (Software): asistente de codificación IA de Anthropic; admite tanto subagentes integrados como subagentes personalizados creados por el usuario - **Custom subagent** (Concepto): archivo Markdown con front matter YAML que configura Claude Code para delegar tareas específicas a una instancia de agente especializado - **/agents command** (Concepto): punto de entrada de la interfaz de Claude Code para crear y gestionar subagentes; con alcance de proyecto o global - **System prompt** (Concepto): cuerpo Markdown del archivo de configuración de un subagente; proporciona al subagente instrucciones de tarea y formato de salida en tiempo de ejecución - **Anthropic** (Organización): creador de Claude y de la plataforma Claude Code

Este tutorial de la serie Claude Code de Anthropic cubre cuatro patrones concretos que separan a los subagentes confiables de los que se desvían, se detienen o modifican archivos que no deberían tocar. El narrador recorre cada patrón usando un subagente de revisión de código y uno de búsqueda web como ejemplos continuos, mostrando exactamente qué parámetros ajustar y por qué. ## [00:03] Controlar el comportamiento del subagente con nombre y descripción Cada mensaje enviado al agente principal del contexto incluye el nombre y la descripción de cada subagente registrado en el prompt del sistema. Esto significa que la descripción cumple una doble función: indica al orquestador *cuándo* lanzar el subagente y proporciona la plantilla que usa al escribir el prompt de entrada. El tutorial lo demuestra con un subagente de revisión de código. En la configuración original, el orquestador escribe un prompt genérico que le dice al subagente que llame él mismo a `git diff`. Cambiar la descripción a "debes indicarle al agente exactamente qué archivos quieres que revise" transfiere la responsabilidad de seleccionar los archivos al orquestador; la siguiente ejecución produce un prompt de entrada notablemente más específico. El mismo mecanismo funciona con subagentes de búsqueda web: añadir "devuelve fuentes que se puedan citar" a la descripción hace que el hilo principal incluya esa instrucción automáticamente al delegar. > *"If you want to better control when the main agent launches a sub agent automatically, you should modify the name and description."* ## [01:41] Definir formatos de salida El narrador identifica el formato de salida como la mejora individual con mayor impacto. Sin uno, el subagente no tiene una señal clara de cuándo ha hecho suficiente: sigue ejecutándose, acumula contexto y consume tokens. Un formato de salida estructurado crea un punto de parada natural. El subagente sabe que ha terminado cuando los campos obligatorios están completos. En la práctica, esto significa añadir un esquema explícito —un bloque de resumen, una lista de hallazgos, un campo de estado— directamente al prompt del sistema del subagente. > *"Without a defined output format, sub agents struggle to decide when enough research has been done and they tend to run much much longer than sub agents that are given an output format."* ## [02:04] Reportar obstáculos en el resumen Cuando un subagente resuelve un problema —un conflicto de dependencias, un comando que necesita flags inesperados, una peculiaridad del entorno— el hilo principal necesita esa información o chocará con la misma pared en el siguiente paso. La solución es exigir el reporte de obstáculos dentro del propio formato de salida. El narrador enumera las categorías que siempre deben incluirse: obstáculos encontrados, problemas de configuración, soluciones alternativas descubiertas, comandos que requirieron flags o configuración especial, e importaciones o dependencias que causaron problemas. Incluir estas categorías en el esquema de salida obligatorio garantiza que el hilo principal herede los descubrimientos del subagente en lugar de redescubrirlos desde cero. > *"Otherwise, the main thread has to rediscover the same solutions, obstacles encountered, any setup issues, workarounds discovered or environment quirks, commands that needed special flags or configuration, dependencies or imports that cause problems."* ## [02:42] Limitar el acceso a herramientas por rol El acceso a herramientas no es solo un control de seguridad: es también una herramienta de claridad. Un subagente de solo lectura con únicamente `glob`, `grep` y `read` no puede modificar archivos por accidente, lo que hace que su rol sea inequívoco para cualquiera que lea la configuración. El narrador asigna tres niveles de acceso a tres roles de subagente: el subagente de investigación recibe acceso de solo lectura porque explorar el código base no requiere escritura; el revisor obtiene `bash` para `git diff` pero sin herramientas de edición de archivos; solo los subagentes encargados explícitamente de modificar código —como uno que aplica actualizaciones de CSS— reciben `edit` y `write`. Con varios subagentes en juego, la lista de herramientas se convierte en un resumen legible por máquina de lo que se supone que hace cada uno. > *"Only give edit and write to sub agents that should actually change your code, like a styling agent applying CSS updates."* ## [03:27] Los cuatro patrones de un subagente efectivo El tutorial cierra con un resumen en una sola oración de los cuatro patrones: salida estructurada, reporte de obstáculos, descripciones específicas y acceso restringido a herramientas. Cada patrón refuerza a los demás: las descripciones precisas reducen la ambigüedad en los prompts de entrada, los formatos de salida crean puntos de parada, el reporte de obstáculos preserva el contexto entre límites de agentes, y el acceso mínimo a herramientas evita efectos secundarios que agudizarían cualquier ambigüedad restante. > *"So effective sub agents use structured output report obstacles have specific descriptions and limit tool access."* ## Entidades - **Anthropic Tutorial Narrator** (Persona): presentador de la serie de tutoriales de subagentes de Claude Code, en representación de Anthropic - **Claude Code** (Software): herramienta de codificación agéntica de Anthropic que orquesta subagentes para completar tareas de ingeniería en múltiples pasos - **Subagent** (Concepto): instancia especializada de Claude lanzada por un agente orquestador, con su propio prompt de sistema, acceso a herramientas y prompt de entrada - **Formato de salida** (Concepto): esquema obligatorio definido en el prompt del sistema de un subagente que crea una condición de parada y estructura la información devuelta al hilo principal - **Reporte de obstáculos** (Concepto): patrón que requiere que los subagentes informen de soluciones alternativas, problemas de dependencias y particularidades del entorno en su salida, para que el orquestador no tenga que redescubrirlos - **Restricción del acceso a herramientas** (Concepto): limitar cada subagente a únicamente las herramientas que requiere su rol — solo lectura para investigación, bash para revisión, edit/write solo para agentes que deben modificar archivos - **Anthropic** (Organización): creador de Claude y de la plataforma de codificación agéntica Claude Code

Los subagentes son asistentes especializados a los que Claude Code puede delegar tareas — cada uno opera en su propia ventana de contexto aislada, completa el trabajo de forma autónoma y devuelve un resumen concreto mientras se descarta todo el rastro intermedio. Este tutorial de dos minutos de Anthropic explica por qué ese aislamiento es clave para mantener usable la ventana de contexto principal, ilustra el tradeoff con un escenario real de exploración de código y enumera los subagentes integrados que incluye Claude Code hoy. ## [00:03] Qué son los subagentes Un subagente se ejecuta en su propia ventana de contexto de conversación, inicializada con un system prompt personalizado que tú defines. El agente principal (Claude Code en el hilo principal) le pasa al subagente una descripción de la tarea según lo que pediste. El subagente la resuelve de forma autónoma y devuelve un resumen al hilo principal, mientras todo el trabajo intermedio queda aislado. > *"Sub-agents are specialized assistants that Claude can delegate tasks to."* El punto de diseño clave: cuando el subagente termina, su hilo de conversación completo se descarta. Solo el resumen devuelto regresa a la conversación principal. ## [00:24] Gestión de la ventana de contexto Cada llamada a herramientas que Claude hace en el hilo principal — lecturas de archivos, búsquedas, trazas de funciones — se acumula en la ventana de contexto principal. En una sesión larga, eso se llena rápido. Los subagentes existen precisamente para externalizar tareas discretas de investigación o acción sin que ese coste recaiga en la ventana principal. > *"Each sub-agent runs in its own conversation contacts window with a custom system prompt that you define."* El tradeoff es explícito: la ventana principal gana contexto limpio, pero pierde visibilidad sobre cómo llegó el subagente a sus conclusiones y qué descubrió en el camino. Obtienes la respuesta, no la traza de razonamiento. ## [01:13] Un ejemplo concreto: el sistema de pagos Imagina que usas Claude Code para descubrir qué servicio gestiona los reembolsos en un codebase desconocido. Sin subagente, Claude podría leer 15 archivos, ejecutar varias búsquedas y recorrer múltiples llamadas a funciones — y todo eso llena la ventana de contexto principal aunque solo necesitabas un dato. > *"With a sub-agent, you get the answer without the journey."* El subagente explora el codebase, encuentra la respuesta y devuelve un resumen concreto, manteniendo limpio tu contexto principal. La visibilidad perdida es el coste: no verás qué archivos leyó ni qué trazas siguió para llegar ahí. ## [02:00] Los subagentes integrados de Claude Code Claude Code incluye tres subagentes integrados listos para usar de inmediato: - **Subagente de uso general** — para tareas de varios pasos que requieren tanto exploración como acción. - **Subagente de exploración** — búsqueda rápida en codebases sin la sobrecarga de un ciclo de tarea completo. - **Subagente de planificación** — se ejecuta en el modo plan para investigar y analizar el codebase antes de presentarte un plan. > *"And you can also create your own sub-agents with custom system prompts and tool access."* Más allá de estos tres, puedes definir subagentes personalizados con sus propios system prompts y listas de herramientas, adaptados a flujos de trabajo específicos. ## [02:30] Cuándo usar subagentes Los subagentes son rentables cuando tienes una pregunta o tarea discreta y autocontenida que, de otro modo, volcaría mucho contexto intermedio en tu ventana principal. > *"Sub-agents like Claude Code break work into focused pieces, keep your main context window clean, and bring back just what you need, whether you're using the built-in ones or creating your own."* Son más valiosos en sesiones largas de Claude Code donde la presión sobre la ventana de contexto se acumula — delegar una subtarea a un subagente en lugar de dejar que se extienda por el hilo principal prolonga directamente la efectividad de la sesión. ## Entidades - **Anthropic Tutorial Narrator** (Persona): narrador de la serie de tutoriales "Claude Code subagents" producida por Anthropic - **Claude Code** (Software): el asistente de codificación agéntico de Anthropic; el entorno anfitrión en el que operan los subagentes - **Claude** (Software): el modelo de IA subyacente que impulsa Claude Code y sus subagentes - **Sub-agent** (Concepto): un asistente especializado al que Claude Code delega tareas, ejecutándose en una ventana de contexto aislada con su propio system prompt - **Context window** (Concepto): el buffer finito de tokens que contiene todo el historial de conversación, llamadas a herramientas y resultados; los subagentes evitan que se llene con trabajo intermedio - **General-purpose sub-agent** (Software): subagente integrado de Claude Code para tareas de exploración y acción en varios pasos - **Explore sub-agent** (Software): subagente integrado de Claude Code optimizado para búsqueda rápida en codebases - **Plan sub-agent** (Software): subagente integrado de Claude Code que investiga el codebase en el modo plan antes de presentar un plan - **Anthropic** (Organización): creador de Claude y Claude Code; productor de esta serie de tutoriales

Los skills de Claude Code son archivos Markdown reutilizables que codifican conocimiento especializado una sola vez. Claude los activa automáticamente cuando una solicitud encaja, sin que el usuario tenga que repetir instrucciones ni escribir un comando slash. Este tutorial de tres minutos explica qué son los skills, dónde viven, en qué se diferencian de los archivos CLAUDE.md y qué señal indica que ya es hora de escribir uno. ## [00:03] El problema de repetición que resuelven los skills Cada vez que explicas los estándares de código de tu equipo, vuelves a describir cómo quieres que se estructure el feedback de una PR o recuerdas a Claude el formato de commit que prefieres, te estás repitiendo. El narrador encadena tres ejemplos para nombrar con precisión el punto de fricción que los skills eliminan. > *"Every time you explain your team's coding standards to Claude, you're repeating yourself."* ## [00:20] Qué es un skill y cómo lo elige Claude Un skill es un archivo Markdown que le enseña a Claude cómo hacer algo, una sola vez. Claude almacena la instrucción y la aplica automáticamente cada vez que la situación lo requiere. En Claude Code, ese archivo se llama SKILL.md. El campo description dentro del archivo es el mecanismo clave: cuando le pides a Claude que revise una PR, compara tu solicitud con todas las descripciones de skills disponibles y activa la que corresponde. > *"Claude reads your request, compares it to all available skill descriptions, and activates the ones that match."* ## [01:05] Dónde guardar los skills: personal o de proyecto Los skills tienen dos ubicaciones según quién los necesite. Los skills personales van en `~/.claude/skills` y te siguen de proyecto en proyecto: estilo de commit, formato de documentación, cómo te gusta que te expliquen el código. Los skills de proyecto van en `.claude/skills` dentro de la raíz del repositorio; cualquiera que clone el repo los obtiene automáticamente. Ahí es donde viven los estándares del equipo: directrices de marca, fuentes y colores preferidos para el diseño web. > *"Anyone who clones the repository gets these skills automatically."* ## [01:42] Skills vs CLAUDE.md: automáticos y eficientes en contexto Claude Code ofrece varias capas de personalización, y los skills ocupan un lugar propio. Los archivos CLAUDE.md se cargan en cada conversación de forma incondicional, lo que los hace ideales para reglas como "usar siempre el modo estricto de TypeScript". Los skills se cargan bajo demanda, solo cuando coinciden con la solicitud actual, y en ese momento solo el nombre y la descripción entran al contexto. El cuerpo completo del skill se carga únicamente al activarse. Así, la checklist de revisión de PR no ocupa el contexto mientras depuras, y solo aparece cuando de verdad pides una revisión. Los comandos slash requieren escribirlos; los skills, no. > *"Skills are unique because they're automatic and task-specific."* ## [02:27] Cuándo escribir un skill Los skills funcionan mejor con conocimiento especializado ligado a tareas concretas: los estándares de revisión de código del equipo, formatos de commit, directrices de marca. La regla final es directa y práctica: si te encuentras explicándole lo mismo a Claude una y otra vez, eso es un skill esperando ser escrito. > *"If you find yourself explaining the same thing to Claude repeatedly, well, that's a skill waiting to be written."* ## Entidades - **Anthropic Tutorial Narrator** (Persona): narrador y presentador de la serie de tutoriales de Claude Code skills - **Claude Code** (Software): asistente de codificación AI de Anthropic; el entorno de ejecución donde los skills se descubren y aplican - **SKILL.md** (Concepto): el archivo Markdown que define un skill — contiene un nombre, una descripción e instrucciones para Claude - **CLAUDE.md** (Concepto): archivo de instrucciones a nivel de proyecto o global que se carga en cada conversación de Claude Code de forma incondicional, en contraste con los skills - **Anthropic** (Organización): creador de Claude y Claude Code

Un skill de revisión de PR que usa un solo ingeniero resulta útil; ese mismo skill desplegado en todo el equipo estandariza la revisión de código y crea una experiencia coherente en toda la organización. Este tutorial recorre cuatro métodos de distribución concretos — commits en el repositorio, plugins, configuración empresarial gestionada y sub-agentes personalizados — y explica con precisión cuándo aplicar cada uno. La sección de sub-agentes tiene un matiz que pasa fácilmente desapercibido: los sub-agentes no heredan los skills del hilo principal de forma automática, y los agentes integrados no pueden acceder a ellos en absoluto. ## [00:01] Por qué compartir multiplica el valor de los skills Un skill que permanece en manos de un solo desarrollador cumple su función. El mismo skill extendido a un equipo consolida estándares, elimina la variación individual y hace que cada revisión tenga el mismo aspecto y la misma calidad. El tutorial abre con un contraste directo entre el uso individual y el uso a escala de equipo, antes de presentar los cuatro mecanismos de distribución. > *"A PR review skill that only you use is helpful. The same skill shared across your team standardizes code review and provides a consistent experience amongst your organization which is much better."* ## [00:18] Añadir skills al repositorio del proyecto El método de menor fricción: colocar los skills en `.claude/skills` dentro del repositorio del proyecto. Quien clone el repositorio los obtiene de inmediato, sin pasos de instalación adicionales ni herramientas extra. Las actualizaciones llegan con el ciclo habitual de `git pull`. Este camino encaja con estándares de codificación de equipo, flujos de trabajo específicos del proyecto y skills que referencian la estructura propia del código. > *"Anyone who clones the repository gets these skills automatically. No extra installation, it's just what you're doing already."* ## [00:45] Distribuir skills mediante plugins Los plugins amplían Claude Code con funcionalidades personalizadas diseñadas para circular más allá de un proyecto concreto. Dentro del proyecto del plugin, un directorio `skills/` replica la estructura de `.claude/` — nombre del skill, `SKILL.md`. Una vez publicado en un marketplace, cualquier usuario de Claude Code puede descargarlo y activarlo. Este canal es el más adecuado para skills lo suficientemente generales como para servir a la comunidad en sentido amplio, en lugar de a las convenciones de un equipo concreto. > *"Think of plugins as ways to extend Claude Code with custom functionality, but designed to be shared across teams and projects."* ## [01:26] Despliegue empresarial a través de la configuración gestionada Los administradores pueden enviar skills a todos los desarrolladores de la organización mediante la configuración gestionada. Los skills empresariales tienen la máxima prioridad: sobrescriben los skills personales, de proyecto y de plugin que compartan el mismo nombre. El uso previsto son los estándares obligatorios — requisitos de seguridad, flujos de cumplimiento normativo, prácticas de codificación que deben ser uniformes. El narrador subraya la palabra "deben": no son sugerencias. > *"This is for mandatory standards, security requirements, compliance workflows, or coding practices that must be consistent across the organization."* ## [01:52] Sub-agentes personalizados y carga explícita de skills Los sub-agentes no heredan los skills de la conversación principal. Los agentes integrados (explorer, planner, verify) no pueden acceder a los skills en absoluto. Solo los sub-agentes personalizados — definidos mediante un archivo `agent.md` en `.claude/agents` — pueden usar skills, y únicamente los que figuren de forma explícita en el campo `skills:` de ese archivo. Los skills se cargan cuando el sub-agente arranca, no bajo demanda, por lo que la lista debe mantenerse ajustada: solo los skills siempre relevantes para el propósito del agente. El tutorial muestra cómo crear un sub-agente con la herramienta de creación de sub-agentes de Claude Code y cómo añadir skills a un `agent.md` existente. > *"Built-in agents like the explorer, planner, and verify can't access skills at all. Only custom sub-agents you define can use them, and only when you explicitly list them."* ## [03:18] Resumen: cómo elegir el método de distribución adecuado El cierre asocia cada método con su escenario: directorios de proyecto para el acceso del equipo, plugins para el uso entre repositorios, despliegue empresarial para los estándares obligatorios a escala de organización, y listas explícitas de skills en sub-agentes para la delegación de tareas aisladas. El aviso sobre los sub-agentes se repite una vez más — incluir solo los skills siempre pertinentes para el propósito de un agente determinado, dado que se cargan al inicio, no de forma diferida. > *"Share skills through project directories for team access, plugins for cross-repository distribution, or enterprise deployment for organization-wide standards."* ## Entidades - **Narrador del tutorial de Anthropic** (Persona): presentador único de la serie de tutoriales de skills de Claude Code - **Claude Code** (Software): asistente de programación con IA de Anthropic; entorno de ejecución donde los skills se crean y despliegan - **Skills** (Concepto): conjuntos de instrucciones reutilizables ubicados en `.claude/skills` que amplían el comportamiento de Claude Code - **Plugins** (Concepto): paquetes distribuibles que agrupan skills para compartirlos entre equipos y usuarios del marketplace - **Managed settings** (Concepto): mecanismo administrativo empresarial para desplegar skills en toda la organización con la máxima prioridad - **Sub-agents** (Concepto): agentes personalizados de Claude Code definidos mediante `agent.md` en `.claude/agents`; el único tipo de agente que puede cargar skills, y solo cuando se listan explícitamente - **Anthropic** (Organización): empresa que desarrolló Claude Code y produce la serie de tutoriales de skills de Claude Code

Tutorial de cuatro minutos de la serie Claude Code skills dedicado a los campos de configuración avanzados que convierten un skill básico en una herramienta fiable y eficiente en contexto. El presentador recorre el conjunto completo de campos de agentskills.io — `name`, `description`, `allowed_tools`, `model` — y explica cómo estructurar skills de gran tamaño mediante divulgación progresiva, de modo que los materiales de referencia y los scripts solo se carguen cuando la solicitud del usuario realmente los requiera. ## [00:02] Panorama de los campos avanzados de un skill El estándar abierto agentskills.io define varios campos más allá de los obligatorios `name` y `description`. `name` debe estar en minúsculas con guiones, con un máximo de 64 caracteres y debe coincidir con el nombre del directorio. `description` admite hasta 1.024 caracteres y es la señal principal que usa Claude para asociar un skill a una solicitud. Dos campos opcionales completan la configuración: `allowed_tools`, que restringe las herramientas que el skill puede invocar, y `model`, que ancla el skill a una versión concreta de Claude. > *"Un skill básico funciona solo con name y description, pero aquí hay algunos consejos avanzados para que tus skills sean realmente efectivos en Claude Code."* ## [00:39] Cómo escribir descripciones efectivas Una descripción vaga — "help with dogs" — deja a Claude adivinando el alcance y los disparadores del skill. Una buena descripción responde exactamente a dos preguntas: ¿qué hace este skill y cuándo debe usarlo Claude? Alinear las palabras clave con la forma natural en que los usuarios expresan sus solicitudes es el mecanismo para corregir skills que no se activan. > *"Una buena descripción responde a dos preguntas: ¿qué hace este skill? ¿Y cuándo debe usarlo Claude?"* ## [01:20] Restricción de herramientas con allowed_tools `allowed_tools` es el mecanismo para limitar un skill a una superficie de operación definida: acceso de solo lectura para flujos de trabajo sensibles desde el punto de vista de la seguridad, por ejemplo. Cuando el campo está configurado, Claude solo puede llamar a esas herramientas sin pedir permiso; queda excluida cualquier acción de edición, escritura o Bash. Omitir el campo deja intacto el modelo de permisos habitual de Claude. > *"Cuando este skill está activo, Claude solo puede usar esas herramientas sin pedir permiso. Ni edición, ni escritura, ni comandos bash."* ## [01:49] Divulgación progresiva para skills de múltiples archivos Los skills comparten la ventana de contexto de Claude con la conversación en curso. Meter todo en un `SKILL.md` de 20.000 líneas infla el contexto en cada invocación y convierte el archivo en una pesadilla de mantenimiento. La solución: colocar las instrucciones esenciales en `SKILL.md` y mover el material de referencia a archivos separados que Claude solo lee cuando la solicitud activa realmente lo requiere. El estándar sugiere tres directorios de apoyo — `scripts/` para código ejecutable, `references/` para documentación y `assets/` para imágenes y plantillas. Un enlace en `SKILL.md` funciona como una entrada de índice; si el tema no surge, el archivo nunca se carga. Los scripts del directorio del skill se ejecutan sin cargar su código fuente en el contexto: solo su salida consume tokens. El presentador recomienda mantener `SKILL.md` por debajo de 500 líneas; superarlo es señal de que el skill debe dividirse. > *"Es como tener un índice en la ventana de contexto en lugar de meter todo el documento ahí dentro."* ## [03:18] Resumen: metadatos del skill y buenas prácticas El tutorial cierra repasando la superficie de configuración completa: `name` y `description` son obligatorios; `allowed_tools` restringe la superficie de herramientas; `model` ancla la versión de Claude. Las descripciones necesitan verbos de acción concretos y frases disparadoras para hacer coincidir de forma fiable. Para skills de mayor tamaño, la divulgación progresiva mantiene `SKILL.md` bajo las 500 líneas y pospone la carga de los archivos de apoyo hasta que realmente se necesiten. Los scripts se ejecutan sin cargar su código fuente, lo que mantiene el contexto ajustado. > *"Los scripts pueden ejecutarse sin cargar su contenido, manteniendo el contexto eficiente."* ## Entidades - **Presentador de Anthropic** (Persona): anfitrión único de esta serie de tutoriales, dedicado a explicar la configuración de skills en Claude Code. - **Claude Code** (Software): herramienta CLI de Anthropic que carga y ejecuta skills según el estándar agentskills.io. - **agentskills.io** (Organización): estándar abierto que define el esquema del manifiesto de skills, incluyendo `name`, `description`, `allowed_tools`, `model` y las convenciones de directorios. - **SKILL.md** (Concepto): archivo de manifiesto principal de un skill de Claude Code; debe mantenerse por debajo de 500 líneas con enlaces a los archivos de apoyo. - **allowed_tools** (Concepto): campo opcional del skill que especifica en lista blanca las herramientas de Claude permitidas, habilitando modos de skill de solo lectura o en entorno aislado. - **Divulgación progresiva** (Concepto): estructuración de un skill de múltiples archivos para que los archivos de referencia y los scripts solo se carguen en el contexto cuando la solicitud activa realmente los requiere. - **Ventana de contexto** (Concepto): presupuesto de tokens compartido entre la conversación y los archivos de skill que Claude carga; el recurso clave que la divulgación progresiva busca preservar.

Este tutorial de 3 minutos muestra cómo construir una habilidad personal de Claude Code desde cero: crear un directorio con un archivo SKILL.md, verificar que la habilidad se carga al arrancar y observar cómo Claude la aplica a una solicitud real. La segunda mitad explica con precisión el pipeline de carga de habilidades — las cuatro ubicaciones de escaneo, el paso de inicio que solo carga nombres, la puerta de confirmación y el orden de prioridad de cuatro niveles que resuelve los conflictos de nombres. ## [00:03] Qué construye este tutorial El narrador abre con el objetivo concreto: una habilidad que enseñe a Claude a explicar código usando diagramas visuales y analogías. Una vez construida, el tutorial también rastrea qué ocurre internamente cuando Claude detecta y ejecuta una habilidad. > *"This skill will teach Claude how we would like it to explain code using visual diagrams and analogies."* ## [00:18] Creación del archivo de habilidad Las habilidades personales viven bajo el directorio personal (no dentro de un proyecto), así que el primer paso es crear un nuevo directorio con el nombre de la habilidad dentro de `~/.claude/skills/`. Dentro de ese directorio va un único archivo SKILL.md. Tres secciones importan: `name` (el identificador que Claude almacena al arrancar), `description` (el criterio que Claude usa para decidir si invocar la habilidad) y todo lo que sigue al segundo delimitador `---` (las instrucciones reales que Claude sigue cuando la habilidad se activa). > *"Take into consideration that we're creating a directory with the skill name inside of the skills directory."* ## [00:52] Carga y prueba de tu habilidad Claude Code escanea las habilidades al arrancar, no bajo demanda, por lo que se necesita reiniciar la sesión después de crear el archivo. Al ejecutar `/skills` debería aparecer el nombre de la habilidad recién creada. Para probarla, se cambia a una rama con cambios y se envía la solicitud en lenguaje natural "Write a PR description for my changes". Claude indica que está invocando la habilidad PR description, lee el diff y escribe una descripción que sigue la plantilla, con el mismo formato cada vez. > *"Claude will then show you that it's using the PR description skill."* ## [01:25] Cómo carga Claude las habilidades internamente Al arrancar, Claude Code escanea cuatro ubicaciones: configuración gestionada por la empresa, `~/.claude/skills/` personal, el directorio `.claude/` del proyecto y los plugins instalados. Solo carga el `name` y la `description`, no el contenido completo. Cuando llega una solicitud, Claude la compara con las descripciones almacenadas; "explain what this function does" coincide con "explain code with visual diagrams", por lo que la habilidad se activa. Claude pide confirmación antes de leer el SKILL.md completo, de modo que el usuario siempre sabe qué contexto se está inyectando. > *"It loads only the name and description of each skill, not the full content. This is important later."* ## [02:02] Reglas de prioridad y conflictos de nombres Clonar un repositorio que incluye sus propias habilidades puede crear colisiones de nombres. Claude las resuelve con una escala de prioridad fija: empresa (mayor) → personal → proyecto → plugins (menor). Una habilidad `code-review` de empresa siempre supera a una habilidad personal con el mismo nombre. La solución práctica es usar nombres descriptivos: `security-review` o `frontend-pr-review` en lugar del genérico `review`, para evitar conflictos desde el principio. > *"If your company has an enterprise code review skill and you create a personal code review skill, the enterprise version of that takes precedence."* ## [02:52] Actualización y eliminación de habilidades Actualizar una habilidad es tan directo como editar el archivo SKILL.md y guardar los cambios. Eliminar una habilidad significa borrar el directorio. Ambas operaciones requieren reiniciar Claude Code para que el cambio surta efecto — la lista de habilidades se construye una sola vez al iniciar la sesión y no se monitorea en tiempo real. > *"Edit the skill.md file to update a skill and restart Claude Code for changes to take effect."* ## Entidades - **Narrador del tutorial de Anthropic** (Persona): presentador único del tutorial de creación de habilidades en la serie Claude Code skills - **Claude Code** (Software): CLI de Anthropic para Claude; escanea habilidades al arrancar y las aplica cuando las solicitudes del usuario coinciden con las descripciones de las habilidades - **SKILL.md** (Concepto): el único archivo que define una habilidad — contiene un frontmatter YAML (name, description) y texto de instrucciones libre tras el segundo delimitador `---` - **Habilidades** (Concepto): conjuntos de instrucciones reutilizables y con nombre que enseñan a Claude un patrón de comportamiento consistente; almacenados como directorios que contienen un archivo SKILL.md - **Habilidades de empresa** (Concepto): habilidades gestionadas por la organización que ocupan el nivel más alto del orden de prioridad de cuatro niveles, por encima de las habilidades personales, de proyecto y de plugin - **Anthropic** (Organización): creador de Claude y Claude Code; publica esta serie de tutoriales en claude.com/resources/courses

Claude Code ofrece a los desarrolladores cinco mecanismos de personalización distintos — Skills, CLAUDE.md, subagentes, hooks y servidores MCP — cada uno diseñado para un propósito diferente. Este tutorial de tres minutos asigna cada opción a su caso de uso correcto, para que no recurras a Skills cuando CLAUDE.md es suficiente, ni configures un hook cuando lo que necesitas es un subagente. ## [00:02] Cinco opciones de personalización, un problema de elección Claude Code incluye cinco formas de configurar su comportamiento: Skills, CLAUDE.md, subagentes, hooks y servidores MCP. El narrador los enumera rápidamente y enseguida reorienta la pregunta: de "¿qué son?" a "¿cuál corresponde aquí?" > *"Resuelven problemas distintos. Saber cuándo usar cada uno evita que construyas lo que no necesitas."* El resto del tutorial es, en esencia, la respuesta a esa única pregunta. ## [00:18] CLAUDE.md vs Skills: siempre activo vs bajo demanda CLAUDE.md es un archivo que Claude lee al inicio de cada conversación, sin necesidad de activación. Es el lugar adecuado para las restricciones a nivel de proyecto que nunca deben olvidarse — elección de frameworks, estilo de código, reglas de base de datos. Las Skills, en cambio, se cargan bajo demanda: la lista de verificación para revisiones de PR solo entra en el contexto cuando realmente solicitas una revisión, no mientras escribes código nuevo. > *"Use Claude MD for project-wise standards that always apply constraints like never modify the database schema, framework preferences, and coding style."* La distinción está entre permanencia y relevancia. Si la instrucción debe aplicarse a cada prompt del proyecto, va en CLAUDE.md. Si solo es útil en determinados momentos, va en una Skill. ## [01:03] Skills vs subagentes: contexto compartido vs ejecución aislada Las Skills inyectan conocimiento en la conversación actual — sus instrucciones se suman al contexto existente. Los subagentes funcionan de otra manera: reciben una tarea, crean un contexto de ejecución separado, trabajan de forma independiente y devuelven los resultados sin tocar la conversación principal. > *"Use sub agents when you want to delegate a task to a separate execution context. You need different tool access that the main conversation does. You want isolation between delegated work and your main context."* Usa Skills cuando una expertise debe orientar el razonamiento de Claude a lo largo de una conversación en curso. Usa subagentes cuando quieras una frontera clara entre la sesión principal y una unidad de trabajo delegada — herramientas distintas, sin contaminación de contexto. ## [01:42] Hooks vs Skills: orientado a eventos vs orientado a solicitudes Los hooks se ejecutan automáticamente ante eventos — un linter que corre cada vez que Claude guarda un archivo, o una validación de entrada antes de ciertas llamadas a herramientas. No los activa lo que preguntas, sino lo que Claude hace. Las Skills son lo opuesto: orientadas a solicitudes, se activan cuando una consulta coincide con ellas. > *"A hook might run a llinter every time Claude saves a file or validate input before certain tool calls. They're all event driven, while skills, they're request driven. They activate based on what you're asking."* Si el comportamiento debe ocurrir de forma incondicional ante un evento del sistema, es un hook. Si debe influir en cómo piensa Claude cuando se le pregunta algo, es una Skill. ## [02:15] Combinar los cinco para una personalización completa Una configuración de Claude Code bien ajustada asigna a cada herramienta su rol natural: CLAUDE.md para los estándares de proyecto siempre activos, Skills para la expertise específica de tareas que no debe saturar cada prompt, hooks para los efectos secundarios automatizados, subagentes para el trabajo delegado en aislamiento, y servidores MCP para el acceso a herramientas externas. No son alternativas entre sí — se combinan. > *"Don't force everything into skills when another option fits best. You can use multiple at a time."* Las Skills se activan automáticamente cuando el tema es relevante; CLAUDE.md siempre está presente; los subagentes corren en aislamiento; los hooks se disparan ante eventos; MCP proporciona herramientas externas. Elige el nivel adecuado para cada necesidad y combínalos libremente. ## Entidades - **Narrador del tutorial de Anthropic** (Persona): Presentador de esta serie de tutoriales de Claude Code skills, en representación de Anthropic. - **Claude Code** (Software): Asistente de programación con IA de Anthropic; tema central de la serie de tutoriales. - **Skills** (Concepto): Paquetes de conocimiento bajo demanda que se activan cuando Claude detecta una coincidencia con la solicitud del usuario; inyectan instrucciones en el contexto de la conversación actual. - **CLAUDE.md** (Concepto): Archivo de configuración que se carga automáticamente en cada conversación de Claude Code; usado para estándares y restricciones permanentes a nivel de proyecto. - **Subagentes** (Concepto): Contextos de ejecución independientes que se crean para gestionar tareas delegadas en aislamiento de la conversación principal. - **Hooks** (Concepto): Automatización orientada a eventos que se dispara ante acciones específicas de Claude — como guardar un archivo o realizar una llamada a herramienta — con independencia de las solicitudes del usuario. - **Servidores MCP** (Software): Servidores Model Context Protocol que proporcionan herramientas externas a las sesiones de Claude Code. - **Anthropic** (Organización): Creador de Claude Code y editor de la serie de tutoriales de Claude Code skills.