Agent skill · software engineering · jeremylongshore
retellai-reference-architecture
Retell AI reference architecture \u2014 AI voice agent and phone call\
Why this skill is useful
Provides specific implementation patterns and error handling for integrating with Retell AI's telephony SDK that the AI wouldn't reliably generate on its own.
What it needs
Requires retell-sdk installed locally. Requires retellai account access. About 1k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Retell AI Reference Architecture Overview Implementation patterns for Retell AI reference architecture — voice agent and telephony platform. Prerequisites Completed retellai-install-auth setup Instructions Step 1: SDK Pattern Output Retell AI integration for reference architecture Error Handling Error Cause Solution ------- ------- ---------- 401 Unauthorized Invalid API key Check RETELLAPIKEY 429 Rate Limited Too many requests Implement backoff 400 Bad Request Invalid parameters Check API documentation Examples Separate the call path from slow business-system enrichment Route the voice agent through a stable API boundary that validates inputs and returns a bounded response, while sending slow CRM or analytics enrichment to an asynchronous worker. The agent receives a clear timeout and human-transfer fallback if the business system is unavailable. Exercise this topology with a synthetic outage before launch, then document which component owns retries, audit events, and the rollback to the prior routing configuration. Resources Retell AI Documentation retell-sdk npm Next Steps See related Retell AI skills for more workflows.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/retellai-reference-architecture--7096aa