retellai-policy-guardrails — скилл для Claude Code: обзор и запуск
Скилл retellai-policy-guardrails задаёт правила и границы действий для голосовых агентов на платформе Retell AI. Он нужен при настройке телефонии, чтобы бот не выходил за рамки разрешённых операций.
MIT 1 установок ★ 2 935 обновлён 2026-11-01
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a claude-codeЧто делает retellai-policy-guardrails
Скилл описывает шаблоны интеграции пакета retell-sdk на TypeScript для телефонных голосовых агентов. С его помощью задают жёсткие границы доступных действий: например, агенту записи на приём разрешают только поиск слотов и создание бронирования, а медицинские вопросы и возвраты отправляют живому оператору.
Внутрь заложены правила валидации аргументов и проверка поведения на синтетических промптах. Без ключа RETELL_API_KEY в окружении запросы к платформе падают с кодовой ошибкой 401. Перед использованием инструкций требуется выполнить предварительную настройку retellai-install-auth.
Какие задачи решает
- ограничить набор инструментов голосового бота только нужными операциями
- настроить переключение на человека при запросах возврата или смене данных
- проверить реакцию телефонного агента на запрещённые синтетические запросы
- связать версии правил поведения с конкретными версиями агента в Retell AI
Примеры запросов агенту
- Настрой границы действий для телефонного бота бронирования через Retell AI
- Добавь передачу звонка оператору, если клиент просит возврат средств
- Проверь голосового агента синтетическими промптами на запрещённые темы
Как установить retellai-policy-guardrails
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a claude-code2Вручную: положить файлы
~/.claude/skills/retellai-policy-guardrails/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/retellai-policy-guardrails/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a codex2Вручную: положить файлы
.agents/skills/retellai-policy-guardrails/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a cursor2Вручную: положить файлы
.cursor/skills/retellai-policy-guardrails/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/retellai-policy-guardrails2Вручную: положить файлы
.github/skills/retellai-policy-guardrails/SKILL.md1Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a gemini-cli2Командой платформы
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/retellai-policy-guardrailsВручную: положить файлы
.devin/skills/retellai-policy-guardrails/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о retellai-policy-guardrails
Как установить retellai-policy-guardrails в Claude Code?
Выполните команду npx skills add jeremylongshore/tons-of-skills-marketplace --skill retellai-policy-guardrails -a claude-code. Файл настроек сохранится по пути ~/.claude/skills/retellai-policy-guardrails/SKILL.md.
Что делает скилл retellai-policy-guardrails?
Он даёт готовые паттерны для ограничения прав голосовых агентов Retell AI и настройки передачи звонков человеку при нестандартных вопросах.
Что требуется для работы перед запуском скилла?
Необходима предварительная настройка retellai-install-auth и действующий ключ доступа RETELL_API_KEY в переменных окружения.
Исходный текст
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