Skip to main content
The Vobiz docs ship a set of agent skills - focused instruction sets that teach a coding agent how to use one part of Vobiz correctly (the right endpoints, path casing, request shapes, VobizXML verbs, and the common pitfalls). Install them once and your agent stops guessing: it writes working Make a Call requests, valid <Gather> XML, and correct KYC flows straight away.
Skills vs. the MCP server. Skills are static know-how that lives in your agent’s context - how to use Vobiz. The MCP server is a live connection that searches and fetches the docs on demand. They’re complementary: install the skills for reliable, offline-capable patterns, add the MCP server for always-current page lookups. Use both.

​
Install with one command

The skills are hosted on this docs site. The skills CLI installs them into whichever agents it detects on your machine:
The CLI scans for installed agents (Claude Code, Codex, Cursor, and 40+ more), shows a checklist of which to install into and which skills to add, then writes each skill into that agent’s skills directory. Re-run it any time to pull updates.
Skills source
  • What you get: the Vobiz skill set listed below, one folder per skill.
  • What it is not: skills are instructions, not credentials. You still authenticate every API call with your X-Auth-ID / X-Auth-Token - see the API Reference.

​
Prerequisites

  • A supported coding agent installed (Claude Code, Codex, Cursor, etc.).
  • Node.js 18+ for npx. Run node --version; if it prints v18 or higher, you’re set.
  • An internet connection - the skills are fetched from this docs site.

​
Claude Code

Claude Code loads skills from .claude/skills/ (per-project) or ~/.claude/skills/ (global).
1

Install the skills

From your project directory, install into Claude Code specifically:
Add --global to make them available in every project instead of just the current repo:
Omit --agents to let the CLI auto-detect and offer Claude Code (and anything else) in an interactive checklist.
2

Confirm they landed

You’ll see the vobiz-* skills with the directory each was written to - .claude/skills/ for a project install or ~/.claude/skills/ for a global one.
3

Use them in a session

Skills load automatically by relevance. Just ask for the task:
Write a curl that places an outbound Vobiz call and the minimal answer XML it should return.
Claude Code pulls in the vobiz-voice-calls and vobiz-voice-xml skills and produces a request with the correct /Account/{auth_id}/Call/ path casing and a valid <Response>.

​
Codex

The same command installs into OpenAI Codex. Codex stores its config under CODEX_HOME (default ~/.codex), and the CLI writes the skills into Codex’s skills directory there.
1

Install the skills

To install into a custom Codex home, set CODEX_HOME first:
2

Confirm they landed

The output shows each vobiz-* skill and the exact Codex directory it was installed to on your machine.
3

Use them in a session

Start Codex in your project and describe the task - for example:
Build a Vobiz IVR: a <Gather> menu that routes to two departments.
Codex applies the vobiz-voice-xml skill and uses executionTimeout (not timeout) on <Gather>, the kind of detail the skill encodes.

​
Other agents

The same source works with every agent the CLI supports - Cursor, Windsurf, Gemini CLI, GitHub Copilot, Cline, Goose, and more. Target one explicitly with --agents <name>, install everywhere with --all, or run the bare command and pick from the checklist:
Already connected the Vobiz MCP server? Your agent can also discover these skills as MCP resources without a separate install - the local install above is for offline use and for agents you haven’t wired to MCP.

​
The Vobiz skill set

Each skill is scoped to one domain so your agent loads only what’s relevant to the task.

​
Update or remove

  • Update: re-run npx skills add https://vobiz.ai/docs to pull the latest versions. Add --copy if you prefer copies over symlinks.
  • Inspect: npx skills list shows every installed skill and its location.
  • Remove: delete the vobiz-* folders from your agent’s skills directory (.claude/skills/, ~/.claude/skills/, or the Codex skills directory).
  • MCP Server - connect your AI client to live, searchable Vobiz docs.
  • skills CLI - full command reference and the list of supported agents.
  • Quick Start - make your first call once your agent is set up.