Documentación

Agentes de IA (MCP)

Playbook skills

Los 22 playbooks que el servidor MCP de AmICited ofrece como recursos skill: qué herramientas llamar, en qué orden, y las trampas que hacen que una respuesta segura sea errónea.

Las herramientas son a lo que puede acceder un agente. Los skills son cómo usarlas para una pregunta real. Con más de 300 herramientas, lo difícil rara vez es encontrar una: es saber que “por qué cayó el tráfico” necesita seis informes en un orden concreto, o que un informe de ecommerce vacío puede significar “no conectado” en lugar de “cero ingresos”.

El servidor MCP de AmICited ofrece estos playbooks como recursos MCP. Cada uno se escribió planteando a agentes preguntas difíciles contra el servidor real sin ningún playbook, registrando cada callejón sin salida y cada suposición errónea, y convirtiendo esos fallos en instrucciones. Cada nombre de herramienta que menciona un skill se comprueba contra el registro de herramientas real en cada compilación, así que un skill nunca apunta a una herramienta que ya no existe.

Cómo los encuentran los agentes#

Los skills se sirven en skill://<name>/SKILL.md. Listarlos cuesta un nombre y una línea cada uno; el cuerpo solo se obtiene cuando un agente lo quiere.

  • Las instrucciones del servidor, enviadas a cada cliente al conectarse, indican al agente que lea primero skill://using-amicited/SKILL.md. Ese skill explica el bucle de encontrar, inspeccionar y ejecutar, y lista los demás.
  • Muchos clientes nunca listan recursos por su cuenta. Si tu agente parece desconocer un skill, nómbralo: “Read skill://ai-visibility-audit/SKILL.md, then audit example.com.”
  • Los skills son texto de solo lectura. Leer uno no cuenta para el tope horario de llamadas a herramientas.

Convenciones#

SkillPropósito
using-amicitedCómo manejar el endpoint: encontrar la herramienta adecuada entre más de 300, invocarla y las convenciones que asumen todos los demás skills. Léelo primero.
report-windowsVentanas de fechas y periodos de comparación en los informes: los distintos estilos de argumentos, la regla de igual duración y cómo evitar cifras erróneas dichas con seguridad.

Visibilidad en IA y competidores#

SkillPropósito
ai-visibility-auditDiagnostica por qué una marca es o no citada en las respuestas de IA: qué motores se ejecutaron realmente, qué oculta la cifra principal y cuatro comprobaciones que explican una brecha.
competitor-gap-analysisEncuentra dónde ganan los competidores las respuestas de IA y la búsqueda que tú no, y qué brechas atacar primero.
competitor-content-gapsEncuentra secciones de sitemap, vocabulario y brechas de publicación de los competidores sin exagerar datos de frescura incompletos.
ai-fanout-queriesEncuentra las búsquedas que un asistente de IA ejecutó contra tu sitio (las que llevan un operador site:) y léelas sin confundir un CTR cero con un problema.
prompt-set-designAñade prompts monitorizados para un dominio: cómo es un buen conjunto de prompts, la trampa del etiquetado y por qué nada aquí puede decirte el coste en créditos.

Diagnóstico de búsqueda orgánica#

SkillPropósito
traffic-drop-triageAverigua por qué se movió el tráfico orgánico: localízalo en una consulta o página, fecha el escalón y descarta indexación, caídas y cambios en el sitio antes de culpar a los posicionamientos.
did-our-change-workCorrelaciona un cambio en el sitio con lo que ocurrió después, y por qué un historial de anotaciones vacío no es prueba de nada.
indexing-triageInvestiga problemas de indexación: qué herramienta responde a cada mitad, por qué un veredicto nulo no es un no y el patrón del 404 sin redirección.
cannibalization-cleanupEncuentra páginas que compiten por la misma consulta, y por qué lo más alto del ranking de gravedad suele ser ruido de marca.
page-familiesLee una página y sus traducciones como una sola familia, y relaciona un cambio de tráfico con una edición de hreflang o canonical.
site-audit-reviewPresupuesta, ejecuta e interpreta auditorías de sitemap para corregir problemas técnicos y mejorar la autoridad de enlaces internos.
backlinks-reviewJuzga si los backlinks monitorizados siguen aportando valor: qué oculta “activo”, perdido frente a inaccesible y cómo comparar la autoridad con la de los competidores.

Dinero#

SkillPropósito
profitability-deep-diveInforma del beneficio de ecommerce con honestidad: comprueba la cobertura de costes antes de citar cualquier margen, porque un coste sin configurar se lee como cero.
customer-valueValor de vida del cliente, cohortes y recompra, y por qué la ventana tiene que ser larga.
paid-waste-reviewEncuentra gasto publicitario desperdiciado sin inventar beneficio, incluso cuando el valor de conversión no es realmente dinero.
seo-to-revenueDefiende el trabajo orgánico en dinero en lugar de en clics, tras comprobar que existen los datos de canal para atribuir ingresos.

Operaciones y entregables#

SkillPropósito
platform-onboardingConecta una plataforma de datos a un dominio e importa su historial: la cadena de presupuesto y confirmación y dónde se compromete el dinero.
uptime-setupConfigura monitores, alertas, heartbeats, ventanas de mantenimiento y una página de estado sin valores predeterminados a medio configurar.
availability-reviewResponde a “¿estaba el sitio activo, qué falló y hay algo caído ahora?”, incluidas las reglas de mes natural del informe de SLA.
recurring-reportsProduce un informe semanal de SEO o mensual de ecommerce comparable con el anterior: ventanas fijas, herramientas fijas, advertencias arrastradas.

Qué cambia un skill en la práctica#

Dos ejemplos de lo que detectan los playbooks y los esquemas de las herramientas no pueden:

  • El desglose por proveedor oculta los motores silenciosos. El desglose por plataforma del dashboard solo lista los motores que te citaron. ai-visibility-audit envía al agente a get_prompt_detail, que muestra para cada motor si se ejecutó y si te citó, de modo que “24% de visibilidad” se convierte en “citado por Perplexity, ignorado por ChatGPT”. Consulta motores sin datos.
  • No conectado no es cero. using-amicited hace que el agente compruebe si una plataforma está conectada antes de informar de que no tiene datos, y te enlace a Fuentes de datos cuando no lo está.

Nombra el skill en tu petición cuando conozcas la pregunta: “Use the traffic-drop-triage skill to explain last week’s drop on example.com.” El agente lee primero el playbook y sigue su orden. La página de recetas tiene prompts ya preparados.

Relacionado#