跳到主内容
智客 ZICQ

技能库 智客分类:设计创意 vapi-prompt-builder

Vapi Prompt Builder

创建、改进或审计Vapi语音代理和Squad系统,用于制作电话和网络语音代理。 当用户需要帮助设计一个 Vapi 助手快速,多助理的 Squad 即时集时使用,完善一个已有的即时集,创建即时部分,构建一个接取或交接工作流程,改进工具使用指令,添加守护符,或者优化语音代理行为,用于简洁,转接,错误处理,呼叫器数据收集,升级,交接,以及语音格式化.

205 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

创建、改进或审计 Vapi 语音代理和Squad 系统,用于制作电话和网络语音代理

何时用

用户想要帮助设计一个 Vapi 助理快速,多助理的 Squad 即时集, 完善一个已有的即时集, 创建即时片段, 构建一个接收或交接工作流程, 改进工具使用指令, 添加守护栏, 或优化语音代理行为

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Vapi Prompt Builder、Core Workflow、Intake、Prompt Sections、Example Design、Voice Optimization。 其中含规范建议的小节:分步指令、输入输出示例。

文件分析

文件分析:除 SKILL.md 外,正文引用了 references/squad-prompting.md、references/capability-grounding.md、references/voice-prompt-patterns.md、references/identifier-hygiene.md、references/vapi-security-trust.md、references/vapi-readiness.md,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

Create, improve, or audit Vapi voice agent and Squad system prompts for production phone and web based voice agents. Use when the user wants help designing a Vapi assistant prompt, multi-assistant Squad prompt set, refining an existing prompt, creating prompt sections, building an intake or handoff workflow, improving tool-use instructions, adding guardrails, or optimizing voice-agent behavior for brevity, turn-taking, error handling, caller data collection, escalation, handoffs, and spoken formatting.

Vapi Prompt BuilderCore WorkflowIntakePrompt SectionsExample DesignVoice OptimizationTool and Configuration NotesOutput Modes

兼容:Requires internet access and a Vapi API key (VAPI_API_KEY). · 许可:MIT

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
vapi-prompt-builder
description
Create, improve, or audit Vapi voice agent and Squad system prompts for production phone and web based voice agents. Use when the user wants help designing a Vapi assistant prompt, multi-assistant Squad prompt set, refining an existing prompt, creating prompt sections, building an intake or handoff workflow, improving tool-use instructions, adding guardrails, or optimizing voice-agent behavior for brevity, turn-taking, error handling, caller data collection, escalation, handoffs, and spoken formatting.
compatibility
Requires internet access and a Vapi API key (VAPI_API_KEY).
许可
MIT
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 8
  • references/squad-prompting.md
  • references/capability-grounding.md
  • references/voice-prompt-patterns.md
  • references/identifier-hygiene.md
  • references/vapi-security-trust.md
  • references/vapi-readiness.md
  • references/intake-question-bank.md
  • references/review-checklist.md

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「vapi-prompt-builder」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-270f9925aeb18cd4-Vapi-%E5%BF%AB%E9%80%9F%E6%9E%84%E5%BB%BA%E5%99%A8.html
请存为 .cursor/skills/vapi-prompt-builder/SKILL.md 或 .claude/skills/vapi-prompt-builder/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://github.com/vapiai/skills 取完整目录,不要只建一个 SKILL.md。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/vapiai/skills' --list

npx skills add 'https://github.com/vapiai/skills' --skill 'vapi-prompt-builder'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版

name: vapi-prompt-builder description: Create, improve, or audit Vapi voice agent and Squad system prompts for production phone and web based voice agents. Use when the user wants help designing a Vapi assistant prompt, multi-assistant Squad prompt set, refining an existing prompt, creating prompt sections, building an intake or handoff workflow, improving tool-use instructions, adding guardrails, or optimizing voice-agent behavior for brevity, turn-taking, error handling, caller data collection, escalation, handoffs, and spoken formatting. license: MIT compatibility: Requires internet access and a Vapi API key (VAPI_API_KEY). metadata: author: vapi version: "1.0"

Vapi Prompt Builder

Core Workflow

Use this skill to produce production-ready Vapi voice agent system prompts. Optimize for spoken interaction, low latency, explicit turn-taking, tool reliability, safe escalation, and predictable call outcomes.

Start by classifying the request:

  • Create: Build a new Vapi system prompt from a business goal or agent concept.
  • Improve: Rewrite an existing prompt while preserving intended behavior.
  • Audit: Review an existing prompt and return findings, gaps, and recommended changes.

Then resolve deployment shape:

  • Single assistant: one Vapi assistant owns the call flow.
  • Squad: multiple specialized assistants hand off between each other.

If the request is ambiguous and the workflow may involve multiple specialized roles, routing, or handoffs, stop and ask: "Should this be designed as one Vapi assistant, or as a Vapi Squad with multiple assistants and handoffs?" Do not draft until this is resolved.

Read references/squad-prompting.md when the user mentions squads, Handoff Tools, handoffs between assistants or squads, silent handoffs, dynamic routing, router/triage assistants, specialist assistants, or a workflow that is too broad for one reliable prompt.

Before writing or preserving workflow details, run a capability-grounding pass. Verify that every claimed input, artifact, tool action, side effect, and example is possible through the actual call channel, runtime context, visible Vapi tools, or explicitly described backend behavior. Read references/capability-grounding.md when the prompt mentions files, uploads, attachments, documents, screenshots, browser/web actions, async jobs, integrations, or any action the phone caller cannot perform directly during the call.

Read references/voice-prompt-patterns.md when creating or substantially rewriting a prompt, or when the request involves voice style, examples, tool behavior, information collection, or call endings.

Run an identifier-hygiene pass before finalizing. Read references/identifier-hygiene.md when the prompt uses tool names, resource IDs, snake_case identifiers, placeholder names, or generic values such as the_tool_name.

Run a Vapi trust-boundary pass when the prompt, tools, or configuration mention authentication, caller identity, account IDs, permissions, secrets, secure values, verified values, static parameters, function.parameters, dynamic variables, variableExtractionPlan, tool aliases, handoff arguments, or sensitive tool responses. Read references/vapi-security-trust.md before recommending where those values belong.

Run a Vapi readiness pass before presenting an artifact as ready to build or configure. Read references/vapi-readiness.md when the output includes tools, structured outputs, dynamic variables, Squads, handoffs, pronunciation guidance, testing/evals, or configuration notes. Separate confirmed Vapi configuration from assumptions and missing deployment inputs.

Intake

Ask the fewest questions needed to make a useful first draft. Prefer a complete draft with clear assumptions over a long upfront questionnaire.

Always collect or infer:

  • Business or use case
  • Deployment shape: single assistant or Squad
  • Agent role and call objective
  • Caller type and likely intents
  • Success criteria
  • Required workflows
  • Handoff/routing boundaries when using a Squad
  • Tools or actions the agent can use
  • Tool schemas, structured outputs, and handoff destinations that are already known
  • Model provider when Handoff Tool configuration patterns depend on it
  • Which values are server-trusted, caller-spoken, tool-returned, LLM-derived, or security-sensitive
  • How each required input becomes available to the agent or backend
  • Human handoff or escalation rules
  • Information the agent may collect
  • Information the agent must not collect
  • Tone, persona, and brand constraints

Read references/intake-question-bank.md when the request is vague, high-risk, or missing several essentials.

If the user provides an existing prompt, inspect it before asking questions. Ask only about missing facts, contradictions, tool behavior, compliance constraints, or ambiguous handoff rules.

Prompt Sections

For a single assistant, generate or improve these sections unless the user asks for a narrower output:

  1. Identity and purpose
  2. Personality and speaking style
  3. Response guidelines
  4. Guardrails and safety behavior
  5. Context and dynamic variables
  6. Workflow and intent routing
  7. Tool-use rules
  8. Error handling and recovery
  9. Smart information collection
  10. Escalation, transfer, and call ending
  11. Few-shot examples

For a Squad, generate or improve:

  1. Squad purpose and member map
  2. Entry assistant behavior
  3. One focused system prompt per assistant
  4. Handoff decision rules
  5. Context handoff requirements
  6. Tool boundaries per assistant
  7. Shared guardrails
  8. Per-assistant examples, including handoff examples
  9. External test scenarios for routing and context preservation

For new prompts and substantial rewrites, include a compact Examples section inside the final Vapi system prompt unless the user explicitly asks to omit examples or there is a strong latency/token reason to keep the prompt minimal. Do not substitute external test scenarios for in-prompt examples.

Keep the final system prompt lean. Do not include tutorial prose, rationale, or markdown intended for humans unless the user requests it. Use section headers only if they improve maintainability.

Format the final prompt for fast model parsing, not as human-facing documentation:

  • Prefer compact bullets, numbered workflow steps, and short imperative rules over dense paragraphs.
  • Keep each rule to one idea; split multi-clause paragraphs into separate rules.
  • Use paragraphs only for brief identity/personality context, and keep them to one to three short sentences.
  • Do not confuse prompt formatting with spoken output: markdown is acceptable inside the system prompt, but instruct the agent not to speak markdown, bullets, or numbered lists to callers.
  • Before finalizing, compress any section that reads like explanatory prose into operational instructions.

Example Design

Design in-prompt examples as behavioral training data for the voice agent:

  • Include at least three examples when the prompt covers a complete workflow: happy path, edge case, and error recovery.
  • Cover each primary workflow when the agent has multiple high-value intents.
  • Show realistic caller turns, concise assistant responses, tool calls, and tool outcomes.
  • Include branching behavior for zero results, multiple results, invalid input, unclear speech, and tool failure when relevant.
  • Ground every example in actual channel, runtime, tool, or backend capabilities.
  • Use exact tool identifiers only in explicit Tool Call: lines or machine-facing configuration notes.
  • Keep examples short enough to justify their latency cost.
  • Use shape examples instead of repeating forbidden phrases, sensitive values, or unsupported artifacts.

Keep external test scenarios separate from the final prompt. Test scenarios are for the human/operator to validate the prompt; examples are instructions embedded in the prompt for the model to imitate.

Voice Optimization

Before returning the final prompt, run a voice-agent pass:

  • Keep caller-facing turns short, usually one or two sentences.
  • Ask one question at a time.
  • Avoid numbered lists, bullets, markdown, and visual formatting in agent responses.
  • Convert dates, phone numbers, currency, times, and URLs to spoken-friendly forms.
  • Replace tool IDs, resource slugs, snake_case identifiers, and placeholder names in prose with natural capability descriptions.
  • Add explicit rules for interruptions, silence, unclear input, and tool failures.
  • Distinguish light banter from hard off-topic requests.
  • Calibrate human-feel controls to the use case: all production agents need natural pacing, repair, and warmth; only add disfluency, banter, or personal rapport when they fit the persona and risk profile.
  • Remove channel-impossible behaviors unless a tool or backend contract makes them real.
  • Prefer deterministic Vapi configuration over prompt instructions when reliability or security matters.

Tool and Configuration Notes

When tools are involved, review both prompt instructions and tool configuration. Flag items that should be configured outside the system prompt:

  • Tool descriptions should say when to call, when not to call, and required parameter formats.
  • Prompt prose should describe tools by capability. Exact tool names belong only in tool-call examples, schemas, configuration notes, or Query Tool instructions where Vapi needs the system prompt to name the search tool.
  • Do not invent deployable tool schemas, structured output schemas, enum values, server URLs, or handoff destinations. Ask for them or mark them as configuration needed.
  • Transfer and end-call tools need explicit descriptions.
  • Slow tools should use request-start messages to fill dead air.
  • Pronunciation issues should use pronunciation dictionaries when available.
  • Values that must be secure, verified, or impossible for the LLM to fake should use Vapi's server-side/static-parameter patterns, not prompt text or LLM-filled schemas.
  • Tool responses should be short, structured, and limited to fields the model needs.

Output Modes

For a new prompt, return:

  • Brief assumptions, if any
  • Final Vapi system prompt, or Squad prompt set when using a Squad
  • Suggested Vapi configuration notes, if relevant
  • Configuration needed or blocking questions, if deployment-critical details are missing
  • External test scenarios, separate from the prompt

For an improved prompt, return:

  • Final revised prompt, or revised Squad prompt set when using a Squad
  • Important changes made
  • Remaining questions or risks
  • Configuration needed or blocking questions, if deployment-critical details are missing
  • External test scenarios, separate from the prompt

For an audit, return:

  • Findings ordered by severity
  • Missing or weak prompt sections
  • Vapi configuration concerns
  • Concrete rewrite recommendations

Read references/review-checklist.md before finalizing an audit or substantial rewrite.

相关技能

设计创意

Automation Workflows

设计和实施自动化工作流程,以节省时间和规模化操作作为独家. 用于识别重复任务实现自动化,构建跨工具的工作流程,设置触发器和行动,或优化现有自动化. 包括自动化机会识别,工作流程设计,工具选择(Zapier,Make,n8n),测试,和维护. 触发"自动","自动","工作流程自动…

设计创意

Ui Ux Pro Max

UI/UX设计智能及建筑抛光接口实施指导. 当用户要求UI设计,UX流量,信息架构,视觉风格方向,设计系统/托盘,组件规格,副本/显微镜,可访问性,或生成/critique/refine前端UI(HTML/CSS/JS,React,Next.js,Vue,Svelte,Tailw…

设计创意

Frontend Design

创建美丽现代UI的专家前端设计指南. 在构建起落架页面,仪表板,或任何用户界面时使用.

设计创意

N8n Workflow Automation

设计和输出 n8n 工作流程 JSON 有强力触发器, idempotency, 错误处理, 记录, 重试, 以及 人入"一站"审查队列. 当您需要可审计的自动化时使用.