twilio-extract

name	twilio-extract
description	Query Twilio Conversations, Studio Flows, and Monitor/Debugger via the REST API — find conversations by phone/WhatsApp number, read messages and attributes, inspect Studio Flow executions, list debugger alerts. Use when the user wants to look up/inspect/debug Twilio conversations, or check a phone number's history in Twilio. Not for instrumenting a channel adapter — that's a coding task.
origin	local

Twilio Extract

Read-side tool: pulls data OUT of Twilio (conversations, messages, participants, Studio Flow executions/steps, debugger alerts) via the REST API. Also exposes two opt-in mutating commands (update-attributes, close) gated behind --yes, for the same debugging use cases documented in this org's Twilio integration docs.

When to Activate

• "busca las conversaciones de Twilio pa este número"
• "qué attributes tiene esta conversación de Twilio"
• "revisa la ejecución del Studio Flow pa este execution sid"
• "hay alertas recientes en el debugger de Twilio"
• Cross-referencing a Twilio conversation with our own DB / Langfuse session

Credentials — .env convention

One .env file per account/workspace at ~/.twilio_<workspace>.env — same pattern already in use in this environment (~/.twilio_qa.env, ~/.twilio_qa_prod.env), never committed to git.

Template: .env.example in this skill's directory. Required vars:

WORKSPACE_NAME=       # label for logs
ACCOUNT_SID=          # AC...
AUTH_TOKEN=           # live Auth Token (Test SID/Token don't work for Conversations/Studio)