Docs/Agent skill

Agent skill

Opera Anomalia desde tu agente de coding. Prefiere tools MCP cuando estén conectadas; si no, usa la CLI anomalia. Misma identidad OAuth — sin tokens de API estáticos.

Prefiere MCP. Cuando el servidor MCP de Anomalia está conectado, llama tools como list_brands y approve_posts. Usa la CLI solo si MCP no está disponible.

Elige la interfaz

SituaciónAcción
MCP Anomalia conectadoLlama tools MCP (list_brands, list_posts, …)
MCP no disponibleShell: anomalia … tras anomalia login
Petición vaga / multi-pasoMCP chat o anomalia ai --message "…" --pipe

Nunca inventes endpoints REST ni API keys.

Instalar la skill

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

npx skills add anomaliaso/anomalia --skill anomalia

O instala con el script alojado:

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

Después de la instalación, tu asistente de IA puede gestionar marcas de Anomalia directamente.

También puedes copiar skills/anomalia/ a .cursor/skills/anomalia/ o ~/.claude/skills/anomalia/.

Auth (siempre OAuth)

  • MCP local / CLI: ejecuta anomalia login una vez en la terminal. La sesión queda en ~/.config/anomalia/session.json y la CLI y el servidor MCP la comparten.
  • MCP remoto (https://mcp.anomalia.so/mcp): tu host hace la ronda OAuth por su cuenta. Sin Bearer → 401, que es el desafío, no un fallo.
  • No hay una herramienta para iniciar sesión. Confirma con list_brands o anomalia brands: o vuelven las marcas, o no hay nadie conectado.

Reglas operativas

  1. Empieza con list_brands (o anomalia brands) para conocer los slugs.
  2. Pasa slug en cada llamada con alcance de marca.
  3. Los ids de posts/artículos aceptan prefijos cortos inequívocos del listado — no adivines si hay ambigüedad.
  4. Prefiere tools específicas (approve_posts, edit_post, …) frente a chat para ediciones precisas.
  5. Confirma antes de reject / delete / discard salvo que el usuario lo pida claramente.

Flujos rápidos

  • Aprobar posts pendientes — list_posts (status pending) → opcional get_post → approve_posts
  • Corregir una slide del carrusel — get_post → regenerate_slide (index, instruction; 0 = cover)
  • Borrador de blog — generate_article → opcional optimize_article → publish_article si se pide

Ejemplos

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

Agentes compatibles

  • Claude Code — skill completa, instalada automáticamente
  • Cursor — MCP + skill de terminal
  • GitHub Copilot — mediante comandos de CLI
  • Windsurf — mediante integración con la terminal
  • Cline — mediante comandos de CLI
  • Aider — mediante modo pipe

Fallback CLI

Si MCP no está conectado, instala la CLI y trabaja desde la 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

Para salida legible por máquina:

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

Siguiente

  • MCP — conecta stdio o HTTP remoto y autentícate
  • CLI — referencia completa de terminal
  • anomalia — fuentes canónicas de la skill y mapa de tools