¿Qué es un skill de Claude Code y cómo lo instalas?

Cuando instalas Claude Code y lo arrancas por primera vez, lo que tienes es un asistente general muy bueno. Puede leer tus archivos, escribir código, correr comandos, abrir issues en GitHub. Pero no sabe nada de tu negocio, ni de tu industria, ni de tu país, ni de los datos que viven en tu disco duro.

Un skill es lo que cambia eso. Un skill es un folder con instrucciones, datos y scripts que Claude Code carga automáticamente cuando detecta que el contexto de tu pregunta lo amerita. Después de instalarlo, Claude se convierte en especialista en algo concreto: precios reales de PROFECO, evaluación de copy publicitario para mercado mexicano, cumplimiento legal PyME, o lo que sea.

Esta guía explica qué es un skill, cómo funciona internamente, qué los hace distintos a un prompt o a un agente, y cómo instalas tu primero en tres pasos. Al final dejamos cinco skills del tianguis para que pruebes con uno real.

Skill no es prompt ni agente: la distinción importa

Estos tres términos se confunden mucho. La diferencia:

• Prompt: lo que tú escribes en cada pregunta. Es efímero. Se va con la sesión.
• Skill: un folder persistente que Claude Code carga al iniciar. Tiene instrucciones, ejemplos, datos y scripts. Se activa automáticamente cuando tu pregunta encaja con sus triggers, y siempre puedes invocarlo a mano.
• Sub-agente: una versión especializada de Claude que corre en paralelo para una tarea específica. Útil cuando el trabajo es grande y conviene aislarlo del hilo principal.

Un skill se parece más a una extensión de navegador que a un chatbot. No es algo que llamas; es algo que está instalado y se activa solo en el momento adecuado.

Anatomía de un skill: qué hay dentro de la carpeta

Un skill mínimo tiene un solo archivo: SKILL.md con frontmatter YAML. Un skill serio tiene más:

mi-skill/
├── SKILL.md           ← instrucciones principales + triggers
├── README.md          ← documentación para humanos
├── data/              ← datasets, snapshots, JSON
├── scripts/           ← helpers (Python, Bash, Node)
└── examples/          ← queries de ejemplo + outputs esperados

El frontmatter del SKILL.md es lo que Claude Code lee al inicio para decidir cuándo activarlo:

---
name: precios-mx
description: |
  Usar cuando el usuario quiera consultar PRECIOS REALES de productos
  en México por colonia, ciudad, cadena o periodo.
  Triggers: "cuánto cuesta X en Y", "precio de X en CDMX",
  "Walmart vs Soriana", "PROFECO", "QQP".
---

# precios-mx — Consulta de precios reales MX

[resto de las instrucciones]

Cuando tú escribes algo como "¿cuánto cuesta el aceite Capullo en Guadalajara?", Claude detecta los triggers del skill precios-mx, lo activa, y sigue las instrucciones de su SKILL.md (que dicen: consulta esta DB, devuelve mediana + top 3 cadenas + insight).

Cómo se activa un skill: el mecanismo de triggers

Esto es lo que confunde a la gente nueva. No tienes que decirle a Claude "usa el skill precios-mx". Si el skill está bien escrito, se activa solo cuando el contexto lo amerita.

El campo description del frontmatter funciona como un clasificador. Claude lee ese texto al iniciar la sesión y lo guarda como índice. Cuando llega tu pregunta, internamente la compara contra todos los skills instalados y activa los que matchean.

Por eso un buen skill tiene una sección de triggers explícita: "Triggers: 'cuánto cuesta X', 'precio de Y en Z', 'PROFECO'...". Mientras más concretos sean los triggers, menos falsos positivos hay.

Qué hace un skill que un prompt no puede hacer

Tres cosas que un prompt suelto no resuelve y un skill sí:

1. Persistencia entre sesiones. Un skill vive en disco. Lo instalas una vez y todas tus futuras sesiones de Claude Code lo tienen disponible sin que tengas que volver a explicar nada.
2. Acceso a datos locales. El skill incluye sus scripts y data. Cuando se activa, puede leer un DuckDB de 916 MB en tu disco, hacer una query, devolver el resultado. Un prompt no puede hacer eso porque no trae el dataset adentro.
3. Comportamiento estructurado. El SKILL.md define cómo responder: qué tabla mostrar, qué chequeos hacer, qué errores avisar, qué no hacer. Eso hace que el output sea predecible. Un prompt es interpretación libre.

Cinco ejemplos concretos del tianguis

Para que veas qué hace cada uno con su contexto local:

Lo importante: tú no le dices a Claude "usa precios-mx". Le preguntas en lenguaje natural y él decide.

Cómo instalas tu primer skill en 3 pasos

Asumimos que ya tienes Claude Code instalado. Si no, la guía oficial toma como cinco minutos.

Paso 1: Encuentra el skill en el tianguis

Abre eltianguis.sistemia.mx, filtra por tipo o categoría. Cada puesto tiene su página con SKILL.md renderizado, ejemplos, y botón de instalación. Para una primera vez, recomendamos nse-mx o habitos-digitales-mx — vienen con datos en el repo, no requieren bases externas.

Paso 2: Clona y copia

git clone https://github.com/lahh1986/sistemia-skills-mx.git
mkdir -p ~/.claude/skills
cp -r sistemia-skills-mx/skills/nse-mx ~/.claude/skills/nse-mx

La carpeta ~/.claude/skills/ es donde Claude Code busca skills al iniciar. Cualquier folder que pongas ahí se carga automáticamente.

Paso 3: Reinicia Claude Code y úsalo

Cierra y vuelve a abrir Claude Code en tu proyecto. Ahora cuando hables, los triggers del skill ya están registrados. Pruébalo:

Tú: "Clasifica este hogar — jefe con licenciatura, 2 baños,
1 auto, internet, esposa trabaja, dos hijos en escuela.
¿Qué NSE es?"

Claude (con nse-mx activo): NSE C+ (puntuación 152, percentil 73
nacional). Acceso a productos de marca media-alta. Distribución
similar en CDMX, Monterrey, Guadalajara. [...]

Errores comunes al instalar tu primer skill

• No reiniciar Claude Code. El registro de skills es al inicio. Si lo copiaste con Claude abierto, no lo va a ver.
• Carpeta mal anidada. ~/.claude/skills/nse-mx/SKILL.md está bien. ~/.claude/skills/sistemia-skills-mx/skills/nse-mx/SKILL.md no.
• Conflictos de trigger. Si tienes dos skills con triggers parecidos, Claude puede activar el equivocado. Solución: invocarlo a mano ("usa el skill X...").
• Skill que requiere datos externos. Algunos skills (como precios-mx) viven sobre DBs de cientos de MB que no caben en el repo. Vienen con versión preview y CTA para acceso completo.

Dónde seguir

Si esto es nuevo para ti, lo más sano es probar con un skill que tenga datos en el repo (NSE MX o Hábitos Digitales MX) antes de meterse con los que requieren bases externas. Te ahorra fricción y te da una primera victoria rápida.

Si quieres entender por qué hace diferencia que los skills sean en español y específicos para México y Latam (y no traducciones de skills gringos), te dejamos la siguiente lectura: Skills en español para MX/Latam: qué cambia.

Y si ya estás listo para construir el tuyo propio, en /publica hay tres vías para subirlo al tianguis.