Install the skill
Install the TokenPolice skill in Claude Code, Cursor, Copilot, Antigravity, or Codex — a one-time setup, then the walkthrough is the same everywhere.
Install the skill once per coding agent. After this, the walkthrough is identical no matter which agent you use.
The skill lives in the public repository github.com/tokenpolice/skills.
It is a folder — SKILL.md plus a references/ folder it links to — so every install path below copies the whole
folder, not one file.
Claude Code
Claude Code installs the skill as a plugin from the TokenPolice marketplace:
claude plugin marketplace add tokenpolice/skills
claude plugin install tokenpolice@tokenpoliceThe skill loads the next time you start Claude Code. If a session is already open in another terminal, run
/reload-plugins there. Then skip ahead to the walkthrough.
No GitHub SSH key on this machine? Set CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 for both commands (export it,
or prefix each) — Claude Code clones owner/repo marketplaces over SSH by default.
Cursor, GitHub Copilot, OpenAI Codex, Google Antigravity
These agents all read skills from .agents/skills/ in your repo. Run this at the root of your repo:
npx skills add tokenpolice/skills -yIt writes the skill to .agents/skills/token-police-sdk/ plus a skills-lock.json at the repo root, and —
depending on which agents it detects on your machine — a symlink to it from that agent's own folder, such as
.claude/skills/token-police-sdk. Commit everything it reports; the lock file is designed to be checked in.
Every agent session in the repo can then add TokenPolice for you. Drop -y and it prompts for scope (Project,
or Global — under your home directory instead of the repo) and lets you pick agents when it cannot tell which
one you use.
skills is a third-party CLI by Vercel Labs. Set DISABLE_TELEMETRY=1 to opt out of its usage telemetry.
Manual install (any agent)
If you'd rather not run a tool, copy the folder yourself. At the root of your repo:
mkdir -p .agents/skills
curl -fsSL https://github.com/tokenpolice/skills/archive/refs/heads/main.tar.gz \
| tar -xzf - -C .agents/skills --strip-components=2 skills-main/skills/token-police-sdkCursor, Copilot, Codex and Antigravity read .agents/skills/. Claude Code reads .claude/skills/ instead:
use that directory in both lines.
Updating
- Claude Code:
claude plugin marketplace update tokenpolice && claude plugin update tokenpolice@tokenpolice npx skills:npx skills update token-police-sdk -y- Manual: run the manual commands again.
Next
Coding agent skill overview
The TokenPolice skill lets your coding agent add the SDK for you: it reads your repo, wires the SDK, and proves the integration works.
Coding agent walkthrough
Say the word, answer a few questions, approve the plan, and run once while the agent verifies itself — with a full worked example.