Documentazione

Agenti AI (MCP)

Skill playbook

I 22 playbook che il server MCP di AmICited fornisce come risorse skill: quali strumenti chiamare, in quale ordine e le trappole che rendono sbagliata una risposta sicura di sé.

Gli strumenti sono ciò che un agente può raggiungere. Le skill sono il modo di usarli per una domanda reale. Con oltre 300 strumenti, la parte difficile raramente è trovarne uno: è sapere che “perché è calato il traffico” richiede sei report in un ordine preciso, o che un report ecommerce vuoto può significare “non collegato” e non “zero ricavi”.

Il server MCP di AmICited fornisce questi playbook come risorse MCP. Ognuno è stato scritto sottoponendo agli agenti domande difficili sul server reale senza alcun playbook, registrando ogni vicolo cieco e ogni ipotesi sbagliata, e trasformando quei fallimenti in istruzioni. Ogni nome di strumento citato da una skill viene verificato a ogni build rispetto al registro degli strumenti reale, quindi una skill non rimanda mai a uno strumento che non esiste più.

Come li trovano gli agenti#

Le skill sono servite a skill://<name>/SKILL.md. Elencarle costa un nome e una riga ciascuna; il contenuto viene recuperato solo quando un agente lo vuole.

  • Le istruzioni del server, inviate a ogni client alla connessione, dicono all’agente di leggere prima skill://using-amicited/SKILL.md. Quella skill spiega il ciclo trova, ispeziona, esegui ed elenca le altre.
  • Molti client non elencano mai le risorse da soli. Se il tuo agente sembra non conoscere una skill, nominala: “Read skill://ai-visibility-audit/SKILL.md, then audit example.com.”
  • Le skill sono testo di sola lettura. Leggerne una non conta nel tetto orario delle chiamate agli strumenti.

Convenzioni#

SkillScopo
using-amicitedCome guidare l’endpoint: trovare lo strumento giusto tra più di 300, invocarlo e le convenzioni che ogni altra skill dà per scontate. Da leggere per prima.
report-windowsPeriodi di date e periodi di confronto tra i report: i diversi stili di argomenti, la regola della stessa durata e come evitare numeri sbagliati con sicurezza.

Visibilità AI e concorrenti#

SkillScopo
ai-visibility-auditDiagnostica perché un brand viene o non viene citato nelle risposte AI: quali motori sono stati realmente eseguiti, cosa nasconde il dato principale e quattro controlli che spiegano un divario.
competitor-gap-analysisTrova dove i concorrenti vincono nelle risposte AI e nella ricerca e tu no, e quali divari affrontare per primi.
competitor-content-gapsTrova sezioni delle sitemap dei concorrenti, vocabolario e divari di pubblicazione senza esagerare quando i dati di freschezza sono incompleti.
ai-fanout-queriesTrova le ricerche che un assistente AI ha eseguito sul tuo sito (quelle con un operatore site:) e leggile senza scambiare lo zero clic per un problema.
prompt-set-designAggiungi prompt monitorati per un dominio: come si presenta un buon insieme di prompt, la trappola dei tag e perché nulla qui può dirti il costo in crediti.

Diagnostica della ricerca organica#

SkillScopo
traffic-drop-triageCapisci perché il traffico organico si è mosso: localizzalo su una query o una pagina, data il salto ed escludi indicizzazione, interruzioni e modifiche al sito prima di incolpare i posizionamenti.
did-our-change-workCorrela una modifica al sito con ciò che è successo dopo, e perché uno storico di annotazioni vuoto non è prova di nulla.
indexing-triageIndaga sui problemi di indicizzazione: quale strumento risponde a quale metà, perché un verdetto nullo non è un no e lo schema del 404 senza redirect.
cannibalization-cleanupTrova pagine in competizione per la stessa query, e perché il vertice della classifica di gravità è di solito rumore di brand.
page-familiesLeggi una pagina e le sue traduzioni come un’unica famiglia e collega una variazione di traffico a una modifica di hreflang o canonical.
site-audit-reviewValuta il costo, esegui e interpreta gli audit del sito basati sulle sitemap per correggere problemi tecnici e migliorare la link equity interna.
backlinks-reviewValuta se i backlink monitorati hanno ancora valore: cosa nasconde “attivo”, perso rispetto a irraggiungibile e il confronto dell’autorevolezza con i concorrenti.

Denaro#

SkillScopo
profitability-deep-diveRiporta il profitto ecommerce con onestà: verifica la copertura dei costi prima di citare qualsiasi margine, perché un costo non configurato viene letto come zero.
customer-valueLifetime value, coorti e riacquisto, e perché il periodo deve essere lungo.
paid-waste-reviewTrova la spesa pubblicitaria sprecata senza inventare profitto, anche quando il valore di conversione non è realmente denaro.
seo-to-revenueSostieni il lavoro organico in termini di denaro e non di clic, dopo aver verificato che esistano i dati di canale per attribuire i ricavi.

Operatività e deliverable#

SkillScopo
platform-onboardingCollega una piattaforma di dati a un dominio e importa il suo storico: la catena preventivo poi conferma e dove viene impegnato il denaro.
uptime-setupConfigura monitor, avvisi, heartbeat, finestre di manutenzione e una pagina di stato senza impostazioni predefinite a metà.
availability-reviewRispondi a “il sito era attivo, cosa si è rotto e c’è qualcosa che non funziona ora”, comprese le regole del mese di calendario del report SLA.
recurring-reportsProduci un report SEO settimanale o ecommerce mensile confrontabile con il precedente: periodi fissi, strumenti fissi, avvertenze riportate.

Cosa cambia una skill nella pratica#

Due esempi di ciò che i playbook intercettano e gli schemi degli strumenti no:

  • La ripartizione per provider nasconde i motori silenziosi. La ripartizione per piattaforma della dashboard elenca solo i motori che ti hanno citato. ai-visibility-audit manda l’agente su get_prompt_detail, che mostra per ogni motore se è stato eseguito e se ti ha citato, così “24% di visibilità” diventa “citato da Perplexity, ignorato da ChatGPT”. Vedi dati mancanti di un motore.
  • Non collegato non significa zero. using-amicited fa controllare all’agente se una piattaforma è collegata prima di riportare che non ha dati, e ti rimanda a Origini dati quando non lo è.

Nomina la skill nella tua richiesta quando conosci la domanda: “Use the traffic-drop-triage skill to explain last week’s drop on example.com.” L’agente legge prima il playbook e ne segue l’ordine. La pagina Ricette ha prompt già pronti.

Correlati#