Skill

twilio

Every Twilio Core feature, plus offline message and call history, FTS, and SQL-grade analytics no other Twilio tool...

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use twilio

Choose if

You run Twilio at scale (multi-subaccount agencies, high-volume SMS/voice) and want an agent to do delivery debugging, TCPA opt-out audits, orphan webhook detection, idle-number cleanup, and SQL-grade analytics — all from one CLI. Versus the official twilio-cli, this adds a local FTS-backed store for sub-second analytics queries the API can't answer cheaply at scale.

Avoid if

You only need to send a one-off SMS — that's overkill (use the Twilio SDK directly). Also avoid before running `sync --full`; FTS queries depend on local-store freshness. Heavy-concurrency sync workloads on accounts already near the 100 req/s default will hit HTTP 429 unless you tune `--concurrency` or get the cap raised by support.

Risk Flags

  • MEDIUM auth Supports Master Auth Token (AC…) and scoped API Key (SK…). Scoped keys only operate on the account that minted them; mismatched key/TWILIO_ACCOUNT_SID pairings fail with 401. Rotated Auth Tokens in the secondary slot can also cause 401s until propagation.
  • MEDIUM rate_limit Twilio API defaults to ~100 req/s during sync. The CLI documents reducing parallelism with `--concurrency 4` or opening a support ticket to raise the cap. HTTP 429 during heavy sync is expected on large accounts.
  • HIGH data_quality Orphan webhooks silently fail incoming calls and SMS — the CLI surfaces them explicitly so an agent can detect compliance/reliability gaps. Texting STOP/UNSUBSCRIBE recipients creates TCPA exposure ($500–$1,500/violation); the CLI flags opt-out violations.
  • LOW scope Fresh installs return empty results until `sync --full` runs. FTS queries rely on local-store freshness — agents must keep sync current for accurate "last 7 days" answers.

Cost

Type: Usage based · Free tier: The CLI itself is free to install. All upstream Twilio calls bill against your Twilio account; pricing depends on your plan and per-message/per-call rates. README explicitly mentions $1/number/month for idle phone numbers as a cost-recovery motivator.

Hidden costs

  • Phone number retention: $1/number/month — agencies running 100+ idle subaccount numbers can save hundreds annually by detecting and releasing them.
  • TCPA violation exposure: $500–$1,500 per violation when texting STOP/UNSUBSCRIBE recipients.

Install

Default

npx -y @mvanhorn/printing-press install twilio
# Use a scoped API key for least privilege:
export TWILIO_ACCOUNT_SID=<AC...>
export TWILIO_API_KEY=<SK...>
export TWILIO_API_SECRET=<...>
# Seed the local store before querying:
<cli> sync --full

Setup docs →

Estimated time to first success: ~15 min

Dependencies

Minimum runtime: Node.js (npx) or Go 1.26.3+ for CLI-only install

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT