Let your AI coding assistant write Telnyx integrations. Install once, then describe what you want to build in plain English.
Developers spend 35% of their time reading documentation. Another 20% goes to debugging code they didn't write. When you're integrating a new API, that ratio gets worse: you're constantly switching between docs, code samples, and your editor, trying to piece together the right authentication flow or webhook handler.
AI coding assistants changed this. According to the 2025 Stack Overflow Developer Survey, 84% of developers now use AI tools in their workflow, and 69% report increased productivity when using AI agents. The AI code assistant market hit $3.9 billion in 2025 and is growing at 24% annually.
But AI assistants still have a knowledge problem. They can write generic code, but they don't know the specifics of your APIs. They search the web for code examples but sometimes find outdated or incorrect ones, leading them to hallucinate method names, invent authentication patterns, and produce code that looks right but fails at runtime.
That's why we built Telnyx Agent Skills: plugins that give AI coding assistants deep, accurate knowledge of every Telnyx SDK. Install them once, then describe what you want to build. Your AI writes production code that actually works.
Agent skills are plugins for AI coding assistants like Claude Code, Cursor, Windsurf, and other compatible agents. They teach the AI how to correctly use the Telnyx SDKs.
These are official skills for AI coding agents to integrate Telnyx APIs using the native SDKs. They follow the Agent Skills specification and are organized by product and language. Each skill teaches an AI agent how to use Telnyx SDKs correctly with code examples generated from the official OpenAPI specifications.
When you install Telnyx Agent Skills, your AI gains access to:
Instead of reading docs yourself, you describe what you want. The AI reads the docs and writes production-ready code with proper error handling, retries, and validation.
First, add the Telnyx skills marketplace:
/plugin marketplace add team-telnyx/skills
Then install the plugin for your language. Each plugin includes all 36 Telnyx products (messaging, voice, numbers, IoT, AI, and more):
Python:
/plugin install telnyx-python@skills
JavaScript / Node.js:
/plugin install telnyx-javascript@skills
Go:
/plugin install telnyx-go@skills
Java:
/plugin install telnyx-java@skills
Ruby:
/plugin install telnyx-ruby@skills
WebRTC Client SDKs (all platforms):
/plugin install telnyx-webrtc-client@skills
Twilio Migration:
/plugin install telnyx-twilio-migration@skills
Telnyx CLI:
/plugin install telnyx-cli@skills
Import Voice AI (from Vapi, Retell, ElevenLabs):
/plugin install telnyx-import-voice-ai@skills
Add Telnyx skills as project context by referencing the raw SKILL.md files from GitHub:
.cursor/rules/telnyx.mdc) and paste the contents of the desired SKILL.md fileSKILL.md file into your project and add it via @Files in the chatAdd skills to Windsurf via project rules:
.windsurfrules file in your project rootSKILL.md file(s) into itNow try a prompt like: "Create a function that sends an SMS notification when an order ships."
Claude will generate complete, working code that authenticates with your Telnyx API key, validates phone number formats, handles API errors gracefully, and includes retry logic for transient failures.
The skills cover all 36 Telnyx products. Here are some prompts to try:
Let's walk through a real example. Say you want to send SMS notifications when orders ship from your e-commerce platform.
Your prompt:
"Create a Python function that sends an SMS notification when an order ships. It should take the customer's phone number, order ID, and tracking URL as parameters. Include proper error handling and logging."
What Claude generates:
import telnyx
import logging
from typing import Optional
logger = logging.getLogger(__name__)
def send_shipping_notification(
phone_number: str,
order_id: str,
tracking_url: str,
from_number: str = "+18005551234"
) -> Optional[str]:
"""
Send an SMS notification when an order ships.
Returns the message SID on success, None on failure.
"""
try:
message = telnyx.Message.create(
from_=from_number,
to=phone_number,
text=f"Your order #{order_id} has shipped! "
f"Track it here: {tracking_url}"
)
logger.info(f"Sent shipping notification for order {order_id}")
return message.id
except telnyx.error.InvalidRequestError as e:
logger.error(f"Invalid request: {e}")
return None
except telnyx.error.AuthenticationError as e:
logger.error(f"Authentication failed: {e}")
return None
except telnyx.error.APIError as e:
logger.error(f"API error: {e}")
return None
Notice how Claude:
This is production code, not a tutorial snippet. You can deploy it immediately.
We also offer a Telnyx MCP Server for AI assistants like Claude Desktop. Here's how they differ:
| Feature | Agent Skills | MCP Server |
|---|---|---|
| Primary use | Write code that uses Telnyx | Execute Telnyx actions directly |
| Output | Source code files | API calls and results |
| Best for | Building applications | Quick tasks and automation |
| Example | "Write an SMS webhook handler" | "Send an SMS to +15551234567" |
Use Agent Skills when you're building an application and need source code. Use the MCP Server when you want to execute Telnyx operations directly from Claude Desktop without writing code.
The numbers tell the story:
But these gains only happen when the AI has accurate, up-to-date information about your APIs. Generic AI assistants hallucinate SDK methods, invent authentication flows, and produce code that fails at runtime. Agent skills solve this by giving the AI direct access to verified documentation.
Telnyx Agent Skills cover the full platform:
Agent Skills are open source and free to use. The GitHub repository includes skills for Python, JavaScript, Go, Java, and Ruby.
Install them now and start building with natural language.
Related articles