Preguntas sobre las skills de Claude, respondidas de forma directa
Doce preguntas que llegan antes que la referencia: qué no es una skill, dónde van los archivos, por qué una nunca se dispara, cómo probarla y qué cambia entre claude.ai, la API y Claude Code. Cada respuesta abre con la versión corta y después explica por qué es cierta.
¿Las skills de Claude son lo mismo que los servidores MCP?
No. Una skill es una carpeta de instrucciones escritas que el agente lee cuando una tarea coincide con su descripción. Un servidor MCP es un proceso en ejecución que expone herramientas nuevas mediante un protocolo. Las skills cambian cómo trabaja el agente con lo que ya tiene. MCP cambia a qué puede llegar.
¿Dónde viven las skills de Claude en el disco?
Una skill es un directorio cuyo nombre coincide con el nombre de su frontmatter y que contiene SKILL.md más los scripts, referencias y recursos opcionales. Dónde se coloca ese directorio decide su alcance: junto a un proyecto para un solo repositorio, o en tu configuración de usuario para todas tus sesiones.
¿Cómo se instala una skill de Claude?
Depende de dónde uses Claude. En Claude Code copias el directorio de la skill en ~/.claude/skills/ o en el .claude/skills/ del proyecto, sin ningún paso de subida. En claude.ai subes la carpeta como archivo ZIP, y con la API de Claude la subes por los endpoints de Skills. Una skill instalada en una superficie no aparece en las demás.
¿Por qué mi skill nunca se activa?
Casi siempre es la descripción. Solo el nombre y la descripción se cargan al arrancar, así que ese único campo es toda la base sobre la que el agente decide que una tarea coincide. Una descripción que dice qué es la skill, sin decir cuándo usarla, no le da al agente nada con qué comparar.
¿Esto va en una skill o en las instrucciones del proyecto?
Las instrucciones del proyecto se leen en cada tarea de ese proyecto. Una skill se lee solo cuando una tarea coincide con su descripción. Pon en las instrucciones lo que siempre es cierto, y en una skill lo que es cierto para un tipo concreto de trabajo.
¿Cuánto contexto consume una skill instalada?
Alrededor de 100 tokens cada una mientras está inactiva, porque al arrancar solo se cargan el nombre y la descripción. El cuerpo de SKILL.md se carga cuando la skill se activa, y la recomendación es mantenerlo por debajo de 5.000 tokens. Los archivos de scripts, references y assets se leen solo cuando la tarea los necesita.
¿Una skill de Claude puede ejecutar código?
Una skill puede llevar código ejecutable en scripts/, y el agente puede correrlo cuando la tarea lo requiere. La skill no se ejecuta sola ni tiene proceso en segundo plano. Quien ejecuta es el agente, con los permisos que le dé tu configuración.
¿Cómo se comparten skills en un equipo?
Guárdalas en el repositorio al que se aplican y deja que el control de versiones haga la distribución. Todo el que clone recibe las mismas skills en la misma revisión, los cambios llegan por revisión como cualquier otro cambio y no hay una copia aparte que se desvíe.
¿En qué se diferencian las skills de los comandos con barra y de los plugins en Claude Code?
En Claude Code, los comandos personalizados se fusionaron con las skills: un archivo en .claude/commands/deploy.md y una skill en .claude/skills/deploy/SKILL.md crean el mismo /deploy. Un plugin es otra capa. Empaqueta skills con agentes, hooks y servidores MCP para instalarlos como una unidad, y sus skills se ejecutan como /plugin-name:skill-name.
¿Las skills funcionan igual en claude.ai, la API y Claude Code?
El formato SKILL.md es común, pero cada producto instala las skills a su manera. claude.ai recibe un zip para un solo usuario, la API de Claude recibe subidas para todo un workspace y Claude Code lee carpetas del disco. Una skill subida a claude.ai no está disponible en la API, ni al revés.
¿Qué hace allowed-tools en el frontmatter de una skill?
Enumera herramientas que una skill puede usar sin pedir permiso. La especificación lo define como una cadena de herramientas preaprobadas separadas por espacios y lo marca como experimental. En Claude Code la aprobación dura solo el turno que invoca la skill y no restringe nada: las herramientas no listadas siguen disponibles con tus permisos habituales.
¿Cómo se comprueba si una skill funciona de verdad?
Comprueba dos cosas por separado: si la skill se activa con las peticiones que debe y si su resultado es el que querías. Ejecuta unas cuantas peticiones realistas en una sesión nueva con la skill disponible, luego otra vez con ella desactivada, y compara. Que se active solo demuestra que se encontró, no que haya servido.