¿Qué es un skill?
Un skill es una capacidad autocontenida y versionada que amplía lo que un agente de IA puede hacer. Los skills se definen mediante un único fichero SKILL.md — un documento markdown con frontmatter YAML que describe la identidad del skill, su propósito, las condiciones de activación y las instrucciones de ejecución.
El runtime de Hordago descubre los skills al inicio de la sesión, empareja la intención del usuario con los triggers de los skills e invoca las instrucciones del skill relevante cuando se cumplen las condiciones.
El contrato SKILL.md
Cada skill es un fichero SKILL.md en la raíz de su directorio. El runtime lee este fichero y extrae dos cosas:
- Frontmatter — metadatos estructurados (title, trigger, version, author, etc.)
- Cuerpo — instrucciones libres en markdown que el agente sigue cuando el skill está activo
---
name: my-skill
title: "My Skill"
description: "What this skill does in one sentence."
version: "1.0.0"
author: "your-github-handle"
trigger: "Use when the user asks to do X or Y."
---
# My Skill
Instructions for the agent go here. Be specific about:
- What inputs to expect
- What steps to take
- What output to produceCómo se invocan los skills
Los skills se invocan de dos formas:
- Explícita — el usuario escribe
/skill-namecomo comando slash - Implícita — el runtime empareja la intención del usuario con el campo
triggerde cada skill y activa automáticamente la mejor coincidencia
Una vez activo, el cuerpo del skill se convierte en las instrucciones operativas del agente para esa tarea.
Skills vs. prompts vs. plugins
| Concepto | Propósito | Alcance |
|---|---|---|
| Skill | Define comportamiento reutilizable del agente | Una sola capacidad |
| Plugin | Agrupa varios skills + herramientas MCP | Conjunto completo de funcionalidades |
| Prompt | Instrucciones puntuales | Un turno de conversación |
Los skills son la unidad atómica. Los plugins son colecciones de skills. Si estás construyendo una capacidad enfocada, empieza con un skill.
Próximos pasos
¿Listo para construir tu primer skill? Ve al inicio rápido de 10 minutos.