Skip to main content
skill CX Codex

retellai-policy-guardrails — Claude Code skill: setup and usage

retellai-policy-guardrails sets boundaries and tool limits for Retell AI phone voice agents. Useful when you need reliable call workflows with human handoffs.

MIT 1 installs ★ 2,935 updated 2026-11-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a claude-code
Open on GitHub

What retellai-policy-guardrails does

This skill provides TypeScript patterns for retell-sdk to isolate voice agent actions during telephony workflows. For example, a booking assistant gets access strictly to calendar lookups and appointment creation, while requests about refunds or medical advice trigger a transfer to a human specialist.

The guide outlines argument validation, prompt testing against forbidden actions, and SDK error resolution. Without a valid RETELL_API_KEY, API calls immediately fail with 401 Unauthorized errors. It also depends on completing the retellai-install-auth step first.

What it helps with

  • restrict phone agent tools to an approved operational boundary
  • transfer caller to a human specialist on sensitive inquiries
  • test voice assistants against synthetic forbidden prompts
  • track guardrail policy updates alongside agent versions

Example prompts for the agent

  • Set up action boundaries for our Retell AI booking agent
  • Add a human handoff when a caller asks for refunds or account edits
  • Test the phone assistant against forbidden prompts using Retell SDK

How to install retellai-policy-guardrails

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a claude-code

2Manually: put the files in place

~/.claude/skills/retellai-policy-guardrails/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/retellai-policy-guardrails/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about retellai-policy-guardrails

How do I install retellai-policy-guardrails in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a claude-code. The skill will be saved to ~/.claude/skills/retellai-policy-guardrails/SKILL.md.

What does retellai-policy-guardrails do?

It defines implementation patterns for restricting voice agent permissions and configuring escalation flows to human reps in Retell AI.

What prerequisites does this skill require?

You must complete retellai-install-auth setup and set the RETELL_API_KEY environment variable for SDK authentication.

Source text

SKILL.md · MIT
---
name: retellai-policy-guardrails
description: "Retell AI policy guardrails \u2014 AI voice agent and phone call automation.\n\
  Use when working with Retell AI for voice agents, phone calls, or telephony.\nTrigger\
  \ with phrases like \"retell policy guardrails\", \"retellai-policy-guardrails\"\
  , \"voice agent\".\n"
allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(curl:*), Grep
version: 1.9.0
license: MIT
author: Jeremy Longshore <[email protected]>
tags:
- saas
- retellai
- voice
- telephony
- ai-agents
compatibility: Designed for Claude Code
---
# Retell AI Policy Guardrails

## Overview

Implementation patterns for Retell AI policy guardrails — voice agent and telephony platform.

## Prerequisites

- Completed `retellai-install-auth` setup

## Instructions

### Step 1: SDK Pattern

```typescript
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 policy guardrails

## 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

### Restrict a booking agent to an approved action boundary

Give an appointment agent only the lookup and create-booking tools needed for
its flow, with explicit argument validation and a human handoff for refunds,
medical questions, or account changes. Test synthetic prompts that attempt
each forbidden action and verify that the agent refuses or transfers rather
than improvising. Version the policy with the agent and review deviations from
the guardrail before widening any permission.

## Resources

- [Retell AI Documentation](https://docs.retellai.com)
- [retell-sdk npm](https://www.npmjs.com/package/retell-sdk)

## Next Steps

See related Retell AI skills for more workflows.

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Similar skills

All skills for AI and ML →

From the same set139

The whole set →
windsurf-flows-automation windsurf-flows-automation — a skill for building and managing Windsurf Flows, the automation scripts for repetitive dev work. Turn routine tasks into one-command flows. CX Codex +1 1installs lindy-core-workflow-b lindy-core-workflow-b is a Claude Code skill for configuring Lindy triggers, Cron schedules, and multi-agent delegation. CX Codex +1 1installs deepgram-core-workflow-b The deepgram-core-workflow-b skill outlines real-time transcription with Deepgram over WebSocket. Use it when adding live captions, voice controls, or speech features to an app. CX Codex +1 1installs code-documentation-analyzer Auto-activating skill for auditing code documentation: API references, user guides, architecture docs. Triggers on phrases like "code documentation analyzer" or "code analyzer". CX Codex +1 1installs openevidence-deploy-integration openevidence-deploy-integration plans an OpenEvidence rollout for a clinical workflow, covering the pilot, staff training, governance checks, and rollback conditions. CX Codex +1 1installs speak-install-auth speak-install-auth — a skill to integrate Speak, an AI language tutoring platform powered by GPT-4o and OpenAI Realtime. Configures API credentials, speech recognition, and prepares your environment to run lessons across 14+ languages. CX Codex +1 1installs speak-migration-deep-dive speak-migration-deep-dive migrates language learning platforms to Speak, imports student progress, and configures the @speak/language-sdk client. CX Codex +1 1installs lokalise-core-workflow-a lokalise-core-workflow-a — a Claude Code skill for the source-to-Lokalise direction: uploading translation files, creating and editing keys. Also runs in Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open