[Docs](/it/docs) /Agent skill

# 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

1.  Inizia con list\_brands (o anomalia brands) per conoscere gli slug.
2.  Passa slug su ogni chiamata scoped al brand.
3.  Gli id di post/articoli accettano prefissi corti non ambigui dall'output di list — non indovinare se ambigui.
4.  Preferisci tool specifici (approve\_posts, edit\_post, …) rispetto a chat per edit precisi.
5.  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](/it/docs/mcp) — connetti stdio o HTTP remoto e autenticati
-   [CLI](/it/docs/cli) — riferimento completo da terminale
-   [anomalia-cli](https://github.com/andreabuttarelli/anomalia-cli) — sorgenti canoniche dello skill e mappa tool

[

← Precedente

MCP

](/it/docs/mcp)

---
Source: https://www.anomalia.so/it/docs/agents