🟡 Skills: La Guía Definitiva para Automatizar tu Forma de Trabajar con IA

Te enseño a convertir tu conocimiento en Agentes IA y empaquetarlos para que cualquier IA pueda cargarlos automáticamente.

“Estás a solo unos pocos archivos de texto .md de superar al 99% de la gente en este planeta”

En este post te cuento cómo:

Anthropic lanzó algo en octubre de 2025 que pasó desapercibido para la mayoría.

Lo llamaron “Agent Skills” (habilidades de los agentes).

Parecía una feature menor. Carpetas con archivos Markdown. Nada del otro mundo.

Dos meses después, Google, Microsoft, OpenAI, Cursor, Figma, Notion… todo el mundo lo había adoptado.

En enero de 2026, las Skills de Claude funcionan en Gemini CLI, VS Code, GitHub Copilot, ChatGPT y en toda herramientas de “vibe coding” con un mínimo prestigio.

¿Cómo una carpeta con archivos de texto se convirtió en el estándar para IA agéntica?

Porque resuelve un problema que todos teníamos:

Cada vez que abres una conversación con IA, empiezas de cero. Le explicas quién eres, qué haces, cómo quieres las cosas. Le das contexto, cuál es el formato de salida, etc.

La IA produce algo brillante. Y mañana... amnesia total. Vuelta a empezar.

Las Skills eliminan esa repetición. Empaquetas tu expertise una vez, y cualquier IA lo aplica para siempre.

Cosas en las que te pueden ayudar las skills:

• Empaqueta estrategias de ventas probadas para que la IA las aplique en campañas

• Permitir que la IA responda a clientes o analice métricas usando exactamente tu mismo criterio y lógica de negocio.

• Crea textos y marketing adaptados para audiencias específicas.

• Comparte skills con tu staff o socios para que todos usen tu expertise.

• Optimización de procesos automatizando flujos creativos, liberando tiempo para innovación.

Y estos son solo unos pocos ejemplos. Las posibilidades son infinitas…

Esta guía te enseña exactamente cómo sacar el máximo partido de esta nueva funcionalidad.

---

Hola soy Alex dc. y todas las semanas te cuento cómo aprovechar la IA para mejorar tu negocio, de forma práctica. Sin ruido. Solo consejos prácticos que generan resultados.

Antes que nada un saludo 👋 a los 612 nuevos miembros 👨‍🚀 desde la última publicación de La Mafia IA. Ya somos +12.000 y la newsletter #tech que más crece en español (según Substack) - Puedes suscribirte gratis aquí 👈

---

SKILLS, el protocolo IA que se propaga como un incendio descontrolado 🔥🔥🔥

El 18 de diciembre de 2025, Anthropic liberó Agent Skills como un estándar abierto con especificación pública y SDK de referencia.

Esto es lo qué pasó en los siguiente días:

Google adoptó el estándar en su plataforma “Antigravity” (la herramienta de vibe coding de Google lanzada en noviembre 2025). Permite usar Skills de Claude Code directamente sin modificaciones. También las integró en Gemini CLI, adoptando el mismo formato para workflows reutilizables.

Microsoft integró Skills nativamente en VS Code y GitHub, permitiendo usarlas en flujos de desarrollo sin fricción.

OpenAI Competidor directo de Anthropic, adoptó una arquitectura idéntica en ChatGPT y Codex CLI. Replicaron la estructura de archivos y metadatos exacta.

Cursor, Goose, Amp, OpenCode y Codex las implementaron para entornos de vibe coding.

Atlassian y Figma anunciaron soporte para Skills en sus plataformas de colaboración y diseño.

En menos de un mes, los Skills han pasado de ser “una feature de Claude” a convertirse en el estándar universal para enseñar procedimientos a agentes IA o crear Asistentes IA más potentes.

¿Por qué esta adopción masiva? Porque la arquitectura es brutalmente simple: una carpeta con un archivo de texto (Markdown). No hay servidores que mantener, APIs que conectar ni dependencias que gestionar.

Creas una vez. Funciona en todas partes.

¿Qué Son Exactamente los Skills?

Un Skill es una carpeta con instrucciones, scripts y recursos que la IA carga automáticamente cuando son relevantes para tu tarea.

Piensa en ellos como el libro de recetas para un chef o el manual de onboarding para un empleado digital.

En lugar de explicarle a la IA cada vez cómo quieres tus informes, le das un manual una vez. La IA lo guarda. Y cada vez que pides un informe, aplica ese manual sin que repitas nada.

Lo brutal del concepto:

→ Solo se carga cuando se necesita (eficiencia de tokens)
→ Puedes tener docenas de Skills listos sin sobrecargar el contexto
→ Funcionan en Claude, ChatGPT, Gemini, Antigravity, VS Code, Cursor...
→ Son portables: los compartes con tu equipo u otros usuarios como carpetas normales

Un Skill básico es literalmente esto:

mi-skill/
├── SKILL.md   ← El único archivo obligatorio
└── (opcional: scripts, referencias, código, plantillas...)

El archivo SKILL.md contiene metadatos en YAML (nombre y descripción) más instrucciones en Markdown.

La IA lee los metadatos al inicio de cada sesión. Cuando detecta que tu petición encaja con la descripción de un Skill, lo carga completo y aplica las instrucciones.

---

Skills vs Projects vs Custom Instructions

Antes de profundizar, aclaremos la confusión común. Ya uses ChatGPT, Gemini, Grok o Claude, ahora tienes 3 formas de personalizar la experiencia:

🎚️ Instrucciones Personalizadas → El termostato de tu casa

Ajustes globales que aplican a TODO. Ejemplo “Sé conciso”. “Pregunta antes de asumir”. “Usa español informal”. Una vez configurados, la IA los respeta en todas las conversaciones → aquí tienes una guía para optimizar estas instrucciones

📁 Proyectos (o gems) → Tu escritorio de trabajo

Un espacio donde acumulas documentos, contexto e historial para un trabajo específico. Lanzamiento de producto, investigación de mercado, escribir un libro. El contexto vive (y muere) dentro del proyecto. Ideal para trabajo continuado donde necesitas que la IA “recuerde” todo lo anterior.

⚡ Skills → Tus recetas probadas

Procedimientos específicos que se activan solos cuando son relevantes. Generar informes con tu formato, revisar código con tus estándares, crear landing pages con tu metodología. No los invocas explícitamente, la propia IA detecta cuándo aplicarlos. Se pueden aplicar dentro de un proyecto cuando sea necesario.

La diferencia clave:

• Instrucciones Personalizadas = comportamiento GENERAL de tu IA.

• Proyectos = QUÉ información aplico sobre un trabajo específico

• Skills = CÓMO ejecutar tareas específicas

Y lo mejor: se combinan.

Puedes pedir un informe trimestral. Ir a la carpeta donde tienes todos tus documentos (proyecto), cargar tu skill gestión de finanzas (para dar instrucciones) + tu skill para manejar datos financieros (para hacer cálculos) + tu skill de marca (para generar el reporte) ... todo automáticamente.

---

Anatomía de un SKILL.md

Todo Skill empieza con un único archivo obligatorio: SKILL.md

---
name: nombre-del-skill
description: >
  Descripción clara de qué hace este skill y CUÁNDO debe activarse.
  Sé específico. Esta descripción es el "trigger" que la IA usa para 
  decidir si cargar el skill o no.
---

# Título del Skill

## Overview
Qué hace este skill y por qué existe.

## Instrucciones
Pasos detallados que la IA debe seguir.

## Ejemplos
Casos reales mostrando inputs y outputs esperados.

Los metadatos (YAML frontmatter)

Lo que va entre “---” es crítico:

name: Identificador del skill. Minúsculas con guiones, máximo 64 caracteres.

• ❌ Mal: Mi Super Skill Para Informes!!!

• ✅ Bien: informe-trimestral, revision-codigo, landing-page-creator

description: Aquí la IA decide si activar el skill. Sé específico sobre QUÉ hace y CUÁNDO usarlo.

• ❌ Mal: “Ayuda con documentos” → Demasiado vago

• ✅ Bien: “Crea informes trimestrales siguiendo el formato de Acme Corp. Usar cuando el usuario mencione QBR o informe trimestral.”

Carga Progresiva de tokens

Una de las cosas más geniales de los skills es que están hechos para que la información se cargue en capas según sea necesario:

• Nivel 1: Nombre y descripción (siempre cargados, ~100 tokens)

• Nivel 2: Contenido completo del SKILL.md (cuando el skill se activa)

• Nivel 3: Archivos adicionales (solo si son necesarios)

Resultado: puedes empaquetar documentación extensa sin saturar el contexto.

💡 Truco pro: Mantén el SKILL.md por debajo de 5,000 palabras. Si necesitas más, divídelo en archivos adicionales. (intenta que este archivo no sea más largo de lo necesario)

---

¿Cómo crear tus propios Skills?

Método 1: Crear un Skill por Conversación (en Claude)

La forma más rápida si estás empezando es usar Claude.

Claude ya tiene un skill en sus sistema que se llama precisamente skill-creator. Al que solo tienes que pedirle que nuevo skill quieres crear.

Si utilizas otras IA como ChatGPT, puedes usar una suscripción gratuita a Claude para hacer el skill y luego te lo llevas a tu IA favorita.

👣 Pasos:

Paso 1: Abre un nuevo chat con Claude, ejemplo:

“Quiero crear un skill que me ayude con mi contabilidad a la hora de recopilar datos de suscripciones vendidas en Substack, que recopile mis ventas desde Stripe (vía MCP) y me cree un reporte con los datos que necesito para presentar mis impuestos trimestrales”

Paso 2: Claude carga su skill interno skill-creator y te hace preguntas:

• ¿Qué pasos específicos debe seguir?

• ¿Qué formato de entrada/salida prefieres?

• ¿Hay algo más que deba capturar?

Paso 3: Sube material de referencia: plantillas, ejemplos, guías de estilo.

Paso 4: Claude empaqueta todo en un archivo .skill listo para usar:

gestor-autonomos/
├── SKILL.md
├── scripts/
│   ├── calcular_iva.py
│   ├── calcular_irpf.py
│   ├── procesar_facturas.py
│   ├── procesar_stripe.py
│   └── generar_libro.py
└── references/
    └── normativa_fiscal.md

Paso 5: Haz clic en “Copiar a tus skills”.

🔥 Ahora tú: Pruébalo inmediatamente. Pide una tarea que el skill debería manejar y observa el “pensamiento” de Claude—verás “Leyendo [nombre del skill]” cuando lo carga.

👀 Ejemplo real completo: Este es el Skill que yo mismo utilizo para que me haga la contabilidad trimestral de las suscripciones en substack (Mafia IA). Si tú también tienes suscripciones de pago en tu substack puedes descargarlo y aprovecharlo con tu newsletter ⮕ Mafia Claude Skills (repo)

---

Método 2: Crear un Skill Manualmente

Si prefieres control total o quieres versionarlo en Git:

Para cualquier IA

1. Crea esta estructura:

mi-skill/
├── SKILL.md (obligatorio)
├── references/ (opcional)
└── templates/scripts (opcional)

2. Comprime en .zip

3. Configuración → Capacidades → Skills → Añadir

Para Claude Code

mkdir -p ~/.claude/skills/mi-skill
# Crea tu SKILL.md ahí dentro

Ejemplo Completo: Skill de Resumen de Reuniones

---
name: reuniones-summary
description: >
  Transforma notas de reuniones en resúmenes estructurados
  con decisiones clave y puntos de acción. 
  Usar cuando: resumir reunión, procesar transcripción, 
  extraer action items.
---

# Resumen de la reunión

## Estructura del Output

1. **Decisiones Clave** - Qué se acordó
2. **Puntos de Acción** - Tareas con responsable y fecha
3. **Temas Discutidos** - Resumen de lo importante
4. **Seguimientos Pendientes** - Preguntas abiertas

## Formato de Action Items

- [ ] Tarea - @responsable - Fecha: dd/mm/yyyy

## Directrices

- Extrae decisiones aunque no se digan explícitamente
- Asigna responsables a cada action item
- Mantén los resúmenes escaneables

---

MCP vs Skills: La Gran Confusión (Resuelta)

Esta es quizá la pregunta más obvia. ¿Qué diferencias hay con un MCP?.

La Analogía del Chef 🧑‍🍳

Un Skill es → tu libro de cocina.

Contiene la receta exacta: ingredientes, cantidades, tiempos, temperatura, trucos del chef, cómo debes presentar el plato final. El resultado es consistente porque el procedimiento está documentado.

MCP es → la cocina equipada.

Te da acceso a la nevera (datos), los fogones (herramientas), la despensa (APIs), el supermercado (servicios externos). Sin cocina, no puedes cocinar nada. Pero tener una cocina no significa que sepas hacer paella.

La magia ocurre cuando los combinas:

MCP se conecta con tu base de datos (Supabase, Salesforce, lo que sea) → El Skill define qué datos priorizar, cómo cruzarlos o cómo redactar un informe con ellos.

La Diferencia Técnica

Cuándo Usar Cada Uno

Usa MCP cuando necesitas:
→ Datos en tiempo real de sistemas externos
→ Acceder a bases de datos, CRMs, APIs
→ Publicar en Slack, crear tareas en Notion, consultar GitHub, usar herramientas.

Usa Skills cuando necesitas:
→ Tareas repetibles con un proceso específico
→ Aplicar tu formato, estilo o metodología
→ Conocimiento procedural (cómo hacer algo a TU manera)

Usa ambos cuando:
→ Necesitas acceso a datos externos (MCP) Y un proceso específico para usarlos (Skill)

---

Te comparto mis Skills 🎁 Mafia Claude Skills

He creado un repositorio público con los skills que uso a diario para que la comunidad pueda aprovecharlos también:

🔗 github.com/alexdcd/Mafia-Claude-Skills - Mafia SKILLS 🎩

Gratis y listos para instalar!

Ejemplo 1: 💼 Gestor Autónomos España (link)

Mi skill más complejo. Maneja contabilidad y fiscalidad de autónomos con cálculos matemáticamente precisos.

Qué hace:

• Calcula Modelo 303 (IVA trimestral) y Modelo 130 (IRPF)

• Procesa pagos de Stripe y Substack (separando UE con IVA vs internacional exento)

• Genera el libro de ingresos y gastos

• Convierte monedas automáticamente (utilizando la tasa de cambio adecuada)

• Me da un reporte en un formato final entendible para enviar a mi gestor.

Ejemplo:

Yo: "Necesito un reporte para mi gestora de las ventas trimestrales de suscripciones a mi substack. Entra en mi Stripe y recopila todo los datos del 1 de octubre hasta el 31 diciembre"

Claude: [Cargando Gestor Autónomos...]

(...)
======================================================================
IMPORTES PARA TUS DECLARACIONES TRIMESTRALES
======================================================================

   ----------------------------------------------------------------
   |  MODELO 303 - IVA TRIMESTRAL                                 |
   ----------------------------------------------------------------
   |  Casilla 01 (Base imponible 21%):              2,013.22 EUR  |
   |  Casilla 03 (Cuota devengada 21%):               422.78 EUR  |
   |  Casilla 60 (Exportaciones y op. exentas):       406.20 EUR  |
   ----------------------------------------------------------------

   ----------------------------------------------------------------
   |  MODELO 130 - PAGO FRACCIONADO IRPF                          |
   ----------------------------------------------------------------
   |  Ingresos computables (Suma Bases):            2,419.42 EUR  |
   |  (2,013.22 UE + 406.20 No-UE)                                |
   |                                                              |
   |  Gastos deducibles (Comisiones):                 343.41 EUR  |
   |  --------------------------------------------------------    |
   |  Rendimiento Neto (Beneficio):                 2,076.01 EUR  |
   ----------------------------------------------------------------

RECORDATORIOS FINALES
----------------------------------------------------------------------
   • Plazo presentación 4T: 1-30 enero 2026.
   • Al separar las ventas No-UE, ahorras pagar IVA de esos 311€.
======================================================================

---

Ejemplo 2: 🎨 Landing Page Mastery (link)

Sistema experto para crear y optimizar landing pages de alta conversión.

Una skill diseñada para marketers y fundadores que necesitan crear páginas de venta efectivas o mejorar las existentes basándose en datos y psicología del usuario.

Cómo lo hice: Llevo meses documentando cómo crear webs que venden o Landing Pages con IA (para la comunidad privada de La Mafia que viene en camino 👀) 🤫

El plan original: un tutorial paso a paso. Completo. Detallado. De esos que te llevan 30 minutos y probablemente veas en 1.5x de velocidad.

Pero el mundo avanza más rápido que mis planes. En realidad más rápido que los de todos nosotros. Y con los Skills todo se simplifica.

Lo que iba a ser un video explicativo de media hora, ahora es un SKILL que instalas en 2 clicks.

Así que hice exactamente esto. Lo he empaquetado todo en un skill listo para usar. Lo guardas. Lo activas cuando necesites crear una web para tu negocio. Y punto.

Sin tutoriales maratonianos. Sin tener que aguantar la turra de nadie (incluida la mía). Solo tú, el skill y una landing que funciona.

El tutorial detallado llegará para quien lo quiera. Pero esto ya lo puedes usar hoy.

Qué hace:

→ La arquitectura correcta (hero + social proof + oferta + urgencia + CTA)
→ Mi checklist de 40 elementos (desde copywriting hasta psicología)
→ Plantillas probadas de páginas que funcionan
→ Audita los errores más costosos que debes evitar

¿El resultado?

Utilicé este SKILL, junto a Claude Code (+plugin de diseño-frontend.

Este es el resultado en poco más de 5 minutos:

🎁 Aquí tienes el SKILL con el que he creado la web del vídeo.

¿Cómo Instalo este Skill? (o cualquier otro que encuentre en github)

Hay dos caminos:

Si eres técnico: Ve al repositorio de Mafia Claude Skills y sigue las instrucciones. Está todo ahí: descargar, extraer, importar.

Si la terminal te asusta: Abre Claude, pega el link del skill y dile “Ayúdame a instalar esto en mis skills”. La propia IA hace todo. Literalmente tan simple como eso.

La magia de vivir en 2026 es que las herramientas se han vuelto tan accesibles que la fricción ya no es excusa.

---

⚠️ 5 Errores más frecuentes (y Cómo Evitarlos)

Después de probar decenas de skills propios y ajenos, estos son los errores que veo repetirse una y otra vez.

Guárdatelos. Te ahorrarán frustraciones innecesarias.

❌ Error #1: Descripción demasiado vaga

Si tu descripción dice algo genérico como “ayuda con datos” o “procesa archivos”, Claude no sabrá cuándo activarlo.

✅ Solución: Sé específico sobre QUÉ hace y CUÁNDO usarlo.

# MAL
description: Ayuda con análisis de datos

# BIEN  
description: Limpia datos de scraping en JSON/CSV y genera informes Excel. 
Usar para deduplicación, limpieza de campos como URL/precio/título, 
o generación de estadísticas de productos.

📍 Regla: Si no puedes explicar en una frase cuándo se activa, tu descripción es demasiado vaga.

---

❌ Error #2: Descripciones similares entre skills

Si tienes dos skills con “análisis de datos” en la descripción, Claude se confundirá y elegirá el equivocado.

✅ Solución: Usa términos disparadores únicos para cada skill.

En lugar de dos skills con “análisis de datos”, diferéncialos:

• Uno para “datos de ventas en Excel y exportaciones de CRM”

• Otro para “logs de servidor y archivos de errores”

---

❌ Error #3: YAML mal formateado

El skill simplemente no carga. Sin errores visibles. Solo silencio.

✅ Solución: Verifica estas 3 cosas:

1. --- debe estar en la línea 1 (sin líneas en blanco antes)

2. Usa espacios para indentar, nunca tabs

3. Cierra con --- antes del contenido Markdown

---
name: mi-skill
description: Hace X cuando necesitas Y
---

💡 Truco: Si no funciona, copia el YAML a un validador online antes de perder tiempo buscando el error.

---

❌ Error #4: Rutas con backslash (Windows)

Escribes scripts\helper.py y funciona en tu Windows. Lo compartes con alguien en Mac/Linux → falla.

✅ Solución: Usa SIEMPRE barras normales “/”, incluso en Windows.

# MAL (solo funciona en Windows) → Ejecuta scripts\validar.py

# BIEN (funciona en todos los sistemas)→ Ejecuta scripts/validar.py

---

❌ Error #5: SKILL.md demasiado largo

Metes toda tu documentación, ejemplos, casos edge, referencias... y el skill empieza a fallar o ignorar instrucciones.

✅ Solución: Máximo ~500 líneas en SKILL.md.

Si necesitas más:

• Pon lo esencial en SKILL.md

• Crea archivos separados (REFERENCE.md, EXAMPLES.md)

• Claude los carga solo cuando los necesita

mi-skill/
├── SKILL.md          # Instrucciones principales (<500 líneas)
├── REFERENCE.md      # Documentación detallada
├── EXAMPLES.md       # Casos de uso expandidos
└── scripts/
    └── validar.py

📍 Regla: Si tu SKILL.md necesita scroll infinito, divídelo.

---

🔧 Checklist rápido antes de publicar un skill:

• [ ] ¿La descripción explica QUÉ hace Y CUÁNDO usarlo?

• [ ] ¿Es única respecto a otros skills que tengo?

• [ ] ¿El YAML empieza en línea 1 sin espacios antes?

• [ ] ¿Todas las rutas usan / en lugar de \?

• [ ] ¿SKILL.md tiene menos de 500 líneas?

---

📚 Recursos

• 🎩 Mafia Claude Skills

Documentación oficial:

• Anthropic Skills Repository

• Agent Skills Documentation

• Skills + MCP (blog oficial)

---

❤️ Gracias por leer La Mafia IA.

Si te ha gustado esta edición, házmelo saber, no te olvides de darle al ♡

¿Conoces a alguien a quien le pueda ayudar esta información? → compártelo.

🗞️ Para noticias IA diarias:

La Mafia IA no te bombardea con noticias (que solo añaden ruido y caos).

Si te interesa estar más al día: En mis perfiles en redes te comento las noticias más importantes en tiempo real, me puedes encontrar en:

𝕏 x.com | ＠Thread | 💼 Linkedin | 📒 Notas de Substack

---

Este post fue escrito por un humano. Las herramientas IA me ayudaron a investigar y organizar. El criterio, los ejemplos y las opiniones son 100% míos.

Alex dc