Telnyx Agent Skills

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!

Table of contents

• Installation Quickstart
• Skills CLI installation
• Claude Code plugins installation
• Telnyx API and SDKs
• WebRTC client SDKs
• Twilio Migration

Installation Quickstart

Choose your setup:

• Skills CLI (Codex, Cursor, etc.)
• Claude Code plugins

Skills CLI installation

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 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.

Codex

npx skills add team-telnyx/skills --skill <SKILL> --agent codex

Claude Code

npx skills add team-telnyx/skills --skill <SKILL> --agent claude-code

Cursor

npx skills add team-telnyx/skills --skill <SKILL> --agent cursor

OpenClaw

npx skills add team-telnyx/skills --skill <SKILL> --agent openclaw

Gemini CLI

npx skills add team-telnyx/skills --skill <SKILL> --agent gemini-cli

GitHub Copilot

npx skills add team-telnyx/skills --skill <SKILL> --agent github-copilot

OpenCode

npx skills add team-telnyx/skills --skill <SKILL> --agent opencode

Other supported agents

Telnyx 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.

Available Skills

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

Messaging

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

Voice & Communications

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)

Numbers

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

AI

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

IoT & Networking

Skill	Description
telnyx-iot-*	IoT SIM cards, eSIMs, data plans
telnyx-networking-*	Private networks, VPN gateways

Other

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

Account

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

WebRTC Client SDKs

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, and telnyx-webrtc-client-X for the client-side calling UI.

Twilio Migration

A comprehensive 6-phase orchestrated agent workflow for moving apps from Twilio to Telnyx across all product areas.

Install command:

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, and telnyx-webrtc-client if building a calling app.

Install Claude Code Plugins

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/skills

Step 2. Install a plugin — pick a plugin from table below:

/plugin install <PLUGIN>@skills

Replace <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.

Skill Structure

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.md
• references/api-details.md when 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.

Alternative (manual) skill installation - clone and copy specific skills

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/

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Support

For issues with these skills, please open an issue in this repository.

For Telnyx API support, visit support.telnyx.com.

License

MIT License - see LICENSE for details.

Maintained by @aisling404 (Telnyx)