Imported from jeremylongshore/tons-of-skills-marketplace (plugins/saas-packs/retellai-pack/skills/retellai-known-pitfalls/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-known-pitfalls. Copyright stays with the author (MIT).

Retell AI Known Pitfalls

Name: retellai-known-pitfalls
Author: jeremylongshore

Overview

Implementation patterns for Retell AI known pitfalls — voice agent and telephony platform.

Prerequisites

Completed retellai-install-auth setup

Instructions

Step 1: SDK Pattern

import Retell from 'retell-sdk';
const retell = new Retell({ apiKey: process.env.RETELL_API_KEY! });

const agents = await retell.agent.list();
console.log(`Agents: ${agents.length}`);

Output

Retell AI integration for known pitfalls

Error Handling

Error	Cause	Solution
401 Unauthorized	Invalid API key	Check RETELL_API_KEY
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

Next Steps

See related Retell AI skills for more workflows.

{ "ocm": "1", "id": "jeremylongshore-tons-of-skills-marketplace-retellai-know-7894dc", "kind": "skill", "name": "retellai-known-pitfalls", "description": "Retell AI known pitfalls — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like \"retell known pitfalls\", \"retellai-known-pitfalls\", \"voice agent\".", "publisher": "jeremylongshore", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "saas", "retellai", "voice", "telephony", "ai-agents", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Retell AI known pitfalls — AI voice agent and phone call automation. Use when working with Retell AI for voice agents, phone calls, or telephony. Trigger with phrases like \"retell known pitfalls\", \"retellai-known-pitfalls\", \"voice agent\"." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace", "path": "plugins/saas-packs/retellai-pack/skills/retellai-known-pitfalls/SKILL.md", "ref": "HEAD", "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/plugins/saas-packs/retellai-pack/skills/retellai-known-pitfalls/SKILL.md", "key": "jeremylongshore/tons-of-skills-marketplace/plugins/saas-packs/retellai-pack/skills/retellai-known-pitfalls/SKILL.md" }, "compatibility": "Designed for Claude Code", "allowed_tools": [ "Read,", "Write,", "Edit,", "Bash(npm:*),", "Bash(curl:*),", "Grep" ], "license": "MIT" }, "instructions": "# Retell AI Known Pitfalls\n\n## Overview\n\nImplementation patterns for Retell AI known pitfalls — voice agent and telephony platform.\n\n## Prerequisites\n\n- Completed `retellai-install-auth` setup\n\n## Instructions\n\n### Step 1: SDK Pattern\n\n```typescript\nimport Retell from 'retell-sdk';\nconst retell = new Retell({ apiKey: process.env.RETELL_API_KEY! });\n\nconst agents = await retell.agent.list();\nconsole.log(`Agents: ${agents.length}`);\n```\n\n## Output\n\n- Retell AI integration for known pitfalls\n\n## Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| 401 Unauthorized | Invalid", "cost": { "context_tokens": 367 } }

retellai-known-pitfalls

About