About

Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/retellai-reference-architecture/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-reference-architecture. Copyright stays with the author (MIT).

Retell AI Reference Architecture

Name: retellai-reference-architecture
Author: jeremylongshore

Overview

Implementation patterns for Retell AI reference architecture — 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 reference architecture

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

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

Next Steps

See related Retell AI skills for more workflows.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/jeremylongshore-tons-of-skills-marketplace-retellai-refe-191114/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

jeremylongshore-tons-of-skills-marketplace-retellai-refe-191114.ocm.jsonjson

{
  "ocm": "1",
  "id": "jeremylongshore-tons-of-skills-marketplace-retellai-refe-191114",
  "kind": "skill",
  "name": "retellai-reference-architecture",
  "description": "Retell AI reference architecture — 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 reference architecture\", \"retellai-reference-architecture\", \"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 reference architecture — 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 reference architecture\", \"retellai-reference-architecture\", \"voice agent\"."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/jeremylongshore/tons-of-skills-marketplace",
      "path": "skills/.curated/retellai-reference-architecture/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/HEAD/skills/.curated/retellai-reference-architecture/SKILL.md",
      "key": "jeremylongshore/tons-of-skills-marketplace/skills/.curated/retellai-reference-architecture/SKILL.md"
    },
    "compatibility": "Designed for Claude Code",
    "allowed_tools": [
      "Read,",
      "Write,",
      "Edit,",
      "Bash(npm:*),",
      "Bash(curl:*),",
      "Grep"
    ],
    "license": "MIT"
  },
  "instructions": "# Retell AI Reference Architecture\n\n## Overview\n\nImplementation patterns for Retell AI reference architecture — 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 reference architecture\n\n## Error Handling\n\n| Error | Cause | Solution |\n|-------|-------|----------|\n| 40",
  "cost": {
    "context_tokens": 378
  }
}

Fetch it by URL: GET /api/v1/registry/jeremylongshore-tons-of-skills-marketplace-retellai-refe-191114/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.