Agent skill · writing content · jeremylongshore
retellai-known-pitfalls
Retell AI known pitfalls \u2014 AI voice agent and phone call automation.\n\
Why this skill is useful
Provides specific implementation patterns and error handling for integrating with Retell AI 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 Known Pitfalls Overview Implementation patterns for Retell AI known pitfalls — voice agent and telephony platform. Prerequisites Completed retellai-install-auth setup Instructions Step 1: SDK Pattern Output Retell AI integration for known pitfalls 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 Avoid a duplicate-call retry after a network timeout An outbound request times out after submission. Before retrying, look up the request correlation or call identifier to determine whether Retell already created the call. If state is unknown, hold the retry and escalate with the redacted request metadata; sending a second request can contact the same person twice. Add bounded retries only where the operation is explicitly idempotent and monitor the duplicate-call rate after the change. 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-known-pitfalls--eb495a