Skill per agenti IA

Le skill di GetMyBot sono wrapper agentivi pronti sopra l'API GetMyBot. Insegnano a un agente IA (ad esempio, Claude Code) a lavorare con i tuoi bot nel linguaggio naturale: «crea una reazione in GetMyBot», «avvia una trasmissione GetMyBot per l'etichetta VIP», «mostra le statistiche del bot». Sotto il cofano lo skill chiama gli strumenti MCP di GetMyBot, e se il server MCP non è connesso — esegue le stesse richieste tramite REST con il tuo token.

Le skill non sono una funzionalità a pagamento separata né un marketplace. Sono file SKILL.md (formato Claude Code) che installi localmente accanto al tuo agente.

Come funziona

Ogni skill è strutturata secondo il principio di progressive disclosure: una breve descrizione attiva lo skill su formulazioni di dominio, mentre il pesante riferimento API viene caricato solo quando necessario. All'interno di ogni skill sono documentati due percorsi di accesso:

  • MCP (preferito) — se il server MCP GetMyBot è connesso all'agente, lo skill chiama gli strumenti direttamente.
  • Fallback REST — se MCP non è disponibile, lo skill esegue le stesse operazioni con richieste curl e token personale.

L'autenticazione in tutti gli skill è unica: token personale mbp_… e indirizzo base /api. Maggiori dettagli nella guida all'autorizzazione.

Sei skill

  • mybot — punto di ingresso e navigazione: cos'è l'API GetMyBot, come ottenere il PAT e i suoi ambiti, indirizzo base, come connettere il server MCP, quando REST e quando MCP, formato degli errori, paginazione e limiti. Da qui l'agente accede agli altri cinque skill.
  • mybot-bots — connessione e gestione dei bot: verifica del token, connessione, elenco e scheda, aggiornamento, sincronizzazione, cambio token, trasferimento, eliminazione, impostazioni, template.
  • mybot-reactions — costruttore di reazioni (il più grande): struttura «trigger → condizioni → chat → azioni», creazione e aggiornamento, tipi di trigger, condizioni E/O, catalogo delle azioni, messaggi e pulsanti, pulsanti dinamici e parametri, formule (DSL), cartelle, link delle reazioni, import da SamBot, verifica delle formule, ordine.
  • mybot-broadcasts — trasmissioni: avvio per reazione, segmentazione per etichette, pausa/ripresa/annullamento e stato, modifica dei messaggi già inviati (singolo e «per tutti»), coda e retry.
  • mybot-data — dati e integrazioni: raccolte (tabelle — campi e record), scenari (flows), integrazioni (IA, Google Sheets, GetCourse, handler esterno via WebSocket), connessioni e accessi.
  • mybot-analytics — osservabilità e audience: statistiche (consumo del saldo, metriche, registro, salute delle reazioni), analisi (audience, chat, funnel), iscritti ed etichette, dialoghi, fatturazione (saldo, piani, transazioni).

Installazione

Le skill si trovano nel repository GetMyBot nella cartella skills/. Ogni skill è una cartella skills/<name>/ con i file SKILL.md (guida rapida) e reference.md (riferimento completo per dominio con esempi su MCP e curl).

Perché l'agente veda le skill, collegale alla tua directory delle skill di Claude Code. Nel repository c'è già uno script pronto:

./skills/install.sh

Crea symlink ~/.claude/skills/<name> che puntano alle cartelle all'interno del repository — le modifiche nel repository sono subito visibili all'agente, senza copie superflue. Dopo l'installazione formula il compito con parole normali («crea in GetMyBot un bot risponditore automatico»), e l'agente caricherà automaticamente lo skill giusto.

Passo successivo