Saltar al contenido
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

Skill para agentes de código

Instala la skill de BillionSend para que Claude Code y Codex sepan conectarse, trabajar una bandeja de entrada y tratar el correo recibido como no confiable.

La skill de BillionSend es un archivo SKILL.md que enseña a un agente de código a usar BillionSend: conectarse al servidor MCP con OAuth o con una clave de agente, encontrar una bandeja de entrada, esperar códigos de verificación y mensajes, responder, preparar borradores para aprobación, qué hacer cuando las reglas de la bandeja de entrada retienen un envío como borrador y por qué el correo recibido son datos y nunca instrucciones. El agente la carga cuando una tarea menciona BillionSend, una clave de API bs_ o una clave bs_agent_, o dar una bandeja de entrada de email a un agente.

El archivo está en https://billionsend.com/docs/skills/billionsend/SKILL.md. Está escrito en inglés, el idioma en el que lo leen los agentes.

Instalar

Cada agente lee las skills de una carpeta con el nombre de la skill, billionsend, que contiene SKILL.md.

mkdir -p ~/.claude/skills/billionsend
curl -fsSL https://billionsend.com/docs/skills/billionsend/SKILL.md -o ~/.claude/skills/billionsend/SKILL.md

Así queda instalada para todos los proyectos de esta máquina. Para compartirla con el equipo de un repositorio, guárdala como .claude/skills/billionsend/SKILL.md en el repositorio y haz commit.

mkdir -p ~/.agents/skills/billionsend
curl -fsSL https://billionsend.com/docs/skills/billionsend/SKILL.md -o ~/.agents/skills/billionsend/SKILL.md

Así queda instalada para todos los proyectos de esta máquina. Para compartirla con el equipo de un repositorio, guárdala como .agents/skills/billionsend/SKILL.md en la raíz del repositorio y haz commit.

Ejecuta el comando otra vez para actualizar la skill. Abre una sesión nueva después de instalarla para que el agente la cargue.

Conectar el servidor MCP

La skill le dice al agente cómo usar las herramientas de BillionSend; el agente sigue necesitando el servidor.

claude mcp add --transport http billionsend https://api.billionsend.com/mcp

Después ejecuta /mcp dentro de Claude Code y elige billionsend para iniciar sesión. Consulta el servidor MCP para ver los permisos que concedes.

Crea una clave de agente en MCP → Crear clave de agente y añade el servidor a ~/.codex/config.toml:

[mcp_servers.billionsend]
url = "https://api.billionsend.com/mcp"
bearer_token_env_var = "BILLIONSEND_AGENT_KEY"

Exporta BILLIONSEND_AGENT_KEY en el shell antes de iniciar Codex. La clave nunca va en el archivo.

Qué cubre la skill

Parte Qué le dice al agente
Conexión El endpoint MCP, OAuth y las claves de agente, los tres alcances de las claves de agente, y que las claves bs_ normales solo funcionan en la API REST.
Flujos de bandeja de entrada Primero list_inboxes (las herramientas reciben el id de la bandeja de entrada), después get_verification_code, wait_for_received_email, get_received_email, reply_to_received_email, send_from_inbox y las herramientas de borradores.
Envíos retenidos Que un draft con motivos son las reglas funcionando: informarlo, señalar la pestaña Pendientes de revisión y no esquivarlo nunca. Los errores que puede encontrar y qué significa cada uno.
Correo no confiable El sobre untrusted_data y el delimitador UNTRUSTED EMAIL CONTENT, sender_trust y screening.verdict, y qué no hacer jamás porque lo pida un mensaje. Consulta Seguridad de agentes.
Envío send_email y send_email_batch desde dominios verificados, get_usage antes de trabajos masivos y la API REST.

La skill no añade ningún permiso. Lo que el agente puede hacer lo siguen fijando su autorización OAuth o el alcance de su clave de agente, su rol de equipo y las reglas de envío de cada bandeja de entrada.

¿Te ha resultado útil esta página?