VANSA / DEVELOPER TOOLS

Agent skill

Give your coding agent the context to build with Vansa. The skill covers the API, question design and how to turn model answers into application logic.

Download skill Read SKILL.md

For Claude Code, Codex and agents that support SKILL.md.

01 / Install the skill

Paste this into your coding agent from the project where you want to use Vansa.

Install the Vansa API skill from
https://docs.vansa.org/skills/vansa-api.zip

Extract the complete vansa-api folder into this project’s
.claude/skills/ for Claude Code, or .agents/skills/ for Codex.
For another agent, use its documented skills directory.
Keep SKILL.md and its supporting files together.

Then use the vansa-api skill when integrating Vansa in this project.

Install manuallyDownload → extract → use

Download the ZIP, extract it, then place the entire vansa-api folder in your project’s skills directory:

Agent	SKILL.md location, relative to your project
Claude Code	`.claude/skills/vansa-api/SKILL.md`
Codex	`.agents/skills/vansa-api/SKILL.md`

Keep the references and agents folders alongside SKILL.md. For other agents, copy the same package to their supported skill location.

Installation locations: Claude Code documentation · Codex documentation.

02 / Build with Vansa

Tell the agent what your software needs to decide. Start with one of these prompts:

Use the vansa-api skill to add support-ticket routing to this project.
Choose between billing, technical support and other.
Keep the questions in one place and add tests for missing context.
Use VANSA_KEY from the server environment.

Use the vansa-api skill to prioritize delivery exceptions.
Define an ordered urgency scale and a yes/no question for whether
the customer needs an update. Handle the typed answers in code.
Use VANSA_KEY from the server environment.

Use the vansa-api skill to review our Vansa integration.
Check request fields, response handling, timeouts and retries.
Suggest test cases for ambiguous input and missing evidence.
Explain any changes to our questions or decision thresholds.

The skill can guide implementation without a key. To call the API, set your personal key as VANSA_KEY in the server environment. During closed beta, join the waiting list for access, or use the public playground to try the model.

You can also invoke /vansa-api in Claude Code or $vansa-api in Codex CLI and its IDE extension.

03 / What the agent learns

choice

Route to one of your named options.

score

Evaluate input against an ordered scale.

noul

Get the probability of a yes/no statement.

It also covers authentication, request limits, typed responses, errors and retries, plus guidance for missing evidence and testing on your own inputs.

SKILL.mdWhen and how to use Vansa.
references/api.mdAPI contract and integration examples.
agents/openai.yamlSkill name and prompt for Codex.

Updates & help

To update, download the latest package and replace your project’s vansa-api skill folder. Keep application-specific questions in your application code.

If the skill does not appear, check that SKILL.md is directly inside the vansa-api folder at the location above, then restart your agent. If an integration uses unfamiliar fields, compare it with the API reference.