by team-telnyx
Official Telnyx skills for AI coding agents
# Add to your Claude Code skills
git clone https://github.com/team-telnyx/telnyx-skillsOfficial Agent Skills for building on Telnyx.
These skills give coding agents structured, up-to-date context to generate correct, production-ready code without relying on pre-training or fragile doc retrieval.
They include accurate schemas, SDK patterns, workflows, and API references, so agents can implement Telnyx APIs reliably in real-world applications.
Telnyx Agent Skills follow the Agent Skills specification and are compatible with coding agents like Claude Code, Cursor, Windsurf, and others.
[!NOTE] This repository is a work in progress under active development. Skills are being continuously improved based on testing and feedback, and updated to reflect the latest APIs and SDK patterns. Contributions and feedback encouraged!
Choose your setup:
Install a skill for your agent:
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent <AGENT>
Example:
No comments yet. Be the first to share your thoughts!
npx skills add team-telnyx/telnyx-skills --skill telnyx-voice-python --agent codex
A comprehensive list of available skills (values for <SKILL>) can be found in the Available Skills section.
A comprehensive list of supported agents (values for <AGENT>) can be found here.
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent codex
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent claude-code
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent cursor
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent openclaw
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent gemini-cli
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent github-copilot
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent opencode
Telnyx skills work with all agents supported by the Skills CLI.
Agents automatically use installed skills when generating code. No additional configuration required.
[!IMPORTANT] Use only the skills your project actually needs. Loading too many skills wastes tokens, dilutes context, and makes it easier for an agent to confuse SDK patterns.
Skills are organized by product and language. Each product skill is available in Curl, JavaScript, Python, Go, Java, and Ruby .
(Values in the "Skill" column in the tables below can be used for <SKILL>) in the install command. Append the language suffix to replace * , e.g. telnyx-voice-go :
npx skills add team-telnyx/telnyx-skills --skill <SKILL> --agent <AGENT>
Example:
npx skills add team-telnyx/telnyx-skills --skill telnyx-messaging-python --agent cursor
| Skill | Description |
|-------|-------------|
| telnyx-messaging-* | Send/receive SMS/MMS, manage messaging numbers, handle opt-outs |
| telnyx-messaging-profiles-* | Messaging profiles, number pools, short codes |
| telnyx-messaging-hosted-* | Hosted SMS numbers, toll-free verification, RCS |
| telnyx-10dlc-* | 10DLC brand/campaign registration for A2P compliance |
| Skill | Description |
|-------|-------------|
| telnyx-voice-* | Call control: dial, answer, hangup, transfer, bridge |
| telnyx-voice-media-* | Audio playback, text-to-speech, call recording |
| telnyx-voice-gather-* | DTMF/speech input collection, AI-powered gather |
| telnyx-voice-streaming-* | Real-time audio streaming, forking, transcription |
| telnyx-voice-conferencing-* | Conference calls, queues, multi-party sessions |
| telnyx-voice-advanced-* | DTMF sending, SIPREC, noise suppression, supervisor |
| telnyx-texml-* | TeXML (TwiML-compatible) voice applications |
| telnyx-sip-* | SIP trunking connections, outbound voice profiles |
| telnyx-sip-integrations-* | Call recordings, media storage, Dialogflow integration |
| telnyx-webrtc-* | WebRTC credentials and push notification setup (server-side — see Client SDKs for the calling UI) |
| Skill | Description |
|-------|-------------|
| telnyx-numbers-* | Search, order, and manage phone numbers |
| telnyx-numbers-config-* | Phone number configuration and settings |
| telnyx-numbers-compliance-* | Regulatory requirements, bundles, documents |
| telnyx-numbers-services-* | Voicemail, voice channels, E911 |
| telnyx-porting-in-* | Port numbers into Telnyx |
| telnyx-porting-out-* | Manage port-out requests |
| telnyx-verify-* | Phone verification, number lookup, 2FA |
| Skill | Description |
|-------|-------------|
| telnyx-ai-assistants-* | AI voice assistants with knowledge bases |
| telnyx-ai-inference-* | LLM inference, embeddings, AI analytics |
| telnyx-missions-* | Automated AI-driven workflows and tasks |
| Skill | Description |
|-------|-------------|
| telnyx-iot-* | IoT SIM cards, eSIMs, data plans |
| telnyx-networking-* | Private networks, VPN gateways |
| Skill | Description |
|-------|-------------|
| telnyx-storage-* | S3-compatible cloud storage |
| telnyx-video-* | Video rooms and conferencing |
| telnyx-fax-* | Programmable fax |
| telnyx-seti-* | Space Exploration Telecommunications Infrastructure |
| telnyx-oauth-* | OAuth 2.0 authentication flows |
| Skill | Description |
|-------|-------------|
| telnyx-account-* | Balance, payments, invoices, webhooks, audit logs |
| telnyx-account-access-* | Addresses, auth providers, IP access, billing groups |
| telnyx-account-management-* | Sub-account management (resellers) |
| telnyx-account-notifications-* | Notification channels and settings |
| telnyx-account-reports-* | Usage reports for billing and analytics |
The skills above cover server-side Telnyx APIs (REST calls from your backend). If you're building a calling app where users make or receive VoIP calls directly from a device, you also need the client-side WebRTC SDKs.
These are platform-specific native libraries — separate from the server-side language plugins:
| Skill | Platform | Language |
|-------|----------|----------|
| telnyx-webrtc-client-js | Browser | JavaScript |
| telnyx-webrtc-client-ios | iOS | Swift |
| telnyx-webrtc-client-android | Android | Kotlin |
| telnyx-webrtc-client-flutter | Flutter (Android/iOS/Web) | Dart |
| telnyx-webrtc-client-react-native | React Native (Android/iOS) | TypeScript |
Each skill covers authentication, making/receiving calls, call controls (hold, mute, transfer), push notifications, call quality metrics, and AI Agent integration.
Note: Building a calling app typically requires multiple skills — a server-side plugin (e.g.
telnyx-voice-python) to create WebRTC credentials and generate login tokens, andtelnyx-webrtc-client-Xfor the client-side calling UI.
A comprehensive 6-phase orchestrated agent workflow for moving apps from Twilio to Telnyx across all product areas.
npx skills add team-telnyx/telnyx-skills --skill telnyx-twilio-migration --agent <AGENT>
What's covered:
| Area | Description |
|------|-------------|
| Voice (TwiML → TeXML + Call Control) | Near drop-in XML compatibility (15 verbs, 8 nouns) plus Call Control API for real-time call manipulation |
| Messaging (SMS/MMS) | Parameter mapping, messaging profiles, 10DLC registration |
| WebRTC / Client SDKs | Architecture differences, endpoint migration, mobile SDK guides (iOS, Android, Flutter, React Native) |
| Number Porting | FastPort API for same-day US/Canada activation |
| Verify (2FA) | SMS, voice, flash calling, and PSD2 verification |
| SIP Trunking | Connection setup, credential auth, FQDN migration |
| Fax / IoT / Video | Product-specific migration guides with API mapping |
| Lookup | Number lookup and carrier data migration |
| Universal Changes | Auth (Basic → Bearer), webhook signatures (HMAC-SHA1 → Ed25519), client.webhooks.unwrap() verification |
6-phase orchestrated workflow — Discovery → Planning → Core Migration → Webhook/Auth → Testing → Validation → Cleanup — with automated scripts:
| Script | Purpose |
|--------|---------|
| preflight-check.sh | Pre-migration environment and dependency validation |
| scan-twilio-usage.sh | Detect all Twilio usage across the codebase |
| lint-telnyx-correctness.sh | Static analysis for common Telnyx SDK mistakes |
| validate-migration.sh | Post-migration validation (webhooks, env vars, API patterns) |
| smoke-test.sh | Runtime smoke tests against the live Telnyx API |
| test-*.sh | Product-specific integration tests (messaging, voice, verify, SIP, WebRTC, fax, lookup) |
Includes parameter-by-parameter mapping tables, multi-language code examples (Python, Node, Go, Java, Ruby, curl), error code mapping, and migration plan/report templates.
Note: After migrating, install a language plugin (e.g.
telnyx-python) for deeper SDK examples, andtelnyx-webrtc-clientif building