Skills y plugins en Claude Code: qué son, cómo instalarlos y cuándo crear los tuyos
Respuesta corta: una skill es un archivo de instrucciones que Claude Code carga solo cuando la tarea lo pide, y un plugin es un paquete que instala de una vez varias skills, subagentes y conexiones. Para instalar un plugin, escribe /plugin en una sesión de Claude Code y elígelo del catálogo.
Quien empieza a usar Claude Code para tareas de marca y marketing suele pasar por la misma etapa: copiar y pegar las mismas instrucciones en cada conversación. El checklist del post, la forma de armar un brief, las reglas de revisión. Las skills y los plugins existen para sacarte ese trabajo de encima, y entender en qué se diferencian ahorra tiempo y tokens.
Este es el segundo texto de nuestra serie sobre agentes de IA aplicados a la marca. En el primero explicamos qué son los subagentes y los equipos de agentes. Aquí el tema son las skills, que guardan procedimientos, y los plugins, que empaquetan skills, agentes y otras piezas para instalarlas de una vez. Los datos técnicos vienen de la documentación oficial de Claude Code, consultada en octubre de 2026.
Si los agentes de IA todavía son un tema nuevo para ti, nuestra guía de IA agéntica explica el concepto, y el texto sobre cómo usar IA en marca muestra las etapas de quien está empezando.
Qué es una skill
Una skill es una carpeta con un archivo llamado SKILL.md, que contiene instrucciones para una tarea específica. Claude usa la skill por su cuenta cuando el pedido coincide con ella, o tú la llamas por su nombre escribiendo /nombre-de-la-skill. En la práctica, es un procedimiento que se escribe una vez y se reutiliza cada vez que aparece la tarea.
La skill tiene una ventaja frente a pegar instrucciones en la conversación: cuesta poco mientras no se usa. Claude Code mantiene en el contexto solo la descripción de cada skill, para saber que existe. El cuerpo, con las instrucciones completas, entra solo cuando se usa. Por eso puedes guardar un manual largo sin cargar cada conversación.
Los antiguos comandos personalizados, que vivían en .claude/commands/, quedaron incorporados a las skills. Un archivo .claude/commands/briefing.md y una skill .claude/skills/briefing/SKILL.md crean el mismo /briefing. La skill suma la carpeta de apoyo y la posibilidad de que Claude la llame sin que se lo pidas.
Cómo es una skill por dentro
El archivo empieza con un encabezado corto y sigue con las instrucciones en texto común. Un ejemplo pensado para quien publica en un blog:
---
name: checklist-de-post
description: Revisa un post de blog antes de publicarlo. Úsala cuando un borrador esté listo para la revisión final.
---
Revisa el borrador en este orden y enumera lo que falta, sin reescribir el texto:
1. Title de hasta 60 caracteres, con la palabra clave al principio.
2. Description de hasta 132 caracteres.
3. Al menos tres enlaces internos con texto ancla descriptivo.
4. Párrafos de hasta 60 palabras.
5. Texto alternativo en la imagen de portada.Igual que con los subagentes, el campo que más pesa es description. Es el que le dice a Claude cuándo sirve la skill. La documentación recomienda mantener el SKILL.md por debajo de 500 líneas y advierte que la descripción se corta en el listado a partir de 1.536 caracteres.
La carpeta puede guardar más que el SKILL.md. Ejemplos, material de referencia y scripts van en archivos al lado, y el SKILL.md indica cuándo abrir cada uno. Un script se ejecuta sin que su texto entre en el contexto. Las skills personales están en ~/.claude/skills/ y las de un proyecto, en .claude/skills/.
Skill, subagente o CLAUDE.md: cuál usar
Los tres guardan instrucciones, pero cada uno entra en la conversación de una forma distinta, y esa diferencia define cuál usar.
| CLAUDE.md | Skill | Subagente | |
|---|---|---|---|
| Cuándo se carga | En cada sesión, siempre | Solo cuando la tarea lo pide o tú la llamas | Cuando Claude delega la tarea |
| Dónde se ejecuta | En la conversación principal | En la conversación principal | En un contexto separado |
| Sirve para | Reglas que valen todo el tiempo | Procedimientos que se repiten | Tareas largas en las que solo importa el resultado |
| Ejemplo | “Escribe siempre en español neutro” | Checklist de publicación | Leer 40 informes y resumirlos |
Una regla práctica: si la instrucción vale para todo lo que se hace en el proyecto, va en el CLAUDE.md. Si vale para una tarea que aparece de vez en cuando, se convierte en skill. Si la tarea genera mucho material intermedio, va a un subagente, que incluso puede cargar sus propias skills.
Qué es un plugin
Un plugin es una carpeta que reúne skills, subagentes, hooks y servidores MCP para instalarlos y cargarlos juntos. Los hooks son comandos que se ejecutan en momentos fijos, como después de cada edición. Los servidores MCP conectan a Claude con herramientas externas. El plugin se identifica por un archivo de manifiesto, .claude-plugin/plugin.json, con nombre, versión y descripción.
Todo esto funciona sin plugin. Una skill guardada en ~/.claude/skills/ ya vale para todos tus proyectos. El plugin empieza a tener sentido cuando quieres distribuir un conjunto: instalarlo con un comando, recibir actualizaciones y asegurarte de que el equipo use la misma versión. Las skills de un plugin aparecen con el nombre de este adelante, como /mi-plugin:revision.
Cómo instalar un plugin
Los plugins vienen de un marketplace, que es un catálogo: un repositorio con un archivo que lista los plugins y dónde buscar cada uno. Claude Code agrega el marketplace oficial de Anthropic, llamado claude-plugins-official, la primera vez que abres una sesión en la terminal. Para ver lo que ofrece, escribe /plugin y abre la pestaña Discover.
Para instalar por nombre, el formato es plugin@marketplace:
/plugin install commit-commands@claude-plugins-officialPara usar el catálogo de otra empresa o de tu equipo, agrega el marketplace una vez y después instala sus plugins:
/plugin marketplace add dueno/repositorio
/plugin install nombre-del-plugin@nombre-del-marketplaceAl instalar eliges el alcance. El de usuario activa el plugin para ti en todos los proyectos de la computadora. El de proyecto lo activa para todas las personas que trabajan en ese repositorio, mediante el archivo de configuración compartido. El local lo activa solo para ti y solo en ese proyecto.
Qué revisar antes de instalar
Un plugin se ejecuta con tus permisos. Si trae scripts o servidores, estos corren en tu máquina como si fueras tú. La documentación recomienda revisar el plugin antes de instalarlo, y eso también vale para los marketplaces de terceros, que son todos los que no pertenecen a Anthropic, incluido el de un colega.
Los plugins activos también ocupan espacio. El nombre y la descripción de cada skill y agente quedan en el contexto en cada mensaje, incluso en conversaciones donde no se usa nada del plugin. Por eso conviene desactivar lo que no estás usando. En la pestaña de instalados, /plugin muestra los plugins sin uso reciente, y el marketplace oficial muestra una estimación del costo de contexto antes de instalar.
Cómo organizamos nuestros plugins
En Headcore, la operación de marca funciona con Growth System™, seis plugins que distribuimos por un marketplace privado. brandbrain construye el Brand Brain de cada marca, con posicionamiento, voz y reglas. craft produce piezas, surf se ocupa de las páginas y brand-studio, del video. growthmkt mide lo que salió al aire, y mesa-criativa juzga cada pieza antes de publicarla. Juntos suman 17 subagentes.
La decisión que más pesó fue convertir las reglas en estructura. En craft, un concepto que no fue aprobado no genera pieza, porque el código no lo permite.
En growthmkt, la salida no tiene campo para dinero, y una prueba lo verifica en cada versión: el plugin mide, y la decisión de presupuesto sigue en manos de una persona. Lo hicimos así porque el modelo puede pasar por alto una instrucción escrita en el prompt, y no tiene cómo esquivar un bloqueo en el código.
También aprendimos algo sobre las actualizaciones. El plugin instalado vive en una copia separada del repositorio, y editar el archivo en el repositorio no cambia lo que carga la sesión. El cambio solo llega después de subirlo a GitHub y actualizarlo con /plugin. Cuando un ajuste parece no tener efecto, lo primero que hay que revisar es si la sesión está usando la versión nueva.
Por dónde empezar
Empieza por las skills. Elige un procedimiento que le explicas a la IA todas las semanas, como el checklist de un post o la guía de un brief, y conviértelo en un SKILL.md. Pruébala llamándola con /nombre y después observa si Claude la usa por su cuenta cuando el pedido coincide con la descripción.
Cuando tengas algunas skills y uno o dos subagentes que todo el equipo debería usar, empaqueta todo en un plugin y crea un marketplace en un repositorio de la empresa. Antes de instalar plugins de otras personas, lee lo que ejecutan y desactiva lo que dejes de usar.
La serie completa
Este texto es parte de una serie de cinco sobre agentes de IA aplicados a la marca:
- Subagentes y equipos de agentes en Claude Code
- Skills y plugins en Claude Code (este texto)
- CLAUDE.md y Brand Brain: memoria de marca para la IA
- Cómo revisar contenido generado por IA
- Cómo usamos la IA en la operación de Headcore
Preguntas frecuentes
¿Cuál es la diferencia entre una skill y un plugin en Claude Code?
La skill es una instrucción para una tarea, guardada en un archivo SKILL.md. El plugin es un paquete que puede reunir varias skills, subagentes, hooks y servidores MCP para instalarlos y actualizarlos de una sola vez. Toda skill funciona sin plugin; el plugin sirve para distribuir un conjunto.
¿Cuál es la diferencia entre una skill y un subagente?
La skill se ejecuta dentro de la conversación principal y entra en el contexto cuando se usa. El subagente se ejecuta en un contexto separado y devuelve solo el resultado. La skill sirve para procedimientos; el subagente, para tareas largas que generan mucho material intermedio.
¿Se puede crear una skill sin saber programar?
Sí. Una skill es un archivo de texto con un encabezado de dos líneas e instrucciones en lenguaje común. También puedes pedirle a Claude Code que escriba la skill a partir de la descripción del procedimiento. Los scripts son opcionales.
¿Los plugins gastan tokens aunque no se usen?
Un poco. El nombre y la descripción de cada skill y de cada agente del plugin quedan en el contexto en cada mensaje, para que Claude sepa que existen. El contenido completo solo se carga cuando se usa. Desactivar los plugins que no usas reduce ese costo.
¿Es seguro instalar plugins de terceros?
Un plugin se ejecuta con tus permisos, así que vale la pena leer lo que contiene antes de instalarlo, sobre todo scripts, hooks y servidores. Claude Code separa los marketplaces oficiales de Anthropic de los de terceros, y cualquier catálogo fuera de Anthropic entra en la segunda categoría.
¿Dónde se guardan las skills en la computadora?
Las personales están en ~/.claude/skills/<nombre>/SKILL.md y valen para todos los proyectos. Las de un proyecto están en .claude/skills/<nombre>/SKILL.md, dentro del repositorio. Las de los plugins están dentro de la carpeta del plugin instalado.
Fuentes: documentación de Claude Code sobre skills y plugins, consultadas el 21/10/2026.
