Agent skill

Guida Anomalia dal tuo agente di coding. Preferisci i tool MCP quando sono connessi; altrimenti usa la CLI anomalia. Stessa identità OAuth — niente token API statici.

Preferisci MCP. Quando il server MCP Anomalia è connesso, chiama tool come list_brands e approve_posts. Usa la CLI solo se MCP non è disponibile.

Scegli l'interfaccia

Situazione	Azione
MCP Anomalia connesso	Chiama i tool MCP (list_brands, list_posts, …)
MCP non disponibile	Shell: anomalia … dopo anomalia login
Richiesta vaga / multi-step	MCP chat oppure anomalia ai --message "…" --pipe

Non inventare endpoint REST o API key.

Installa lo skill

Agent Skill pubblicabile (agentskills.io / skills.sh):

npx skills add andreabuttarelli/anomalia-cli --skill anomalia

Oppure installa con lo script hostato:

curl -sSL https://anomalia.so/install-skill.sh | bash

Dopo l'installazione, il tuo assistente AI può gestire direttamente i brand Anomalia.

Puoi anche copiare skills/anomalia/ in .cursor/skills/anomalia/ o ~/.claude/skills/anomalia/.

Auth (sempre OAuth)

MCP / CLI locale: sessione condivisa in ~/.config/anomalia/session.json. Il tool MCP login apre il browser, oppure esegui anomalia login.
MCP remoto (https://mcp.anomalia.so/mcp): invia Authorization: Bearer <access_token> (stesso JWT salvato dalla CLI). Senza Bearer → 401.
Verifica con whoami / list_brands o anomalia brands.

Regole operative

Inizia con list_brands (o anomalia brands) per conoscere gli slug.
Passa slug su ogni chiamata scoped al brand.
Gli id di post/articoli accettano prefissi corti non ambigui dall'output di list — non indovinare se ambigui.
Preferisci tool specifici (approve_posts, edit_post, …) rispetto a chat per edit precisi.
Conferma prima di reject / delete / discard, salvo richiesta esplicita dell'utente.

Workflow rapidi

Approva post in sospeso — list_posts (status pending) → opzionale get_post → approve_posts
Correggi una slide del carousel — get_post → regenerate_slide (index, instruction; 0 = cover)
Bozza blog — generate_article → opzionale optimize_article → publish_article se richiesto

Esempi

"Use the Anomalia CLI to show me my brands"
"Approve all pending posts for flashcamp"
"Ask Anomalia to analyze my last 10 posts"
"Change the tone to friendly and professional"

Agenti supportati

Claude Code — skill completo, installazione automatica
Cursor — MCP + skill da terminale
GitHub Copilot — tramite comandi CLI
Windsurf — tramite integrazione del terminale
Cline — tramite comandi CLI
Aider — tramite modalità pipe

Fallback CLI

Se MCP non è connesso, installa la CLI e lavora dalla shell:

curl -sSL https://anomalia.so/install.sh | bash
anomalia login
anomalia brands
anomalia content <slug> --status pending_user
anomalia approve <slug> --all
anomalia ai <slug> --message "..." --pipe

Per output leggibile dalle macchine:

echo "Analyze my posts" | anomalia ai my-brand --pipe

Avanti

MCP — connetti stdio o HTTP remoto e autenticati
CLI — riferimento completo da terminale
anomalia-cli — sorgenti canoniche dello skill e mappa tool