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
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/retellai-policy-guardrails/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/retellai-policy-guardrails/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a codex2Manually: put the files in place
.agents/skills/retellai-policy-guardrails/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a cursor2Manually: put the files in place
.cursor/skills/retellai-policy-guardrails/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/retellai-policy-guardrails2Manually: put the files in place
.github/skills/retellai-policy-guardrails/SKILL.md1Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a gemini-cli2Platform CLI
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/retellai-policy-guardrailsManually: put the files in place
.devin/skills/retellai-policy-guardrails/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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