Official 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!
- Installation Quickstart
- Skills CLI installation
- Claude Code plugins installation
- Telnyx API and SDKs
- WebRTC client SDKs
- Twilio Migration
Choose your setup:
Install a skill for your agent:
npx skills add team-telnyx/skills --skill <SKILL> --agent <AGENT>Example:
npx skills add team-telnyx/skills --skill telnyx-voice-python --agent codexA 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/skills --skill <SKILL> --agent codexnpx skills add team-telnyx/skills --skill <SKILL> --agent claude-codenpx skills add team-telnyx/skills --skill <SKILL> --agent cursornpx skills add team-telnyx/skills --skill <SKILL> --agent openclawnpx skills add team-telnyx/skills --skill <SKILL> --agent gemini-clinpx skills add team-telnyx/skills --skill <SKILL> --agent github-copilotnpx skills add team-telnyx/skills --skill <SKILL> --agent opencodeTelnyx skills work with all agents supported by the Skills CLI.
See full list of supported agents
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/skills --skill <SKILL> --agent <AGENT>Example:
npx skills add team-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/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 a calling app.
Plugins are installable packages containing curated bundles of related Telnyx Agent skills. Install with Claude Code marketplace:
Step 1. Add the Telnyx skills marketplace (one-time setup):
/plugin marketplace add team-telnyx/skillsStep 2. Install a plugin — pick a plugin from table below:
/plugin install <PLUGIN>@skillsReplace <PLUGIN> with the plugin from the table below:
Examples:
/plugin install telnyx-python@skills
/plugin install telnyx-twilio-migration@skills| Plugin | Language |
|---|---|
telnyx-curl |
curl (REST API) |
telnyx-go |
Go |
telnyx-java |
Java |
telnyx-javascript |
JavaScript / Node.js |
telnyx-python |
Python |
telnyx-ruby |
Ruby |
telnyx-webrtc-client |
WebRTC client SDKs (JS, iOS, Android, Flutter, React Native) |
telnyx-twilio-migration |
Migrate from Twilio to Telnyx |
telnyx-cli |
Telnyx CLI |
Each language plugin includes all 36 Telnyx products (messaging, voice, numbers, IoT, AI, and more).
The WebRTC client plugin covers building VoIP calling apps — see WebRTC Client SDKs for details.
The Twilio Migration plugin is a comprehensive 6-phase orchestrated agent workflow for moving apps from Twilio to Telnyx across all product areas — see Twilio Migration for details.
Each skill contains a single SKILL.md file with YAML frontmatter, SDK installation instructions, client setup, code examples for every API operation, and webhook event reference tables where applicable. All code examples are generated from the official Telnyx OpenAPI specifications.
The canonical artifact format is:
SKILL.mdreferences/api-details.mdwhen overflow API detail is needed
Note: Skill generation and publishing logic live in the separate internal repository. If you discover an error, please open an issue on this repo describing the problem.
git clone https://github.com/team-telnyx/skills.git
# Copy the skill into your agent's skills directory
mkdir -p .github/skills
# Example:
cp -r telnyx-skills/telnyx-python/skills/telnyx-messaging-python .github/skills/We welcome contributions! Please see CONTRIBUTING.md for guidelines.
For issues with these skills, please open an issue in this repository.
For Telnyx API support, visit support.telnyx.com.
MIT License - see LICENSE for details.
Maintained by @aisling404 (Telnyx)