Skip to content

team-telnyx/ai / providers/claude/plugins/telnyx-platform/skills/telnyx-twilio-migration

telnyx-twilio-migration

Unverified

Migrate from Twilio to Telnyx. Orchestrates a complete 6-phase migration: discovery, planning, setup, code migration, validation, and cleanup. Covers voice (TwiML to TeXML, Call Control API), messaging, WebRTC, SIP trunking, verify, fax, video, IoT, number lookup, and porting. Includes automated scanners, validation scripts, and integration tests.

FileKindSize
SKILL.mdskill md43.3 KB
references/account-setup-guide.mdmarkdown17.8 KB
references/error-code-mapping.mdmarkdown11.0 KB
references/fax-migration.mdmarkdown14.7 KB
references/iot-migration.mdmarkdown17.9 KB
references/lookup-migration.mdmarkdown14.3 KB
references/messaging-migration.mdmarkdown36.5 KB
references/mobile-sdk-migration.mdmarkdown38.6 KB
references/number-porting.mdmarkdown17.0 KB
references/numbers-migration.mdmarkdown21.1 KB
references/product-mapping.mdmarkdown6.7 KB
references/sdk-api-details/10dlc.mdmarkdown9.8 KB
references/sdk-api-details/ai-assistants.mdmarkdown5.8 KB
references/sdk-api-details/messaging.mdmarkdown16.1 KB
references/sdk-api-details/numbers.mdmarkdown10.1 KB
references/sdk-api-details/voice.mdmarkdown9.6 KB
references/sip-trunking-migration.mdmarkdown18.1 KB
references/texml-verbs.mdmarkdown43.7 KB
references/unsupported-products.mdmarkdown3.5 KB
references/verify-migration.mdmarkdown18.4 KB
references/video-migration.mdmarkdown20.6 KB
references/voice-migration.mdmarkdown37.2 KB
references/webhook-migration.mdmarkdown20.3 KB
references/webrtc-migration.mdmarkdown50.0 KB
scripts/lint-telnyx-correctness.shexecutablescript31.4 KB
scripts/migration-state.shexecutablescript7.3 KB
scripts/post-test-diagnostic.shexecutablescript18.9 KB
scripts/preflight-check.shexecutablescript13.4 KB
scripts/run-discovery.shexecutablescript7.7 KB
scripts/run-validation.shexecutablescript13.1 KB
scripts/scan-twilio-deep.pyexecutablescript64.8 KB
scripts/scan-twilio-usage.shexecutablescript29.1 KB
scripts/test-migration/smoke-test.shexecutablescript10.0 KB
scripts/test-migration/test-fax.shexecutablescript8.7 KB
scripts/test-migration/test-lookup.shexecutablescript5.5 KB
scripts/test-migration/test-messaging.shexecutablescript18.8 KB
scripts/test-migration/test-sip.shexecutablescript29.6 KB
scripts/test-migration/test-verify.shexecutablescript13.6 KB
scripts/test-migration/test-voice.shexecutablescript22.4 KB
scripts/test-migration/test-webhooks-local.pyexecutablescript9.7 KB
scripts/test-migration/test-webrtc.shexecutablescript24.0 KB
scripts/test-migration/webhook-receiver.pyexecutablescript11.8 KB
scripts/validate-migration.shexecutablescript31.1 KB
scripts/validate-texml.shexecutablescript61.4 KB
sdk-reference/curl/10dlc.mdmarkdown25.8 KB
sdk-reference/curl/account-access.mdmarkdown15.6 KB
sdk-reference/curl/account-management.mdmarkdown9.5 KB
sdk-reference/curl/account-notifications.mdmarkdown11.0 KB
sdk-reference/curl/account-reports.mdmarkdown45.5 KB
sdk-reference/curl/account.mdmarkdown8.1 KB
sdk-reference/curl/ai-assistants.mdmarkdown34.3 KB
sdk-reference/curl/ai-inference.mdmarkdown34.5 KB
sdk-reference/curl/fax.mdmarkdown19.8 KB
sdk-reference/curl/iot.mdmarkdown49.4 KB
sdk-reference/curl/messaging-hosted.mdmarkdown23.3 KB
sdk-reference/curl/messaging-profiles.mdmarkdown14.2 KB
sdk-reference/curl/messaging.mdmarkdown29.1 KB
sdk-reference/curl/missions.mdmarkdown23.5 KB
sdk-reference/curl/networking.mdmarkdown39.8 KB
sdk-reference/curl/numbers-compliance.mdmarkdown30.2 KB
sdk-reference/curl/numbers-config.mdmarkdown29.7 KB
sdk-reference/curl/numbers-services.mdmarkdown12.6 KB
sdk-reference/curl/numbers.mdmarkdown24.0 KB
sdk-reference/curl/oauth.mdmarkdown15.6 KB
sdk-reference/curl/porting-in.mdmarkdown35.1 KB
sdk-reference/curl/porting-out.mdmarkdown9.8 KB
sdk-reference/curl/sip-integrations.mdmarkdown27.5 KB
sdk-reference/curl/sip.mdmarkdown47.6 KB
sdk-reference/curl/storage.mdmarkdown4.2 KB
sdk-reference/curl/texml.mdmarkdown31.4 KB
sdk-reference/curl/verify.mdmarkdown13.2 KB
sdk-reference/curl/video.mdmarkdown17.2 KB
sdk-reference/curl/voice-advanced.mdmarkdown32.8 KB
sdk-reference/curl/voice-conferencing.mdmarkdown41.6 KB
sdk-reference/curl/voice-gather.mdmarkdown14.7 KB
sdk-reference/curl/voice-media.mdmarkdown17.8 KB
sdk-reference/curl/voice-streaming.mdmarkdown13.3 KB
sdk-reference/curl/voice.mdmarkdown37.6 KB
sdk-reference/curl/webrtc.mdmarkdown6.5 KB
sdk-reference/go/10dlc.mdmarkdown29.0 KB
sdk-reference/go/account-access.mdmarkdown17.0 KB
sdk-reference/go/account-management.mdmarkdown9.9 KB
sdk-reference/go/account-notifications.mdmarkdown12.4 KB
sdk-reference/go/account-reports.mdmarkdown31.5 KB
sdk-reference/go/account.mdmarkdown9.1 KB
sdk-reference/go/ai-assistants.mdmarkdown37.7 KB
sdk-reference/go/ai-inference.mdmarkdown27.1 KB
sdk-reference/go/fax.mdmarkdown20.2 KB
sdk-reference/go/iot.mdmarkdown51.3 KB
sdk-reference/go/messaging-hosted.mdmarkdown24.5 KB
sdk-reference/go/messaging-profiles.mdmarkdown15.2 KB
sdk-reference/go/messaging.mdmarkdown30.1 KB
sdk-reference/go/missions.mdmarkdown26.9 KB
sdk-reference/go/networking.mdmarkdown42.5 KB
sdk-reference/go/numbers-compliance.mdmarkdown28.2 KB
sdk-reference/go/numbers-config.mdmarkdown29.5 KB
sdk-reference/go/numbers-services.mdmarkdown14.1 KB
sdk-reference/go/numbers.mdmarkdown26.7 KB
sdk-reference/go/oauth.mdmarkdown11.7 KB
sdk-reference/go/porting-in.mdmarkdown41.1 KB
sdk-reference/go/porting-out.mdmarkdown10.9 KB
sdk-reference/go/sip-integrations.mdmarkdown32.3 KB
sdk-reference/go/sip.mdmarkdown49.1 KB
sdk-reference/go/storage.mdmarkdown4.8 KB
sdk-reference/go/texml.mdmarkdown35.7 KB
sdk-reference/go/verify.mdmarkdown14.4 KB
sdk-reference/go/video.mdmarkdown18.6 KB
sdk-reference/go/voice-advanced.mdmarkdown33.2 KB
sdk-reference/go/voice-conferencing.mdmarkdown42.3 KB
sdk-reference/go/voice-gather.mdmarkdown14.5 KB
sdk-reference/go/voice-media.mdmarkdown18.1 KB
sdk-reference/go/voice-streaming.mdmarkdown13.5 KB
sdk-reference/go/voice.mdmarkdown39.2 KB
sdk-reference/go/webrtc.mdmarkdown7.5 KB
sdk-reference/java/10dlc.mdmarkdown31.3 KB
sdk-reference/java/account-access.mdmarkdown18.5 KB
sdk-reference/java/account-management.mdmarkdown11.1 KB
sdk-reference/java/account-notifications.mdmarkdown14.3 KB
sdk-reference/java/account-reports.mdmarkdown36.5 KB
sdk-reference/java/account.mdmarkdown10.3 KB
sdk-reference/java/ai-assistants.mdmarkdown39.2 KB
sdk-reference/java/ai-inference.mdmarkdown30.7 KB
sdk-reference/java/fax.mdmarkdown21.5 KB
sdk-reference/java/iot.mdmarkdown57.5 KB
sdk-reference/java/messaging-hosted.mdmarkdown28.4 KB
sdk-reference/java/messaging-profiles.mdmarkdown15.7 KB
sdk-reference/java/messaging.mdmarkdown32.2 KB
sdk-reference/java/missions.mdmarkdown31.6 KB
sdk-reference/java/networking.mdmarkdown47.1 KB
sdk-reference/java/numbers-compliance.mdmarkdown31.1 KB
sdk-reference/java/numbers-config.mdmarkdown32.2 KB
sdk-reference/java/numbers-services.mdmarkdown15.9 KB
sdk-reference/java/numbers.mdmarkdown28.4 KB
sdk-reference/java/oauth.mdmarkdown13.0 KB
sdk-reference/java/porting-in.mdmarkdown46.2 KB
sdk-reference/java/porting-out.mdmarkdown11.9 KB
sdk-reference/java/sip-integrations.mdmarkdown38.1 KB
sdk-reference/java/sip.mdmarkdown51.9 KB
sdk-reference/java/storage.mdmarkdown5.7 KB
sdk-reference/java/texml.mdmarkdown41.3 KB
sdk-reference/java/verify.mdmarkdown16.0 KB
sdk-reference/java/video.mdmarkdown20.3 KB
sdk-reference/java/voice-advanced.mdmarkdown35.0 KB
sdk-reference/java/voice-conferencing.mdmarkdown46.0 KB
sdk-reference/java/voice-gather.mdmarkdown16.1 KB
sdk-reference/java/voice-media.mdmarkdown19.5 KB
sdk-reference/java/voice-streaming.mdmarkdown14.7 KB
sdk-reference/java/voice.mdmarkdown40.8 KB
sdk-reference/java/webrtc.mdmarkdown8.5 KB
sdk-reference/javascript/10dlc.mdmarkdown28.5 KB
sdk-reference/javascript/account-access.mdmarkdown15.9 KB
sdk-reference/javascript/account-management.mdmarkdown9.6 KB
sdk-reference/javascript/account-notifications.mdmarkdown11.7 KB
sdk-reference/javascript/account-reports.mdmarkdown29.3 KB
sdk-reference/javascript/account.mdmarkdown8.7 KB
sdk-reference/javascript/ai-assistants.mdmarkdown37.5 KB
sdk-reference/javascript/ai-inference.mdmarkdown24.4 KB
sdk-reference/javascript/fax.mdmarkdown19.9 KB
sdk-reference/javascript/iot.mdmarkdown47.4 KB
sdk-reference/javascript/messaging-hosted.mdmarkdown22.4 KB
sdk-reference/javascript/messaging-profiles.mdmarkdown14.8 KB
sdk-reference/javascript/messaging.mdmarkdown29.7 KB
sdk-reference/javascript/missions.mdmarkdown23.8 KB
sdk-reference/javascript/networking.mdmarkdown39.3 KB
sdk-reference/javascript/numbers-compliance.mdmarkdown25.9 KB
sdk-reference/javascript/numbers-config.mdmarkdown28.3 KB
sdk-reference/javascript/numbers-services.mdmarkdown13.0 KB
sdk-reference/javascript/numbers.mdmarkdown26.1 KB
sdk-reference/javascript/oauth.mdmarkdown10.8 KB
sdk-reference/javascript/porting-in.mdmarkdown37.4 KB
sdk-reference/javascript/porting-out.mdmarkdown10.2 KB
sdk-reference/javascript/sip-integrations.mdmarkdown28.5 KB
sdk-reference/javascript/sip.mdmarkdown47.4 KB
sdk-reference/javascript/storage.mdmarkdown4.5 KB
sdk-reference/javascript/texml.mdmarkdown31.9 KB
sdk-reference/javascript/verify.mdmarkdown13.3 KB
sdk-reference/javascript/video.mdmarkdown17.2 KB
sdk-reference/javascript/voice-advanced.mdmarkdown32.6 KB
sdk-reference/javascript/voice-conferencing.mdmarkdown40.4 KB
sdk-reference/javascript/voice-gather.mdmarkdown14.3 KB
sdk-reference/javascript/voice-media.mdmarkdown17.8 KB
sdk-reference/javascript/voice-streaming.mdmarkdown13.4 KB
sdk-reference/javascript/voice.mdmarkdown39.4 KB
sdk-reference/javascript/webrtc.mdmarkdown7.2 KB
sdk-reference/python/10dlc.mdmarkdown28.5 KB
sdk-reference/python/account-access.mdmarkdown15.0 KB
sdk-reference/python/account-management.mdmarkdown9.1 KB
sdk-reference/python/account-notifications.mdmarkdown10.9 KB
sdk-reference/python/account-reports.mdmarkdown28.1 KB
sdk-reference/python/account.mdmarkdown8.1 KB
sdk-reference/python/ai-assistants.mdmarkdown37.3 KB
sdk-reference/python/ai-inference.mdmarkdown23.4 KB
sdk-reference/python/fax.mdmarkdown19.5 KB
sdk-reference/python/iot.mdmarkdown45.3 KB
sdk-reference/python/messaging-hosted.mdmarkdown21.7 KB
sdk-reference/python/messaging-profiles.mdmarkdown14.1 KB
sdk-reference/python/messaging.mdmarkdown29.4 KB
sdk-reference/python/missions.mdmarkdown23.2 KB
sdk-reference/python/networking.mdmarkdown37.1 KB
sdk-reference/python/numbers-compliance.mdmarkdown24.6 KB

scripts/migration-state.sh

View on GitHub
#!/usr/bin/env bash
# migration-state.sh — Read/write/update migration-state.json
# Tracks: current phase, resource IDs, completed products, migrated files, commit SHAs
#
# Usage:
#   migration-state.sh init <project-root>          — Create fresh state file
#   migration-state.sh get <project-root> <key>     — Read a value (dot-notation: resources.messaging_profile_id)
#   migration-state.sh set <project-root> <key> <value> — Set a value
#   migration-state.sh add-product <project-root> <product> — Mark product as completed
#   migration-state.sh add-file <project-root> <product> <file> — Track migrated file
#   migration-state.sh set-phase <project-root> <phase> — Update current phase (0-6)
#   migration-state.sh set-commit <project-root> <phase> — Record current HEAD as phase commit
#   migration-state.sh show <project-root>          — Pretty-print current state
#   migration-state.sh status <project-root>        — One-line status summary

set -euo pipefail

STATE_FILE="migration-state.json"

die() { echo "ERROR: $*" >&2; exit 1; }

state_path() {
  local root="$1"
  echo "${root%/}/$STATE_FILE"
}

ensure_jq() {
  command -v jq >/dev/null 2>&1 || die "jq is required. Install: brew install jq / apt-get install jq"
}

cmd_init() {
  local root="${1:?Usage: migration-state.sh init <project-root>}"
  local path
  path=$(state_path "$root")

  if [[ -f "$path" ]]; then
    echo "State file already exists at $path"
    echo "Use 'set' commands to update, or delete the file to reinitialize."
    return 0
  fi

  cat > "$path" <<'TEMPLATE'
{
  "version": 1,
  "current_phase": 0,
  "started_at": "",
  "updated_at": "",
  "resources": {
    "messaging_profile_id": null,
    "voice_connection_id": null,
    "verify_profile_id": null,
    "texml_app_id": null,
    "sip_connection_id": null,
    "fax_app_id": null
  },
  "completed_products": [],
  "migrated_files": {},
  "phase_commits": {},
  "scan_file": null,
  "migration_plan_file": null,
  "notes": []
}
TEMPLATE

  # Set timestamps
  local now
  now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
  local tmp
  tmp=$(jq --arg t "$now" '.started_at = $t | .updated_at = $t' "$path")
  echo "$tmp" > "$path"

  echo "Initialized migration state at $path"
}

cmd_get() {
  local root="${1:?Usage: migration-state.sh get <project-root> <key>}"
  local key="${2:?Usage: migration-state.sh get <project-root> <key>}"
  local path
  path=$(state_path "$root")
  [[ -f "$path" ]] || die "No state file at $path — run 'init' first"

  jq -r ".$key // empty" "$path"
}

cmd_set() {
  local root="${1:?Usage: migration-state.sh set <project-root> <key> <value>}"
  local key="${2:?}"
  local value="${3:?}"
  local path
  path=$(state_path "$root")
  [[ -f "$path" ]] || die "No state file at $path — run 'init' first"

  local now
  now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")

  # Determine if value is a number, boolean, null, or string
  local tmp
  if [[ "$value" =~ ^[0-9]+$ ]] || [[ "$value" == "true" ]] || [[ "$value" == "false" ]] || [[ "$value" == "null" ]]; then
    tmp=$(jq --arg t "$now" ".$key = $value | .updated_at = \$t" "$path")
  else
    tmp=$(jq --arg t "$now" --arg v "$value" ".$key = \$v | .updated_at = \$t" "$path")
  fi
  echo "$tmp" > "$path"
  echo "Set $key = $value"
}

cmd_add_product() {
  local root="${1:?Usage: migration-state.sh add-product <project-root> <product>}"
  local product="${2:?}"
  local path
  path=$(state_path "$root")
  [[ -f "$path" ]] || die "No state file at $path — run 'init' first"

  local now
  now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
  local tmp
  tmp=$(jq --arg t "$now" --arg p "$product" \
    'if (.completed_products | index($p)) then . else .completed_products += [$p] end | .updated_at = $t' \
    "$path")
  echo "$tmp" > "$path"
  echo "Marked product '$product' as completed"
}

cmd_add_file() {
  local root="${1:?Usage: migration-state.sh add-file <project-root> <product> <file>}"
  local product="${2:?}"
  local file="${3:?}"
  local path
  path=$(state_path "$root")
  [[ -f "$path" ]] || die "No state file at $path — run 'init' first"

  local now
  now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
  local tmp
  tmp=$(jq --arg t "$now" --arg p "$product" --arg f "$file" \
    '.migrated_files[$p] = ((.migrated_files[$p] // []) + [$f] | unique) | .updated_at = $t' \
    "$path")
  echo "$tmp" > "$path"
  echo "Tracked file '$file' under product '$product'"
}

cmd_set_phase() {
  local root="${1:?Usage: migration-state.sh set-phase <project-root> <phase>}"
  local phase="${2:?}"
  local path
  path=$(state_path "$root")
  [[ -f "$path" ]] || die "No state file at $path — run 'init' first"

  [[ "$phase" =~ ^[0-6]$ ]] || die "Phase must be 0-6, got: $phase"

  local now
  now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
  local tmp
  tmp=$(jq --arg t "$now" ".current_phase = $phase | .updated_at = \$t" "$path")
  echo "$tmp" > "$path"
  echo "Phase updated to $phase"
}

cmd_set_commit() {
  local root="${1:?Usage: migration-state.sh set-commit <project-root> <phase>}"
  local phase="${2:?}"
  local path
  path=$(state_path "$root")
  [[ -f "$path" ]] || die "No state file at $path — run 'init' first"

  local sha
  sha=$(cd "$root" && git rev-parse --short HEAD 2>/dev/null || echo "unknown")

  local now
  now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
  local tmp
  tmp=$(jq --arg t "$now" --arg p "phase_$phase" --arg s "$sha" \
    '.phase_commits[$p] = $s | .updated_at = $t' "$path")
  echo "$tmp" > "$path"
  echo "Recorded commit $sha for phase $phase"
}

cmd_show() {
  local root="${1:?Usage: migration-state.sh show <project-root>}"
  local path
  path=$(state_path "$root")
  [[ -f "$path" ]] || die "No state file at $path — run 'init' first"

  jq '.' "$path"
}

cmd_status() {
  local root="${1:?Usage: migration-state.sh status <project-root>}"
  local path
  path=$(state_path "$root")
  [[ -f "$path" ]] || { echo "No migration state — run 'migration-state.sh init <root>' to start"; return 0; }

  local phase products file_count
  phase=$(jq -r '.current_phase' "$path")
  products=$(jq -r '.completed_products | join(", ")' "$path")
  file_count=$(jq '[.migrated_files[] | length] | add // 0' "$path")

  echo "Phase $phase/6 | Products done: ${products:-none} | Files migrated: $file_count"
}

# Main dispatch
ensure_jq

case "${1:-}" in
  init)       shift; cmd_init "$@" ;;
  get)        shift; cmd_get "$@" ;;
  set)        shift; cmd_set "$@" ;;
  add-product) shift; cmd_add_product "$@" ;;
  add-file)   shift; cmd_add_file "$@" ;;
  set-phase)  shift; cmd_set_phase "$@" ;;
  set-commit) shift; cmd_set_commit "$@" ;;
  show)       shift; cmd_show "$@" ;;
  status)     shift; cmd_status "$@" ;;
  *)
    echo "Usage: migration-state.sh <command> <project-root> [args...]"
    echo ""
    echo "Commands:"
    echo "  init <root>                    Create fresh migration-state.json"
    echo "  get <root> <key>               Read value (dot-notation: resources.messaging_profile_id)"
    echo "  set <root> <key> <value>       Set a value"
    echo "  add-product <root> <product>   Mark product as completed"
    echo "  add-file <root> <product> <file>  Track migrated file"
    echo "  set-phase <root> <phase>       Update current phase (0-6)"
    echo "  set-commit <root> <phase>      Record current HEAD as phase commit"
    echo "  show <root>                    Pretty-print state"
    echo "  status <root>                  One-line summary"
    exit 1
    ;;
esac
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall