Skip to main content

Using apic with AI agents

apic ships an Agent Skills SKILL.md that teaches AI coding agents to find, preview, send and check contracts safely. The skill tells the agent to preview requests with apic send --dry-run, which shows variables as $name, and never to read .apic/env/*.local.toml, so your secrets stay out of the agent's context.

Install​

apic skill --install # this project
apic skill --install --global # every project, for your user

The skill is built into the binary, so it always matches your apic version. Re-run the install after an upgrade to update it. A file that differs is overwritten, so hand edits to an installed SKILL.md are lost.

You can also install it with npx skills add rizukirr/apic, or print it with apic skill and save it wherever your agent looks.

Where it goes​

AgentProject folderWith --global
Claude Code.claude/skills/apic/~/.claude/skills/apic/
Codex.agents/skills/apic/~/.agents/skills/apic/
Antigravity.agents/skills/apic/~/.gemini/config/skills/apic/
Cursor.agents/skills/apic/ and .claude/skills/apic/use the project install
pi.agents/skills/apic/~/.agents/skills/apic/
Hermesnone~/.hermes/skills/apic/

Reference docs for agents​

The skill keeps itself short and points agents at apic docs command, apic docs sending and apic docs contract. These print the full reference built into the binary, so an agent without web access still gets docs that match the installed version.