¿Qué son las Agent Skills?

Las Agent Skills son directorios de instrucciones, scripts y recursos que los agentes IA como Claude Code pueden descubrir y cargar dinámicamente para mejorar su rendimiento en tareas especializadas. Publicadas por Anthropic en diciembre de 2025 como estándar abierto en agentskills.io, el formato fue adoptado casi de inmediato por OpenAI para Codex y por GitHub Copilot.

La unidad mínima es un directorio con un archivo SKILL.md. Ese archivo contiene metadatos YAML y el cuerpo de instrucciones en Markdown que el agente recibe cuando activa la skill.

¿Para quién son útiles?

• Autores de skills: construyes una capacidad una vez y la despliegas en múltiples agentes y proyectos.
• Equipos y empresas: capturas conocimiento organizacional en paquetes versionados y portables.
• Marketers técnicos y fundadores: dan a su agente IA frameworks y mejores prácticas de marketing sin tener que repetir el contexto en cada conversación.

Cómo funcionan las Skills

El sistema opera mediante carga progresiva en tres niveles. El agente no carga todo de golpe: primero procesa los metadatos de todas las skills disponibles, luego —si la tarea coincide— lee el cuerpo de instrucciones del SKILL.md relevante, y solo entonces accede a los archivos de referencia adicionales que esas instrucciones mencionen.

Invocación: implícita vs. explícita

Las skills pueden activarse de dos formas:

• Implícita: el agente detecta que la tarea coincide con la description de la skill y la carga automáticamente.
• Explícita: el usuario escribe el slash-command directamente: /seo-audit, /page-cro, /copywriting.

Arquitectura del sistema marketing skills

El repositorio coreyhaines31/marketingskills tiene una skill pivot que actúa como base de contexto compartido: product-marketing-context. Todas las demás skills la leen primero para entender el producto, la audiencia y el posicionamiento antes de ejecutar cualquier tarea.

          ┌─────────────────────────────────────────┐
          │        product-marketing-context        │
          │   (leído por todas las skills primero)  │
          └──────────────────┬──────────────────────┘
                             │
   ┌──────────┬──────────────┼──────────────┬──────────┐
   ▼          ▼              ▼              ▼          ▼
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ SEO &    │ │   CRO    │ │Copy &    │ │ Paid &   │ │Growth &  │
│Discovery │ │          │ │Content   │ │Measure   │ │Retention │
├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤
│seo-audit │ │page-cro  │ │copywrite │ │paid-ads  │ │referral  │
│ai-seo    │ │signup-cro│ │copy-edit │ │ad-creativ│ │churn-    │
│programm. │ │onboard   │ │cold-email│ │ab-test   │ │ prevent  │
│schema    │ │form-cro  │ │email-seq │ │analytics │ │community │
│content   │ │popup-cro │ │social    │ │          │ │lead-mag. │
│aso-audit │ │paywall   │ │          │ │          │ │free-tool │
└──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘

  Skills se referencian entre sí:
  copywriting ↔ page-cro ↔ ab-test-setup
  revops ↔ sales-enablement ↔ cold-email
  seo-audit ↔ schema-markup ↔ ai-seo

Este diseño en grafo de dependencias garantiza que el agente siempre tenga el contexto de negocio antes de producir cualquier output de marketing, evitando copy genérico desconectado del producto real.

El repositorio Marketing Skills

Creado por Corey Haines (fundador de Conversion Factory y Swipe Files), coreyhaines31/marketingskills es la colección más completa de skills de marketing para agentes IA. Con 24.4k estrellas en GitHub y 3.9k forks, es el estándar de facto para extender Claude Code con capacidades de marketing.

Estructura de archivos del repositorio

# Estructura raíz del repositorio
marketingskills/
├── skills/                    # Una carpeta por skill
│   ├── seo-audit/
│   │   └── SKILL.md
│   ├── page-cro/
│   │   └── SKILL.md
│   └── ... (37+ directorios)
├── tools/                     # Herramientas auxiliares
├── .claude-plugin/            # Config Claude Code plugin
├── CLAUDE.md                  # Instrucciones para Claude
├── AGENTS.md                  # Config multi-agente
├── CONTRIBUTING.md
├── validate-skills.sh
└── validate-skills-official.sh
SHELL

Catálogo completo de skills

Métodos de instalación

# Instalar todas las skills
npx skills add coreyhaines31/marketingskills

# Instalar skills específicas
npx skills add coreyhaines31/marketingskills --skill page-cro copywriting seo-audit

# Listar skills disponibles
npx skills add coreyhaines31/marketingskills --list

# Instala en .agents/skills/ con symlink en .claude/skills/BASH

# Desde el terminal de Claude Code
/plugin marketplace add coreyhaines31/marketingskills
/plugin install marketing-skillsBASH

# Clonar y copiar la carpeta skills
git clone https://github.com/coreyhaines31/marketingskills.git
cp -r marketingskills/skills/* .agents/skills/

# Para uso personal (disponible en todos tus proyectos)
cp -r marketingskills/skills/* ~/.claude/skills/BASH

# Añadir como submodule (facilita actualizaciones con git pull)
git submodule add \
  https://github.com/coreyhaines31/marketingskills.git \
  .agents/marketingskills

# Referenciar skills desde:
# .agents/marketingskills/skills/BASH

# Instala en Claude Code, Cursor, Copilot y más simultáneamente
npx skillkit install coreyhaines31/marketingskills

# Solo skills concretas
npx skillkit install coreyhaines31/marketingskills \
  --skill page-cro copywriting email-sequenceBASH

Migración desde v1.0

A partir de v1.1, las skills usan .agents/ en lugar de .claude/ para el archivo de contexto de marketing. El fallback a .claude/ sigue funcionando, pero la migración recomendada es:

mkdir -p .agents
mv .claude/product-marketing-context.md .agents/product-marketing-context.mdBASH

Uso y activación de skills

Activación implícita (automática)

Escribe tu tarea en lenguaje natural. Claude Code detectará qué skill es relevante y la cargará automáticamente:

# Claude activa page-cro automáticamente
"Optimiza esta landing page para mejorar las conversiones"

# Claude activa copywriting automáticamente
"Escribe el copy del homepage para mi SaaS de gestión de proyectos"

# Claude activa analytics-tracking automáticamente
"Configura el tracking de GA4 para eventos de signup"

# Claude activa email-sequence automáticamente
"Crea una secuencia de bienvenida de 5 emails"NATURAL LANGUAGE

Activación explícita (slash commands)

Invoca cualquier skill directamente con su nombre como slash command:

/page-cro          # CRO de página de marketing
/seo-audit         # Auditoría SEO completa
/copywriting       # Escritura de copy
/email-sequence    # Secuencias de email
/cold-email        # Cold outreach B2B
/ab-test-setup     # Diseño de tests A/B
/schema-markup     # Datos estructurados
/ai-seo            # SEO para IA generativaCLAUDE CODE

Crear tu propia skill personalizada

Estructura mínima requerida

Una skill válida es un directorio con al menos un archivo SKILL.md. Opcionalmente puede incluir scripts ejecutables, documentación de referencia y assets.

mi-skill/
├── SKILL.md          # Requerido: metadatos + instrucciones
├── scripts/          # Opcional: Python, Bash, JS ejecutables
│   └── process.py
├── references/       # Opcional: docs que Claude carga on-demand
│   └── REFERENCE.md
└── assets/           # Opcional: plantillas, recursos
    └── template.htmlTREE

Anatomía del archivo SKILL.md

--- YAML frontmatter (requerido) ---
---
name: mi-skill              # Lowercase, hyphens, max 64 chars
                               # Se convierte en /mi-skill slash command
description: Optimiza fichas  # Max 1024 chars. CRÍTICO: define cuándo
  de Google Business Profile.  # se activa. Incluye trigger words claros.
  Usar cuando el usuario quiera # Front-load el caso de uso principal.
  mejorar su presencia local.
---

--- Cuerpo Markdown (instrucciones) ---
# Optimizador de Google Business Profile

Cuando se activa esta skill, sigue este proceso:

## 1. Diagnóstico inicial
- Solicita URL del perfil o nombre del negocio
- Revisa categorías principales y secundarias
- Evalúa completitud (fotos, horarios, servicios)

## 2. Optimización del copy
- Descripción: 750 chars, keyword en primeras 250
- Posts: mínimo 2 semanales, incluir CTA

## 3. Recursos adicionales
Ver guía detallada en [references/GBP-GUIDE.md](references/GBP-GUIDE.md)MARKDOWN

Reglas del frontmatter (spec oficial)

• name: solo minúsculas, números y guiones. No puede empezar ni terminar con guión. Sin guiones consecutivos. Máximo 64 caracteres.
• description: máximo 1.024 caracteres. Describe qué hace y cuándo activarla. Es el campo más crítico: si la descripción es vaga, la activación implícita falla.
• El archivo debe llamarse exactamente SKILL.md (mayúsculas, case-sensitive).
• Evitar caracteres < y > en el frontmatter (pueden inyectar instrucciones no deseadas en el system prompt).

Buenas prácticas de diseño

1. 1Mantén el SKILL.md principal bajo 500 líneas. Mueve el contenido de referencia extenso a references/.
2. 2Usa rutas relativas desde la raíz de la skill para referenciar otros archivos: references/GUIDE.md, no rutas absolutas.
3. 3Los scripts en scripts/ nunca cargan su código en el contexto: solo el output. Úsalos para validaciones, transformaciones y extracción de datos.
4. 4Define explícitamente las dependencias de tu skill en la sección Related Skills del cuerpo para que el agente pueda encadenar skills correctamente.
5. 5Valida tu skill con el script oficial antes de compartirla: bash validate-skills-official.sh skills/mi-skill.

Instalación de tu skill personalizada

# Skill personal (disponible en todos tus proyectos)
~/.claude/skills/mi-skill/SKILL.md

# Skill de proyecto (compartida con el equipo via git)
.claude/skills/mi-skill/SKILL.md

# Estándar Agent Skills (compatible con todos los agentes)
.agents/skills/mi-skill/SKILL.mdPATHS

Compatibilidad multi-agente

El estándar Agent Skills (agentskills.io) fue publicado por Anthropic en diciembre de 2025 y adoptado por OpenAI pocas semanas después. Una skill escrita una vez funciona en todos los agentes compatibles.

Seguridad y buenas prácticas

Las skills son archivos Markdown, pero tienen acceso a herramientas del agente y pueden ejecutar scripts. Tratar la instalación de una skill como la instalación de software: solo fuentes de confianza.

Riesgos a considerar

• Inyección de instrucciones: skills maliciosas pueden inyectar prompts en el system prompt del agente.
• Exfiltración de datos: skills con acceso a datos sensibles podrían diseñarse para filtrar información a sistemas externos.
• Llamadas de red no esperadas: skills que fetchean URLs externas en runtime pueden traer contenido malicioso.
• Abuso de herramientas: operaciones de archivo, bash o escritura pueden usarse de forma no intencionada.

Checklist antes de instalar skills de terceros

1. ✓Revisar el SKILL.md completo y todos los archivos del directorio antes de instalar.
2. ✓Verificar que los scripts no hacen llamadas de red no documentadas.
3. ✓Comprobar el historial de commits del repositorio para detectar cambios recientes sospechosos.
4. ✓Para entornos de producción con datos sensibles, usar skills solo de repositorios auditados y con releases firmadas.