Claude Code Skills: crear, instalar y comprobar

¿Copia usted siempre la misma lista de comprobación en el chat? Un skill lo resuelve de una vez por todas. Los Claude Code Skills son carpetas con un archivo SKILL.md que contiene instrucciones para tareas recurrentes. Claude los carga por sí mismo cuando su consulta encaja, o usted los invoca con /nombre. A continuación verá cómo crear, instalar, delimitar y revisar skills.

Todos los datos proceden de la documentación oficial de Claude Code y de la plataforma (fuentes al final), a fecha de octubre de 2026.

¿Qué son los Claude Code Skills y cómo los carga Claude?

Un skill es un archivo SKILL.md con instrucciones. Merece la pena cuando usted copia una y otra vez la misma lista de comprobación o el mismo procedimiento en el chat. Los skills siguen el estándar abierto «Agent Skills». Claude Code lo amplía con funciones como el control de la invocación y la ejecución en un subagente.

Lo decisivo es el principio de carga que la documentación llama «Progressive Disclosure»:

Siempre en el contexto: el nombre y la descripción de cada skill, para que Claude sepa qué hay disponible.
Cuando hace falta: el contenido completo, en cuanto usted escribe /nombre o Claude encuentra un skill que encaja con la consulta.
Solo al acceder: los archivos adjuntos, por ejemplo referencias o scripts. Un script se ejecuta y solo su salida ocupa contexto, no su código.

La descripción cuesta unos 100 tokens por skill; el cuerpo principal de SKILL.md queda por debajo de 5.000 tokens. Por eso los detalles pertenecen a archivos adicionales y no a SKILL.md. Así casi no cuestan nada hasta que Claude los necesita.

¿Dónde se guardan los skills y cómo los instalo?

Para skills propios basta una carpeta. La documentación menciona estas ubicaciones:

~/.claude/skills/<name>/SKILL.md: personal, para todos sus proyectos.
.claude/skills/<name>/SKILL.md: en el proyecto. Si confirma (commit) la carpeta, su equipo también la tiene.
<plugin>/skills/<name>/SKILL.md: skills de plugins, invocables como /plugin-name:skill-name.
Enterprise: skills en el directorio de la configuración gestionada (managed settings) de una organización. Valen para todos los usuarios de los equipos en los que la organización los despliega.

Si los nombres coinciden, rige este orden: Enterprise antes que personal, personal antes que proyecto. Los skills de plugins tienen espacio de nombres propio y no colisionan.

«Instalar» skills ajenos suele significar: añadir un marketplace de plugins y elegir un plugin. El repositorio oficial anthropics/skills describe este camino:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Como alternativa, abra /plugin y elija «Browse and install plugins». Un plugin agrupa skills, subagentes, hooks y servidores MCP en una sola unidad. Para un único skill no necesita empaquetarlo: basta una carpeta con SKILL.md.

Skill, CLAUDE.md, comando slash, subagente o MCP: ¿qué encaja cuándo?

Estas funciones resuelven problemas distintos y se complementan. La tabla resume la visión general oficial «Extend Claude Code» y la página de skills.

Función	Qué es	Cuándo se carga	Uso típico
Skill	Instrucciones, conocimiento y procedimientos	Descripción siempre, contenido cuando hace falta	Material de referencia, tareas repetibles
CLAUDE.md	Contexto permanente	En cada sesión	Convenciones, reglas del tipo «haz siempre X»
Comando slash (`.claude/commands/`)	Archivo Markdown que crea un `/comando`	Al invocarlo	Los comandos existentes siguen funcionando; los skills añaden archivos auxiliares y control de la invocación
Subagente	Worker aislado con su propia ventana de contexto	Al iniciarlo	Tareas que leen muchos archivos; solo vuelve un resumen
Servidor MCP	Conexión con servicios externos	Al iniciar la sesión (nombres de las herramientas)	Base de datos, Slack, navegador

La regla general: lo que Claude debe saber siempre va en CLAUDE.md, que debería mantenerse por debajo de 200 líneas. Lo que solo se necesita a veces, o que es un procedimiento, va en un skill. Cuando CLAUDE.md se convierte en un procedimiento, es el momento de crear un skill.

MCP y los skills no compiten. MCP aporta las herramientas; un skill explica cómo usarlas con criterio, por ejemplo con el esquema y patrones de consulta. Si algo debe ocurrir con garantía cada vez, los hooks son el medio adecuado. Una regla dentro de un skill es una petición, no una garantía.

¿Cómo creo un skill propio en 5 minutos?

Cree la carpeta: mkdir -p ~/.claude/skills/commit-nachricht.
Cree dentro el archivo SKILL.md. Los metadatos van entre dos líneas --- justo al principio del archivo.
Escriba en description qué hace el skill y cuándo debe activarse, preferiblemente en tercera persona. Opcionalmente, when_to_use añade otros desencadenantes, como formulaciones típicas. El texto se añade a la descripción.
Redacte debajo las instrucciones y traslade las referencias a archivos propios.
Pruebe con /commit-nachricht o con una pregunta adecuada.

---
name: commit-nachricht
description: Schreibt eine Commit-Nachricht aus den vorgemerkten Änderungen. Zu verwenden, wenn nach einer Commit-Nachricht gefragt wird.
---

## Vorgemerkte Änderungen

!`git diff --staged`

## Anweisungen

Fasse die Änderungen oben in einer Betreffzeile und zwei bis drei Stichpunkten zusammen.
Nenne Risiken wie fehlende Fehlerbehandlung. Ist der Diff leer, sage das.

La línea con el signo de exclamación ejecuta el comando antes de que Claude vea el texto. Su salida sustituye al marcador de posición. En el nombre se permiten como máximo 64 caracteres, solo minúsculas, números y guiones. La descripción está limitada a 1.024 caracteres y SKILL.md debería mantenerse por debajo de 500 líneas. Claude Code vigila los directorios de skills y los cambios se aplican dentro de la sesión. Encontrará una guía detallada en nuestra guía de skills.

¿Qué Claude Code Skills merecen la pena y dónde los encuentro en GitHub?

La fuente oficial es el repositorio github.com/anthropics/skills. Contiene ejemplos de cuatro áreas: creatividad y diseño, desarrollo y técnica (por ejemplo, pruebas de aplicaciones web y generación de servidores MCP), empresa y comunicación, y skills de documentos para docx, pdf, pptx y xlsx. Una carpeta template/ ofrece una plantilla.

Dos avisos del repositorio: muchos skills están bajo Apache 2.0, pero los cuatro skills de documentos solo son visibles, no de código abierto. Y, según el proveedor, los skills están pensados «con fines de demostración y formación». Pruébelos a fondo antes de confiar en ellos para tareas críticas.

No existe una lista general de «best claude code skills». Lo sensato es lo que cubre sus tareas recurrentes: listas de comprobación de revisión, procesos de release, conocimiento de esquemas y de API. La base de datos de skills de nuestra comunidad ofrece una colección extraída de la práctica. Como paquete adicional con skills y reglas de verificación para Claude Code existe además Code Guardian.

¿Qué seguridad ofrecen los skills ajenos?

Un skill es software al que Claude puede obedecer. Anthropic recomienda usar skills solo de fuentes de confianza, es decir, escritos por usted mismo o por Anthropic. Un skill malicioso puede hacer que Claude use herramientas o código de forma distinta a la que indica su finalidad. Las posibles consecuencias son la fuga de datos o el acceso no autorizado.

Compruebe antes de usarlo:

Leer todos los archivos: SKILL.md, scripts y recursos. Esté atento a accesos inesperados a la red o a archivos.
Desconfiar de las descargas externas: el contenido cargado puede contener instrucciones y las dependencias pueden cambiar más adelante.
Revisar allowed-tools: las autorizaciones de un skill de proyecto también valen en carpetas no confiables.
Tratar los plugins aparte: pueden contener hooks y servidores MCP que ejecutan código con sus permisos de usuario. /plugin muestra antes de la instalación qué incluye un plugin.
Tener en cuenta las actualizaciones automáticas: el plugin que ha revisado puede cambiar en segundo plano.

Dos ajustes ayudan en esto. La opción disableSkillShellExecution sustituye los comandos de shell incrustados en los skills por un marcador de posición. Resulta útil sobre todo en la configuración gestionada de una organización. Con skillOverrides en los ajustes, usted establece un skill ajeno en «on», «name-only», «user-invocable-only» u «off» sin modificar su archivo.

Preguntas frecuentes

¿Puedo invocar un skill solo a mano?

Sí. Con disable-model-invocation: true, Claude no carga el skill por sí mismo y su descripción queda fuera del contexto. Usted lo inicia entonces con /nombre. La documentación lo recomienda para skills con efectos secundarios, como los despliegues.

¿Necesito un plugin para usar skills?

No. Un skill en ~/.claude/skills/ funciona por sí solo. Un plugin merece la pena cuando usted quiere distribuir varios skills, subagentes, hooks o servidores MCP como una unidad, por ejemplo entre varios repositorios.

¿Cuánto contexto cuestan muchos skills?

De forma permanente solo el nombre y la descripción, unos 100 tokens por skill. Las descripciones vagas o solapadas pueden hacer que Claude cargue el skill equivocado. Formule por tanto con precisión qué hace el skill y cuándo se aplica.

¿Hay límites de longitud?

SKILL.md debería mantenerse por debajo de 500 líneas. El nombre está limitado a 64 caracteres y la descripción a 1.024. Además, Claude Code recorta la descripción y when_to_use conjuntamente en 1.536 caracteres en el directorio de skills.

¿Tengo que reiniciar Claude Code tras los cambios?

Por lo general, no. Claude Code incorpora los skills nuevos, modificados o eliminados dentro de la sesión. Si crea en mitad de una sesión un directorio skills/ totalmente nuevo, ejecute /reload-skills.

¿Cómo comparto skills en el equipo?

Guárdelos en .claude/skills/ dentro del proyecto y confírmelos (commit). Para varios repositorios resulta conveniente un plugin. Los skills de claude.ai y de la API no se sincronizan con Claude Code. Encontrará ayuda para la puesta en marcha en el equipo en Desarrollo con IA.

Fuentes

Fecha: octubre de 2026. Información general; las funciones de Claude Code cambian con frecuencia.

Mantente al día

Recibe los últimos artículos, análisis y novedades del sector directamente en tu bandeja de entrada.

Decida usted qué fuentes le muestra Google

Google le permite elegir qué fuentes aparecen de forma destacada en sus resultados de búsqueda: en las noticias destacadas y en las respuestas de IA. Dos clics y verá los sitios en los que confía.

Añadir provimedia.de a mis fuentes preferidas

Claude Code Skills: crear, instalar y usar con seguridad