steipete/twilio-sms

Twilio SMS CLI: Nummern kaufen/auflisten/behalten, Nachrichten senden/prüfen, Credential-Routing.

Was ist twilio-sms?

Dieses Skill für KI-Agenten (z. B. Claude Code, Cursor, Codex) ermöglicht die vollständige Verwaltung von Twilio-Telefonnummern und SMS-Operationen direkt über die Kommandozeile. Es unterstützt das Kaufen und Auflisten von Nummern, das Kennzeichnen und Behalten von Nummern, das Senden von SMS sowie das Überprüfen eingehender und ausgehender Nachrichten. Der Skill ist auf Sicherheit ausgelegt: Account-SIDs, Auth-Tokens oder API-Secrets werden niemals protokolliert oder im Klartext ausgegeben. Stattdessen erfolgt die Credential-Verwaltung über den 1Password-OP-CLI, mit einem expliziten Routing-Mechanismus, der zuerst Twilio-Umgebungsvariablen, dann 1Password-Einträge prüft und bei Bedarf auf Desktop-gestützte Lesevorgänge zurückfällt. Die Nutzung erfolgt entweder über die `twilio-cli` (via npx) oder direkte REST-cURL-Aufrufe. Der Skill enthält klare Anweisungen zur Authentifizierung, zur Nummernsuche und zum Kauf, sowie zur Nachrichtenübermittlung und Statusabfrage. Besondere Hinweise zu internationalen SMS, US-Compliance (A2P/10DLC) und Testkonten runden die Funktionalität ab.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/twilio-sms

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Twilio SMS

Verwenden für Twilio-Telefonnummern und SMS-Arbeiten: Nummern erstellen/kaufen, eigene Nummern auflisten, Nummern behalten/beschriften, Texte senden sowie eingehende und ausgehende Nachrichten überprüfen.

Sicherheit

  • Gib niemals Account-SIDs, Auth-Tokens, API-Secrets, TOTP-Codes oder vollständige 1Password-Element-JSONs aus.
  • Speichere keine echten Telefonnummern, SIDs, Namen oder accountspezifischen Element-IDs in diesem Skill.
  • Verwende $one-password für das Lesen von Geheimnissen. op bleibt tmux-exklusiv.
  • Falls Desktop-1Password-Zugriff benötigt wird, entferne die Service-Account-Authentifizierung für diese Befehle: env -u OP_SERVICE_ACCOUNT_TOKEN op ....
  • Gib nur die Form der Credentials aus: Feld vorhanden, Länge, Präfixklasse falls nützlich.
  • Öffentliche Schreibvorgänge oder Logs: Vermeide das Preisgeben von Nachrichteninhalten, es sei denn, der Benutzer hat darum gebeten, SMS zu lesen/zu prüfen.

Credential-Route

  1. Überprüfe Twilio-CLI/Profil:
    • twilio --version oder npx -y twilio-cli --version
    • twilio profiles:list oder npx -y twilio-cli profiles:list
  2. Überprüfe nur die genaue Anwesenheit von Umgebungsvariablen:
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • optionale API-Key/Secret-Variablen
  3. Falls nur teilweise Umgebungsvariablen vorhanden sind, durchsuche zuerst 1Password-Metadaten.
  4. Bevorzuge ein Element mit Feldern, die Folgendem entsprechen:
    • TWILIO_ACCOUNT_SID
    • TWILIO_AUTH_TOKEN
    • optional TWILIO_FROM_NUMBER
  5. Falls op nur einen eingeschränkten Tresor sieht, wiederhole Desktop-gestützte Lesevorgänge mit env -u OP_SERVICE_ACCOUNT_TOKEN.
  6. Verifiziere die Authentifizierung vor jedem Kauf/Versand:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID.json"

CLI-Einrichtung

Die Erstellung eines Twilio-CLI-Profils erfordert das Account-Auth-Token, nicht nur API-Key-Credentials:

npx -y twilio-cli profiles:create "$TWILIO_ACCOUNT_SID" \
  --auth-token "$TWILIO_AUTH_TOKEN" \
  --profile default --force --silent
npx -y twilio-cli profiles:use default

Verwende npx -y twilio-cli, wenn twilio nicht installiert ist.

Nummern

Eigene Nummern auflisten:

npx -y twilio-cli api:core:incoming-phone-numbers:list \
  --properties phoneNumber,friendlyName,capabilities

US-lokale, SMS-fähige Bestände durchsuchen:

npx -y twilio-cli api:core:available-phone-numbers:local:list \
  --country-code US --sms-enabled --voice-enabled --limit 5

Falls die CLI-Form unhandlich ist oder Flags fehlen, verwende REST:

curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/AvailablePhoneNumbers/US/Local.json?SmsEnabled=true&VoiceEnabled=true&PageSize=5"

Einen Kandidaten kaufen:

curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
  -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \
  --data-urlencode "PhoneNumber=$PHONE_NUMBER"

Besitz/Fähigkeiten nach dem Kauf überprüfen. Twilio-JSON verwendet Kleinbuchstaben-Schlüssel:

capabilities.sms
capabilities.mms
capabilities.voice

Nummern, die der Benutzer behalten möchte, markieren:

npx -y twilio-cli api:core:incoming-phone-numbers:update \
  --sid "$PHONE_NUMBER_SID" \
  --friendly-name "KEEP - <zweck>"

Aufbewahrungsregel: Eine Nummer wird behalten, solange sie sich im Twilio-Konto befindet und die Abrechnung in Ordnung ist. Nicht freigeben/löschen, es sei denn, es wird ausdrücklich darum gebeten.

SMS

Senden:

npx -y twilio-cli api:core:messages:create \
  --from "$FROM_NUMBER" \
  --to "$TO_NUMBER" \
  --body "$BODY" \
  -o json

Status abrufen:

npx -y twilio-cli api:core:messages:fetch --sid "$MESSAGE_SID" -o json

Eingehende Nachrichten an eine Nummer prüfen:

npx -y twilio-cli api:core:messages:list \
  --to "$NUMBER" --limit 20 -o json

Ausgehende Nachrichten von einer Nummer prüfen:

npx -y twilio-cli api:core:messages:list \
  --from "$NUMBER" --limit 20 -o json

Das Twilio-CLI-JSON kann für Einzelressourcen-Befehle ein Array zurückgeben. Defensiv parsen:

jq 'if type=="array" then .[0] else . end'

Hinweise

  • Internationale SMS können einen alphanumerischen oder Carrier-Absender anstelle der gekauften US-Nummer anzeigen.
  • US-SMS kann compliance-technisch eingeschränkt sein. Falls das Senden an US-Empfänger fehlschlägt, überprüfe den A2P/10DLC-Registrierungsstatus, bevor du blind wiederholst.
  • Testkonten können die Empfänger einschränken.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Verwandte Skills