Docs/Agent skill

Agent skill

Pilotez Anomalia depuis votre agent de coding. Préférez les outils MCP lorsqu'ils sont connectés ; sinon utilisez la CLI anomalia. Même identité OAuth — pas de tokens API statiques.

Préférez MCP. Quand le serveur MCP Anomalia est connecté, appelez des outils comme list_brands et approve_posts. N'utilisez la CLI que si MCP n'est pas disponible.

Choisir l'interface

SituationAction
MCP Anomalia connectéAppelez les outils MCP (list_brands, list_posts, …)
MCP indisponibleShell : anomalia … après anomalia login
Demande vague / multi-étapesMCP chat ou anomalia ai --message "…" --pipe

N'inventez jamais d'endpoints REST ni de clés API.

Installer le skill

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

npx skills add anomaliaso/anomalia --skill anomalia

Ou installez via le script hébergé :

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

Après l'installation, votre assistant IA peut gérer les marques Anomalia directement.

Vous pouvez aussi copier skills/anomalia/ dans .cursor/skills/anomalia/ ou ~/.claude/skills/anomalia/.

Auth (toujours OAuth)

  • MCP local / CLI : lancez anomalia login une fois dans un terminal. La session est stockée dans ~/.config/anomalia/session.json et la CLI et le serveur MCP la partagent.
  • MCP distant (https://mcp.anomalia.so/mcp) : votre hôte effectue lui-même le tour OAuth. Sans Bearer → 401, c'est le défi, pas une panne.
  • Il n'y a pas d'outil de connexion. Vérifiez avec list_brands ou anomalia brands : soit les marques reviennent, soit personne n'est connecté.

Règles d'utilisation

  1. Commencez par list_brands (ou anomalia brands) pour connaître les slugs.
  2. Passez slug à chaque appel scoped à une marque.
  3. Les ids de posts/articles acceptent des préfixes courts non ambigus issus des listes — ne devinez pas en cas d'ambiguïté.
  4. Préférez des outils précis (approve_posts, edit_post, …) à chat pour des edits ciblés.
  5. Confirmez avant reject / delete / discard sauf demande explicite de l'utilisateur.

Workflows rapides

  • Approuver les posts en attente — list_posts (status pending) → get_post optionnel → approve_posts
  • Corriger une slide du carrousel — get_post → regenerate_slide (index, instruction ; 0 = cover)
  • Brouillon blog — generate_article → optimize_article optionnel → publish_article si demandé

Exemples

"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"

Agents compatibles

  • Claude Code — skill complet, installé automatiquement
  • Cursor — MCP + skill terminal
  • GitHub Copilot — via les commandes CLI
  • Windsurf — via l'intégration avec le terminal
  • Cline — via les commandes CLI
  • Aider — via le mode pipe

Fallback CLI

Si MCP n'est pas connecté, installez la CLI et travaillez depuis le 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

Pour une sortie lisible par machine :

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

Suite

  • MCP — connectez stdio ou HTTP distant et authentifiez-vous
  • CLI — référence terminal complète
  • anomalia — sources canoniques du skill et carte des outils