Ir al contenido principal
Claude Skills

Guía práctica de Claude Skills

Asistido por IA

Cree Skills personalizados desde cero — compare las diferencias con MCP, Subagents, domine las mejores prácticas para habilitar, instalar y crear Skills

Repaso rápido

En el artículo anterior, conocimos los conceptos fundamentales de los Skills: son manuales de trabajo reutilizables para asistentes de IA que, mediante una arquitectura de divulgación progresiva, logran una eficiencia de tokens extremadamente alta, con tres características principales: eficientes, composables y portátiles. Este artículo parte desde una perspectiva práctica para ayudarle a comprender las diferencias entre Skills y otras funcionalidades, aprender a habilitar, instalar y crear Skills, y dominar las mejores prácticas mientras evita los errores comunes.

Comparación de funcionalidades

Comparación de funcionalidades de Claude
Diferencias entre Skills, Commands, Hooks y otras funcionalidades

El ecosistema de Claude cuenta con múltiples funcionalidades que pueden generar confusión al primer contacto. La siguiente tabla le ayudará a distinguirlas rápidamente:

FuncionalidadQué esMás adecuada paraPersistencia
SkillsPaquetes de conocimiento especializadoTareas repetitivas, flujos estandarizadosPersistente entre conversaciones
PromptsInstrucciones instantáneasSolicitudes puntualesSolo la conversación actual
ProjectsBase de conocimientosInformación de contexto, documentación del proyectoDentro del espacio de trabajo del proyecto
MCPConectorDatos externos, llamadas a APIConexión continua
SubagentsSubagentesDelegación de tareas, procesamiento paraleloEntre sesiones

Skills vs MCP

Esta es la confusión más común. La diferencia fundamental: MCP conecta a Claude con los datos, Skills le enseña a Claude cómo procesar los datos. Ambos son complementarios, no sustitutos.

DimensiónSkillsMCP
Función principalEnseña a Claude cómo ejecutar tareasConecta a Claude con sistemas externos
Consumo de tokensMuy bajo (decenas de tokens)Alto (miles a decenas de miles de tokens)
Complejidad técnicaSimple (Markdown + YAML)Compleja (especificación completa de protocolo)
Escenarios típicosRedacción de marca, generación de informes, flujos de trabajoConsultas a bases de datos, llamadas a API, servicios en la nube
PortabilidadEntre Claude.ai/Code/APIAdoptado por múltiples compañías de modelos

Comprendiendo esta diferencia, sabrá cuándo usar cada uno. Cuando necesite consultar bases de datos, llamar a API o acceder a servicios en la nube, use MCP; cuando necesite seguir un estilo de escritura específico, ejecutar flujos estandarizados o reutilizar conocimiento especializado, use Skills.

La mejor práctica es combinar ambos: use MCP para conectar su sistema CRM y obtener datos de clientes, y Skills para definir cómo analizar esos datos y generar informes.

Skills vs Subagents

La diferencia fundamental: Skills hacen que Claude sea más competente en cierto tipo de tareas; Subagents permiten que Claude delegue tareas a "empleados expertos" independientes.

DimensiónSkillsSubagents
Función principalProporcionar conocimiento especializado e instruccionesSubagentes que ejecutan tareas de forma independiente
ContextoSe inyecta en el contexto de la conversación principalPosee su propia ventana de contexto independiente
Escenarios de usoHacer que Claude sea más competente en cierto tipo de tareasTareas complejas de múltiples pasos e independientes
Modo de activaciónCoincidencia automática según la descripciónInvocación manual o delegación automática de Claude
PortabilidadEntre Claude.ai/Code/APISolo Claude Code y Agent SDK

De forma ilustrativa, los Skills son como material de capacitación — enseñan a Claude cómo hacer algo; los Subagents son como empleados especializados — tienen su propio escritorio (contexto) y permisos (herramientas), completan tareas de forma independiente y luego reportan los resultados.

Ambos pueden usarse en combinación: por ejemplo, un subagente de revisión de código puede cargar un Skill de mejores prácticas específico para un lenguaje, logrando el efecto combinado de "experto + conocimiento especializado". Según investigaciones de Anthropic, los sistemas multiagente (Claude Opus 4 como agente principal + Claude Sonnet 4 como subagentes) superaron en un 90.2% al agente único en evaluaciones internas.

Skills vs comandos de barra

Si ha usado Claude Code, seguramente conoce comandos de barra como /commit y /review. La diferencia fundamental: Skills se activan automáticamente según el contexto; los comandos de barra requieren entrada manual para activarse.

DimensiónSkillsComandos de barra (Slash Commands)
Modo de activaciónActivación automática (según coincidencia de contexto)Entrada manual (como /commit)
Condición de activaciónClaude determina la relevancia según la descriptionEl usuario ingresa explícitamente el comando
Escenarios de usoMejora de capacidades "siempre activa"Operaciones claras y repetibles
Percepción del usuarioSin percepción, se activa automáticamenteNecesita recordar el nombre del comando

Ejemplo: cuando ingresa /commit, Claude ejecuta un flujo de commit predefinido — esto es un comando de barra; cuando dice "ayúdame a escribir un informe semanal", Claude identifica automáticamente y carga el Skill de generación de informes semanales, sin necesidad de que ingrese ningún comando — esto son Skills.

Para recordarlo fácilmente: los comandos de barra son atajos de teclado que requieren activación manual; los Skills son conocimiento de fondo que Claude usa automáticamente cuando lo considera necesario.

Skills vs Plugins

Los Plugins son el mecanismo de paquetes de extensión de Claude Code. La diferencia fundamental: Skills son extensiones de capacidades que se activan automáticamente; Plugins son configuraciones de flujo de trabajo completas empaquetadas para distribución.

DimensiónSkillsPlugins
Función principalExtensión de capacidades especializadasEmpaquetado y distribución de flujos de trabajo
Modo de activaciónActivación automática según contextoLos componentes se fusionan tras la instalación
Alcance de usoMultiplataforma (Claude.ai/Code/API)Solo Claude Code
Contenido incluidoInstrucciones + scripts + recursosComandos de barra + hooks + skills
Mecanismo de distribuciónCarpeta individualInstalación mediante marketplace

Punto clave: los Plugins pueden contener Skills (en el directorio skills/), siendo una unidad de empaquetado más grande. Al instalar un Plugin, los Skills incluidos se activan automáticamente, los comandos de barra aparecen en el autocompletado y los hooks se fusionan con la configuración existente.

En resumen: use Skills para expandir las capacidades de Claude, y Plugins para distribuir configuraciones de flujo de trabajo estandarizadas entre equipos.

Tutorial práctico

Método 1: Habilitar Skills integrados

Esta es la forma más sencilla de comenzar. Anthropic ofrece oficialmente un conjunto de skills de documentos prácticos:

SkillFuncionalidad
Excel (xlsx)Crear hojas de cálculo, analizar datos, generar informes con gráficos
PowerPoint (pptx)Crear presentaciones, editar diapositivas, analizar contenido de presentaciones
Word (docx)Crear documentos, editar contenido, formatear texto
PDF (pdf)Generar documentos PDF formateados e informes

Pasos para habilitar:

  1. Inicie sesión en Claude.ai
  2. Haga clic en el avatar en la esquina superior derecha y acceda a Settings
  3. Encuentre la opción Capabilities
  4. Habilite los skills que necesite

Una vez habilitados, puede probar directamente: "Ayúdame a crear una hoja de cálculo Excel con el presupuesto de ventas del Q3, incluyendo desglose mensual y totales".

Nota: Requiere un plan Pro, Max, Team o Enterprise, y la función de ejecución de código debe estar habilitada.

Método 2: Instalar Skills de la comunidad

Si utiliza Claude Code, puede instalar Skills contribuidos por la comunidad mediante comandos.

Instalación desde el marketplace de plugins:

# Agregar el repositorio oficial de Skills
/plugin marketplace add anthropics/skills

# Instalar el paquete de skills de documentos
/plugin install document-skills@anthropic-agent-skills

# Instalar el paquete de skills de ejemplo
/plugin install example-skills@anthropic-agent-skills

Ubicación de almacenamiento de Skills:

UbicaciónRutaDescripción
Skills personales~/.claude/skills/Disponibles solo para usted
Skills de proyecto.claude/skills/Versionados con git, compartidos con el equipo

Método 3: Crear un Skill personalizado

Aquí es donde reside el verdadero poder de los Skills — crear flujos de trabajo exclusivos para usted.

Paso 1: Crear la estructura de carpetas

mkdir -p ~/.claude/skills/weekly-report
cd ~/.claude/skills/weekly-report

Una carpeta de Skill completa podría verse así:

weekly-report/
├── SKILL.md          # Instrucciones principales (requerido)
├── template.md       # Plantilla de informe semanal (opcional)
└── examples/         # Informes semanales de ejemplo (opcional)
    ├── good-example.md
    └── bad-example.md

Paso 2: Escribir el SKILL.md

SKILL.md es el núcleo de todo el Skill. Se compone de dos partes: el frontmatter YAML (metadatos) y el cuerpo en Markdown (instrucciones detalladas).

Metadatos requeridos:

CampoRequisitoDescripción
nameMáximo 64 caracteresNombre identificador único del skill
descriptionMáximo 200 caracteresIndica a Claude cuándo usar este skill (¡muy importante!)

Metadatos opcionales:

CampoDescripción
dependenciesPaquetes de software requeridos, como python>=3.8, pandas>=1.5.0
allowed-toolsLista de herramientas permitidas
modelAnulación opcional del modelo

Ejemplo completo de un Skill de generación de informes semanales:

---
name: weekly-report
description: 根据本周工作内容生成标准化的周报,包含进展、问题和下周计划
---

# 周报生成助手

## 使用场景
当用户需要生成周报、工作总结或进度汇报时,使用此技能。

## 输出格式
请按以下结构生成周报:

### 本周完成
- 列出已完成的主要工作项
- 每项包含简短说明和成果

### 进行中
- 列出正在进行的工作
- 标注当前进度和预期完成时间

### 遇到的问题
- 列出阻碍进展的问题
- 如果有,说明需要的支持

### 下周计划
- 列出下周的主要任务
- 按优先级排序

## 风格要求
- 使用简洁的表达
- 避免过于技术化的术语
- 突出成果和影响

## 示例

**输入**:这周完成了用户登录功能,修复了 3 个 bug,参加了产品评审。

**输出**:
### 本周完成
- 用户登录功能开发:完成前后端联调,支持邮箱和手机号登录
- Bug 修复:解决了 3 个高优先级问题,提升系统稳定性

### 进行中
- (无)

### 遇到的问题
- (无)

### 下周计划
- 开始用户注册功能开发
- 编写单元测试用例

Paso 3: Probar

Pruebe en Claude: "Ayúdame a generar el informe semanal. Esta semana completé el desarrollo de la función de inicio de sesión de usuarios, corregí 3 bugs y participé en dos reuniones de revisión de producto."

Uso de Skill Creator

Si no desea escribir el SKILL.md desde cero, Claude tiene integrado un skill-creator que puede guiarlo de forma interactiva:

Help me create a skill for [your workflow]

Claude le hará una serie de preguntas para ayudarle a organizar sus necesidades y luego generará un borrador inicial de SKILL.md.

Principios técnicos

Skills como sistema de meta-herramientas

Los Skills son esencialmente un sistema de meta-herramientas — no ejecutan código directamente, sino que inyectan instrucciones especializadas en el contexto de la conversación, modificando la forma en que Claude razona.

Cuando activa un Skill, ocurren dos cosas:

  1. Mensaje de metadatos: Un indicador de estado visible que muestra qué Skill se está cargando
  2. Prompt del skill: Las instrucciones completas del SKILL.md se envían a Claude, pero permanecen ocultas para el usuario

Mecanismo de descubrimiento y selección

¿Cómo sabe Claude qué Skill invocar? La respuesta es: depende completamente de la comprensión del lenguaje.

Los campos name y description de todos los Skills habilitados se formatean como una lista dinámica e incluyen en el prompt del sistema. Cuando usted envía un mensaje, Claude utiliza su capacidad nativa de comprensión del lenguaje para asociar su intención y decidir si debe invocar algún Skill.

Por eso el campo description es tan importante — es la única base de juicio de Claude. No hay algoritmos de enrutamiento complejos; la decisión se completa enteramente dentro del proceso de razonamiento de Claude.

Mejores prácticas

Tras una amplia experimentación, la comunidad ha resumido cuatro reglas de oro para la creación de Skills:

1. Mantener el enfoque

Un Skill debe hacer solo una cosa. Múltiples Skills enfocados son mucho más útiles que un solo Skill que intenta abarcarlo todo; esto no solo facilita el mantenimiento sino también la composición.

2. Descripción clara

El campo description determina cuándo Claude invocará su Skill; es esencial describir claramente los escenarios de uso. "Generar un informe de análisis trimestral basado en datos de ventas" es una buena descripción; "procesar datos" es demasiado genérico.

3. Proporcionar ejemplos

Incluir ejemplos de entrada y salida en SKILL.md mejora significativamente la estabilidad de los resultados, especialmente para tareas con requisitos de formato específicos.

4. Comenzar con lo simple

Empiece con instrucciones básicas en Markdown puro, valide los resultados y luego considere agregar scripts, aumentando la complejidad gradualmente.

Solución de problemas comunes

ProblemaCausa posibleSolución
El Skill no se activaLa description no es suficientemente precisaReescribir con una descripción de escenario de uso más específica
El Skill no se activaEl Skill no está correctamente instaladoVerificar la ruta de archivos y nombres
Resultados inestablesFaltan ejemplosAgregar más ejemplos de entrada/salida
Resultados inestablesInstrucciones demasiado vagasAgregar restricciones y requisitos de formato
Carga lentaArchivo demasiado grandeMover archivos grandes al subdirectorio references

Consideraciones de seguridad

Los Skills pueden ejecutar código, por lo que la seguridad es muy importante:

  • Fuentes confiables: Use solo Skills de canales confiables
  • Revisar scripts: Examine el código de los scripts incluidos en los Skills antes de instalarlos
  • Proteger información sensible: No codifique claves de API o contraseñas directamente en los Skills
  • Gestión de permisos: Al usar en equipo, preste atención al alcance de compartición de los Skills

Limitaciones actuales

Como funcionalidad emergente, los Skills actualmente tienen algunas limitaciones:

LimitaciónDescripción
Solo ecosistema AnthropicResuelto - ver explicación abajo
Falta de mecanismo de auditoríaAún no hay flujo de revisión o auditoría integrado
Curva de aprendizajeLos equipos necesitan ajustar sus flujos de trabajo y establecer procesos de gestión de versiones
Etapa emergenteEl ecosistema aún está en desarrollo

Actualización importante (18 de diciembre de 2025): Anthropic lanzó oficialmente los Agent Skills como estándar abierto. La especificación y el SDK de referencia están disponibles públicamente en agentskills.io.

Empresas/productos que lo han adoptado:

1766152591967.png

  • Microsoft: VS Code y GitHub ya lo integran
  • OpenAI: ChatGPT y Codex CLI adoptan la misma arquitectura
  • Herramientas de programación: Cursor, Goose, Amp, OpenCode
  • Skills de socios: Atlassian, Figma, Canva, Stripe, Notion, Zapier

Simultáneamente, Anthropic, OpenAI y Block cofundaron la Agentic AI Foundation (alojada por la Linux Foundation), a la que también se han unido Google, Microsoft y AWS. Esto significa que los Skills están evolucionando de una funcionalidad de un solo proveedor a un estándar de la industria; los Skills escritos para Claude Code pueden interoperar con OpenAI Codex CLI.

Fuentes de referencia:

Recursos de aprendizaje

Recursos oficiales

RecursoEnlaceDescripción
Repositorio de Skills en GitHubanthropics/skillsEjemplos oficiales, 22k+ Stars
Documentación de Claude Codecode.claude.com/docsGuía de uso de Skills
Centro de ayudasupport.claude.comPreguntas frecuentes
Blog técnicoAnthropic EngineeringAnálisis técnico en profundidad
Inicio rápido de APIdocs.claude.comGuía de integración para desarrolladores
Estándar abierto de Agent Skillsagentskills.ioEspecificación oficial y SDK

Selección de la comunidad

RecursoEnlaceDescripción
awesome-claude-skillsVoltAgent/awesome-claude-skillsColección curada de Skills
Claude Command Suiteqdhenry/Claude-Command-Suite148+ comandos de barra, 54 agentes de IA
Office Skillstfriedel/claude-office-skillsSkills para crear y editar documentos de oficina

Lecturas recomendadas

Perspectivas

La aparición de los Skills representa una dirección importante en el desarrollo de herramientas de IA — permitir que la IA no solo ejecute tareas, sino que también aprenda y memorice formas de trabajo específicas. Simon Willison predice que los Skills desencadenarán una "explosión cámbrica" en el ámbito de las herramientas de IA, y esta predicción no es una exageración.

A medida que más desarrolladores y equipos comiencen a construir y compartir Skills, es posible que veamos:

  • Mercado de Skills especializados: Expertos de diversas industrias empaquetarán su conocimiento en Skills reutilizables
  • Integración profunda entre Skills y MCP: Formando flujos de trabajo completos de extremo a extremo
  • Plataformas empresariales de Skills: Colaboración en equipo, gestión de versiones, control de permisos

Ahora es un buen momento para comenzar. De inmediato, puede iniciar sesión en Claude.ai y habilitar los skills de documentos; esta semana puede intentar instalar un Skill de la comunidad y crear su primer Skill simple; a largo plazo, identificar las tareas repetitivas en su equipo y construir gradualmente una biblioteca de skills propia será una vía efectiva para mejorar la eficiencia.

Lecturas adicionales

Comentarios

Tabla de contenidos