Por qué los runbooks SKILL.md hacen repetibles a los Agents de marketing
Guía práctica de la capa de Skills de UnifAPI: frases de activación, llamadas de datos, plantillas de salida, reglas de confianza y límites de datos.
En resumen: una Skill es la unidad repetible dentro de un Agent de UnifAPI. Le dice al asistente cuándo usar el flujo de trabajo, qué datos obtener, cómo estructurar la salida y dónde detenerse.
Los prompts son fáciles de escribir y difíciles de mantener. Un flujo de trabajo de marketing útil necesita más de una instrucción. Necesita activadores, requisitos de entrada, elecciones de fuente de datos, reglas de confianza, plantillas de salida y límites.
Por eso los Agents de UnifAPI se implementan como Skills.
Qué pertenece a una Skill
| Parte de la Skill | Qué hace |
|---|---|
| Nombre y descripción | Ayuda al asistente a enrutar hacia el flujo de trabajo correcto |
| Cuándo usarla | Lista las frases de activación y las intenciones del usuario |
| Entradas | Le dice al asistente qué contexto recopilar antes de llamar a los datos |
| Llamadas de datos | Nombra las operaciones de UnifAPI o las Data Skills a usar |
| Flujo de trabajo | Convierte el trabajo en pasos |
| Plantilla de salida | Evita resúmenes imprecisos |
| Reglas de confianza | Separa los hechos observados del juicio inferido |
| Límites | Mantiene al Agent en solo lectura y honesto |
Una Skill es más fuerte cuando nombra una sola capacidad. keyword-research es una Skill. seo-audit es una Skill. ai-answer-gap es una Skill. «Hacer todo el marketing» no lo es.
Skills Enhanced, Advice y Data
UnifAPI usa tres tipos de Skill:
| Tipo de Skill | Qué significa | Ejemplo |
|---|---|---|
| Enhanced | Una capacidad de marketing que llama a datos públicos en vivo | Auditoría de SEO, precios de KOL, auditoría de visibilidad en IA |
| Advice | Marco o juicio sin una llamada en vivo | Guía de esquemas, marcos de posicionamiento |
| Data | Una guía de fuente determinista propiedad de un Platform Agent | LinkedIn Data Skill, Reddit Data Skill |
Esta distinción mantiene claro el producto. No toda Skill de marketing útil necesita una llamada a una API en vivo. Pero cuando una Skill hace una afirmación factual sobre visibilidad pública, debería usar registros.
Por qué las Skills deberían nombrar operaciones
Un asistente puede descubrir operaciones a través de MCP, pero el descubrimiento no es todo el flujo de trabajo. Una buena Skill debería seguir diciéndole al asistente qué familias de datos importan para el trabajo.
Por ejemplo, una Skill de auditoría de SEO puede decir:
- Extrae evidencia de SERP en vivo para las consultas objetivo.
- Usa el resumen y el historial de keywords para el contexto de demanda.
- Usa Browser Markdown para la página objetivo y las páginas de los principales competidores.
- Devuelve un plan de correcciones con la evidencia observada y las recomendaciones separadas.
Eso es mucho mejor que: «Usa la API si hace falta».
Las plantillas de salida son parte del producto
La forma de la salida es donde fallan muchos flujos de trabajo de agentes. Sin una plantilla, el asistente puede devolver un resumen agradable sobre el que no se puede actuar.
Una Skill debería especificar el artefacto:
| Flujo de trabajo | Artefacto útil |
|---|---|
| Precios de KOL | Tabla de creadores clasificada con rangos bajo/base/alto y confianza |
| Auditoría de GEO | Matriz de citación y mención prompt por prompt |
| Escaneo de local pack | Consulta, rank, competidores, número de reseñas y posición en el mapa |
| Perfilado de competidor | Cronología de lanzamiento, canales, afirmaciones, prueba y riesgos |
| Estrategia de contenido | Backlog de oportunidades con demanda, evidencia de fuentes y afinidad |
Las plantillas no hacen robótico al asistente. Hacen revisable la respuesta.
Las reglas de confianza evitan la falsa certeza
Los datos públicos son potentes, pero no son omniscientes. Una Skill debería hacer que el asistente etiquete:
| Etiqueta | Significado |
|---|---|
| Observado | Leído directamente de un registro público |
| Inferido | Deducido a partir de varios registros |
| Asumido | Aportado por el usuario o necesario para completar el análisis |
| Desconocido | No disponible a partir de los datos públicos |
Eso importa en los flujos de trabajo de marketing. Una Skill de precios de KOL puede estimar un rango, no una tarifa final. Una Skill de GEO puede informar de la visibilidad, no garantizar una inclusión futura. Una Skill de SEO local puede auditar fichas, no editarlas.
Una breve lista de comprobación de calidad de una Skill
Antes de publicar una Skill, pregúntate:
- ¿Se corresponde con un trabajo concreto?
- ¿La descripción incluye frases de activación reales?
- ¿Especifica las entradas requeridas y las opcionales?
- ¿Nombra las fuentes de datos o las Data Skills a usar?
- ¿Incluye una plantilla de salida?
- ¿Explica la confianza y los límites?
- ¿Enlaza con Skills relacionadas para el trabajo de seguimiento?
Si la respuesta es no, la Skill probablemente sea un borrador de prompt, no un flujo de trabajo.
Qué leer a continuación
Platform Agents y Data Skills - muestra la versión específica de cada fuente de las Skills.
Arquitectura Agent First - explica dónde se sitúan las Skills entre los Agents y las APIs.
Explora las Skills de UnifAPI - mira las páginas de Skills en vivo.