# Install the skill (/docs/get-started/coding-agent/install)



Install the skill once per coding agent. After this, the [walkthrough](/docs/get-started/coding-agent/walkthrough)
is identical no matter which agent you use.

The skill lives in the public repository [github.com/tokenpolice/skills](https://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]

Claude Code installs the skill as a plugin from the TokenPolice marketplace:

```bash
claude plugin marketplace add tokenpolice/skills
claude plugin install tokenpolice@tokenpolice
```

The 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](/docs/get-started/coding-agent/walkthrough).

<Callout type="info">
  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.
</Callout>

## Cursor, GitHub Copilot, OpenAI Codex, Google Antigravity [#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:

```bash
npx skills add tokenpolice/skills -y
```

It 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) [#manual-install-any-agent]

If you'd rather not run a tool, copy the folder yourself. At the root of your repo:

```bash
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-sdk
```

Cursor, Copilot, Codex and Antigravity read `.agents/skills/`. Claude Code reads `.claude/skills/` instead:
use that directory in both lines.

## Updating [#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 [#next]

<Cards>
  <Card title="The walkthrough" href="/docs/get-started/coding-agent/walkthrough" description="Say the word, answer a few questions, approve the plan, run once." />

  <Card title="Get your API key" href="/docs/get-started/api-key" description="You'll need a show-once tp_sk_ key before you start." />
</Cards>