Saltar al contenido
AInstein Academy · Guía rápida

Tu primera skill
de verdad

Mucho de lo que verás llamado «skill» en internet no es una skill: es un Project. Una skill real es una carpeta con un archivo, y una vez que haces la primera puedes hacer las que quieras.

1 carpeta1 archivo15 minutos

Alguien te pasó un enlace y te dijo que era una skill. Lo abriste: era un Project con instrucciones largas. Funciona, sí, pero solo cuando tú entras ahí. Cada vez que quieres eso mismo tienes que acordarte de entrar.

Una skill es otra cosa. Es una carpeta con un archivo llamado SKILL.md. Claude la carga solo, cuando tu petición se parece a lo que ahí dice. Ya usaste varias sin saberlo: el PowerPoint y el Excel que te arma vienen de skills de fábrica.

El error está casi siempre en la descripción. Se escribe como si fuera un título, «outfits», y la skill no se dispara nunca. Tiene que decir dos cosas: qué hace y cuándo usarla. Aquí la armas completa, con el ejemplo más claro que existe: qué ponerte mañana. Carpeta, archivo, ZIP y prueba.

Qué es una skill (y qué no)

Un Project es un espacio donde tú trabajas: entras, tiene su contexto, chateas ahí. Una skill no es un lugar. Es una capacidad que Claude carga por su cuenta, cuando detecta que la necesitas, sin que tú entres a ningún lado.

Por dentro son tres niveles. Claude siempre tiene cargados el nombre y la descripción de tus skills, que cuestan casi nada. Con eso decide si tu petición se parece a lo que esa skill hace, y solo entonces lee las instrucciones completas. Por eso puedes tener muchas sin que te pesen.

Prende el interruptor (sin esto no funciona nada)

Las skills necesitan que esté activada la ejecución de código, y viene apagada. Si eres de un equipo, esto lo prende el administrador desde los ajustes de la organización.

Configuración → Capabilities → «Code execution and file creation»

El archivo

Una skill es una carpeta con un archivo llamado SKILL.md, en mayúsculas. El archivo empieza con dos líneas de datos entre guiones y sigue con las instrucciones en texto normal.

La descripción es la parte que más se equivoca: no es un título, es el disparador. Tiene que decir qué hace y cuándo usarla. Claude compara tu petición contra ese texto para decidir si la carga. Si la resuelves en dos palabras, la skill se queda dormida.

Prompt

--- name: elige-mi-outfit description: Elige qué ropa ponerse según el clima, la agenda del día y las prendas disponibles. Úsala cuando el usuario pregunte qué ponerse, qué llevar a una junta o cómo vestirse para un evento o un viaje. --- # Elegir outfit del día ## Qué hacer 1. Revisa el clima de hoy en la ciudad del usuario con búsqueda web: temperatura mínima, máxima y probabilidad de lluvia. 2. Revisa su calendario de hoy. Fíjate en el compromiso de código de vestimenta más exigente del día. 3. Propón UN outfit, no tres. Con nombre de prendas concretas del inventario de abajo. 4. Agrega una línea de "por si acaso" solo si el clima lo justifica. ## Cómo responder Corto. Prendas, y una frase de por qué. Sin párrafos de introducción. Si hay un compromiso formal y otro casual el mismo día, resuelve para el formal y di qué cambiar después. Si no tienes acceso al calendario, pregunta qué tiene hoy antes de proponer. ## Mi inventario [Lista tus prendas por categoría. Sé concreto: "saco azul marino", no "sacos".] Superiores: ... Inferiores: ... Zapatos: ... Abrigos: ... ## Reglas mías [Lo que nunca te pones, lo que no combinas, lo que sí o sí para clientes.]

Ojo con el nombre
Solo minúsculas, números y guiones. Y no puede contener las palabras «claude» ni «anthropic», así que claude-outfit no te va a funcionar.

Súbela

  1. 01Crea una carpeta con el nombre de tu skill, elige-mi-outfit, y mete el SKILL.md adentro.
  2. 02Comprime la carpeta en ZIP. La carpeta tiene que ser la raíz del ZIP, no estar anidada dentro de otra.
  3. 03En Claude, entra a Personalizar → Skills y súbela con el botón de agregar.
  4. 04Pruébala escribiendo «¿qué me pongo mañana?». Si no se activa sola, tu descripción no está diciendo cuándo usarla. Vuelve y arréglala.

El clima y el calendario

Esta skill se apoya en dos datos que no viven dentro de Claude. Cada uno llega por su lado.

dato 01
Calendario
Se conecta aparte, como conector: Personalizar (Customize) → Conectores → botón «+» → Google Calendar → Conectar.
dato 02
Clima
No tiene conector. Claude lo busca en la web, por eso la skill de arriba se lo pide explícitamente. Si ves una guía que dice que «Claude checa el clima» como si fuera nativo, no lo es.

Dónde se rompe

No se sincronizan. La que subes a Claude en la web no existe en Claude Code ni en la API. Son mundos separados y cada uno se instala por su cuenta. En Claude Code no se sube ningún ZIP. Ahí las skills son carpetas en ~/.claude/skills/ y Claude las descubre solo; si esperabas un botón para subirla, no hay botón.

Seguridad
No instales skills de desconocidos. Una skill puede indicarle a Claude que ejecute código; usa solo las tuyas o las oficiales.

Qué sigue

Si vas a construir varias, primero deja lo básico configurado. La siguiente skill hazla de lo que sí te cuesta dinero. Y si quieres que alguien te vea armarla, eso pasa en Foundations.

Estructura y rutas verificadas en agosto de 2026 contra la documentación oficial de Anthropic.

AInstein Academyainste.in/freebies