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

Voice & Communications

Numbers

AI

IoT & Networking

Other

Account

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:

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:

6-phase orchestrated workflow — Discovery → Planning → Core Migration → Webhook/Auth → Testing → Validation → Cleanup — with automated scripts:

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

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)