--- title: Build Telnyx apps faster with AI agent skills | Telnyx canonical: https://telnyx.com/resources/ai-agent-skills-claude-code --- # Build Telnyx apps faster with AI agent skills | Telnyx [Back to blog](https://telnyx.com/resources) **Conversational AI** # Build Telnyx apps faster with AI agent skills Let your AI coding assistant write Telnyx integrations. Install once, then describe what you want to build in plain English. By [Deniz Yakışıklı](https://telnyx.com/authors/deniz-yakisikli) 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](https://survey.stackoverflow.co/2025/ai), 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. ## What are agent skills? [Agent skills](https://github.com/team-telnyx/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 area so your agent only loads the skills it needs. 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: * Full SDK reference for Python, JavaScript, Go, Java, and Ruby * Code examples for all Telnyx products, split by product area * Authentication setup and error handling patterns * Webhook configuration examples * Best practices for production deployments 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, validation, and support for [runtime monitoring](https://www.hud.io/blog/runtime-monitoring/) once the integration is deployed. ## Quick start: install in 30 seconds **📦 Get the skills on GitHub: [github.com/team-telnyx/skills](https://github.com/team-telnyx/skills)** ### Claude Code First, add the Telnyx marketplace (one-time setup): /plugin marketplace add team-telnyx/ai Then install the plugins for the products you're building with. Plugins are split by product area so your agent only loads the skills it needs: /plugin install telnyx-messaging@telnyx # SMS / MMS /plugin install telnyx-voice@telnyx # Voice API (call control, AMD, recording, etc.) /plugin install telnyx-whatsapp@telnyx # WhatsApp Business API /plugin install telnyx-email@telnyx # Email API /plugin install telnyx-tts@telnyx # Text-to-speech /plugin install telnyx-stt@telnyx # Speech-to-text /plugin install telnyx-verify@telnyx # Phone verification / 2FA /plugin install telnyx-numbers@telnyx # Number management, 10DLC, porting /plugin install telnyx-webrtc@telnyx # WebRTC and client SDKs /plugin install telnyx-ai@telnyx # AI inference and assistants /plugin install telnyx-platform@telnyx # Account, fax, IoT, networking, SIP, storage, TeXML, OAuth, Twilio migration Same pattern for all products: `/plugin install telnyx-@telnyx` ### Cursor Add Telnyx skills as project context by referencing the raw `SKILL.md` files from GitHub: 1. Open **Cursor Settings > Rules > Project Rules** 2. Create a rule file (e.g., `.cursor/rules/telnyx.mdc`) and paste the contents of the desired `SKILL.md` file 3. Alternatively, download the `SKILL.md` file into your project and add it via **@Files** in the chat ### Windsurf Add skills to Windsurf via project rules: 1. Create a `.windsurfrules` file in your project root 2. Paste the contents of the desired `SKILL.md` file(s) into it Now 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. ## Example: building an order notification system 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: * Uses the correct Telnyx SDK import and method names * Includes type hints for clarity * Handles specific Telnyx error types (not generic exceptions) * Adds logging for debugging in production * Returns the message ID for tracking This is production code, not a tutorial snippet. You can deploy it immediately. ## Agent skills vs MCP server We also offer a [Telnyx MCP Server](https://developers.telnyx.com/docs/development/mcp/local-mcp) 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. ## Why this matters for developer productivity The numbers tell the story: * **69%** of developers using AI agents report increased productivity ([Stack Overflow 2025](https://survey.stackoverflow.co/2025/ai)) * **70%** say agents reduced time spent on specific development tasks * **20-40%** increase in individual developer output with AI coding assistants * **51%** of professional developers now use AI tools daily 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. ## Supported products Telnyx Agent Skills cover the full platform, organized by product area: * **Messaging:** SMS, MMS, short codes, 10DLC * **WhatsApp:** [WhatsApp Business API](https://telnyx.com/products/whatsapp-business-api), messaging, calling, templates * **Email:** [Email API](https://telnyx.com/products/email-api), transactional and marketing email, templates, tracking * **Voice:** [Call Control](https://telnyx.com/products/voice-api), TeXML, SIP trunking, conferencing * **Numbers:** Search, purchase, porting, regulatory compliance * **AI:** [Voice AI assistants](https://telnyx.com/products/voice-ai-agents), [STT](https://telnyx.com/products/speech-to-text-api), [TTS](https://telnyx.com/products/text-to-speech-api), embeddings * **Verify:** SMS and voice OTP, fraud prevention * **Fax:** Programmable fax API * **IoT:** SIM management, data plans, connectivity * **Networking:** Private connectivity, cloud on-ramps * **Storage:** S3-compatible cloud storage * **WebRTC:** Browser-based calling ## Get started Agent Skills are open source and free to use. The [GitHub repository](https://github.com/team-telnyx/skills) includes skills for Python, JavaScript, Go, Java, and Ruby. Install them now and start building with natural language. **Ready to try it? Get the skills on [Telnyx Developers](https://developers.telnyx.com/docs/development/agent-skills). Try it and share your comments! Need an API key? [Sign up free](https://telnyx.com/sign-up).** Share on Social Deniz Yakışıklı Sr. Product Marketing Manager Deniz is a Senior Product Marketing Manager at Telnyx with 10 years of experience in technology and healthtech marketing. She previously led go-to-market initiatives at Philips Healthcare, Vodafone, and The Coca-Cola Company. Originally from Türkiye and based in Amsterdam, she ho lds an MBA in Marketing Management from the University of Amsterdam and a Bachelor's degree in Industrial Engineering from Boğaziçi University. In her free time, Deniz enjoys yoga, traveling, and discovering nice restaurants. \[...\] ## Jump to: [What are agent skills?](#what-are-agent-skills)[Quick start: install in 30 seconds](#quick-start-install-in-30-seconds)[Example: building an order notification system](#example-building-an-order-notification-system)[Agent skills vs MCP server](#agent-skills-vs-mcp-server)[Why this matters for developer productivity](#why-this-matters-for-developer-productivity)[Supported products](#supported-products)[Get started](#get-started) ## Sign up for emails of our latest articles and news [Start building](https://telnyx.com/sign-up) Related articles * [**Conversational AI**Improving Voice AI Latency with Co-Located Infrastructure![Abhishek Sharma](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Abishek_Sharma_8313622a2b.png?width=96&format=webp)By Abhishek Sharma15, Oct 2026](https://telnyx.com/resources/how-telnyx-fixed-voice-ai-latency-with-co-located-infrastructure) * [**Conversational AI**AI Agents in Financial Services: Use Cases in India![megha-profile](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Untitled%20(400%20x%20400%20px)%20(1).png?width=96&format=webp)By Megha Sujanani12, Oct 2026](https://telnyx.com/resources/ai-agents-indian-financial-services) * [**Conversational AI**How to build an omnichannel AI agent![Deniz Yakışıklı](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Deniz_Yakisikli_6b7b420ed4.png?width=96&format=webp)By Deniz Yakisikli12, Oct 2026](https://telnyx.com/resources/how-to-build-an-omnichannel-ai-agent) * [**Inference**AI inference hardware: How to choose chips and placement![Eli Mogul](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Eli_Mogul_1de9939dcb.png?width=96&format=webp)By Eli Mogul19, Oct 2026](https://telnyx.com/resources/ai-inference-hardware) * [**Verify API**Caller ID name (CNAM): how your business name reaches the phone![Deniz Yakışıklı](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Deniz_Yakisikli_6b7b420ed4.png?width=96&format=webp)By Deniz Yakışıklı19, Oct 2026](https://telnyx.com/resources/caller-id-name-cnam) * [**Inference**Inference optimization: cut LLM latency and cost![Eli Mogul](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Eli_Mogul_1de9939dcb.png?width=96&format=webp)By Eli Mogul16, Oct 2026](https://telnyx.com/resources/inference-optimization) ### Ask AI * [![GPT](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/chatgpt_icon-ea55e09d.jpeg?width=92&format=webp)](https://chat.openai.com/?q=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.) * [![Claude](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/claude_icon-c7c8eef3.webp?width=92&format=webp)](https://claude.ai/new?q=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.) * [![Perplexity](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/perplexity_icon-cd5b74f1.webp?width=92&format=webp)](https://www.perplexity.ai/search?q=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.) * [![Gemini](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/gemini_icon-4ff1cbf4.webp?width=92&format=webp)](https://www.google.com/search?udm=50&aep=11&q=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.) * [![Grok](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/grok_icon-e588e5bd.webp?width=92&format=webp)](https://x.com/i/grok?text=What makes Telnyx's global network different, breakdown call quality for normal phone calls and voice AI calls.)