AbuseZero skill
Install the AbuseZero skill so your AI coding agent can set up, run and monitor AbuseZero, with one command from the AbuseZero CLI.
The AbuseZero skill teaches AI coding agents to work with AbuseZero: onboarding a new workspace, connecting to an existing one, protecting a benefit end to end, writing the evaluation and outcome code, adding browser protection and webhooks, testing a policy change before it goes live, monitoring the integration and contacting support. It follows the open Agent Skills format: one SKILL.md and a references folder.
The skill holds the rules agents follow, playbooks, example situations, troubleshooting, answers to common questions, code for the AbuseZero Node.js SDK, the AbuseZero REST API, the AbuseZero MCP server and the AbuseZero CLI, and tables of every action, error code, reason code, webhook event type and condition. Docs pages and help articles aren't copied in: the skill lists every page, and agents read each one through AbuseZero's public API, which needs no key. Prices, credits and limits are never written into it either; agents read them when they need them.
Help and support
Read the AbuseZero support guide directly, or use references/support.md in the installed skill. Both come from the same source. The guide explains how to search current help articles and contact support without installing a skill or configuring MCP. Installed copies update when the skill is installed again; agents fetch the hosted guide when starting support work.
Install the AbuseZero skill
npx abusezero@latest skill installThe command installs the skill, or updates it when it's already there. It downloads the newest skill from abusezero.com and checks every file against the skill's manifest before it writes anything, so an older AbuseZero CLI still installs the newest skill. In a project, it installs into the project for every agent it finds installed on your machine or used in the project. With none found, it installs into .agents/skills/abusezero, which many agents read.
| Option | Description |
|---|---|
--agent <name> | Install for one agent only. Repeat it for several. The names are in Supported agents. |
--global | Install for the whole machine instead of the current project. |
--no-agents-md | Leave AGENTS.md and the other instruction files unchanged. |
npx abusezero@latest skill status shows each installed copy, its version and whether a newer one exists.
Supported agents
The skill goes into an abusezero folder inside each agent's skills folder. Several agents share .agents/skills, so one copy serves them all.
| Agent | --agent | Project folder | Machine folder (--global) |
|---|---|---|---|
| Claude Code | claude-code | .claude/skills | ~/.claude/skills |
| Codex | codex | .agents/skills | ~/.agents/skills |
| Cursor | cursor | .agents/skills | ~/.cursor/skills |
| Gemini CLI | gemini-cli | .agents/skills | ~/.gemini/skills |
| GitHub Copilot | github-copilot | .agents/skills | ~/.copilot/skills |
| Windsurf | windsurf | .windsurf/skills | ~/.codeium/windsurf/skills |
| Cline | cline | .agents/skills | ~/.agents/skills |
| Antigravity | antigravity | .agents/skills | ~/.gemini/config/skills |
| OpenClaw | openclaw | skills, only with --agent | ~/.openclaw/skills |
| OpenCode | opencode | .agents/skills | ~/.config/opencode/skills |
| Amp | amp | .agents/skills | ~/.config/agents/skills |
| Roo Code | roo | .roo/skills | ~/.roo/skills |
| Kiro CLI | kiro-cli | .kiro/skills | ~/.kiro/skills |
| Goose | goose | .goose/skills | ~/.config/goose/skills |
| Droid | droid | .agents/skills | ~/.factory/skills |
| Junie | junie | .junie/skills | ~/.junie/skills |
| Continue | continue | .continue/skills | ~/.continue/skills |
| Trae | trae | .trae/skills | ~/.trae/skills |
| Kilo Code | kilo | .agents/skills | ~/.kilo/skills |
| Augment | augment | .augment/skills | ~/.augment/skills |
| Zed | zed | .agents/skills | ~/.agents/skills |
| Warp | warp | .agents/skills | ~/.agents/skills |
| OpenHands | openhands | .openhands/skills | ~/.openhands/skills |
| Crush | crush | .crush/skills | ~/.config/crush/skills |
| Devin | devin | .devin/skills | ~/.config/devin/skills |
CLAUDE_CONFIG_DIR moves Claude Code's machine folder, and XDG_CONFIG_HOME moves the folders under ~/.config.
The AbuseZero section of AGENTS.md
In a project, the installer adds a short AbuseZero section to the project's AGENTS.md, and creates the file when it doesn't exist. The section sits between <!-- abusezero:start --> and <!-- abusezero:end -->. Your agent fills it in as it works, so the next session picks up where the last one stopped: the workspace ID, the protected benefits, where evaluations and outcome reports are called, the environment variable names (never their values), which credential is used where, the webhook endpoint and its handler, how to run a dry-run evaluation, the skill version and the date of the last update.
Running the installer again rewrites only the skill version and the date, adds any standard line that's missing, and keeps everything else as your agent wrote it.
Agents that read their own instruction file get a one-line pointer to the section, never a copy:
| File | Agent |
|---|---|
CLAUDE.md | Claude Code |
GEMINI.md | Gemini CLI |
.cursor/rules/abusezero.mdc | Cursor |
.github/copilot-instructions.md | GitHub Copilot, when the file already exists |
Keep the AbuseZero skill current
The skill tells your agent to check for a newer version before every task and every new step, and to install it before carrying on.
- The public versions read.
GET https://api.abusezero.com/v1/public/versionsreturns the latest version asskill.version, with no key. The installed version is theversioninSKILL.md. - Every AbuseZero CLI command says when an installed copy is out of date, in interactive use. The check is cached and never delays or fails a command. It stays silent in scripts, in CI and for JSON output; set
ABUSEZERO_SKILL_NOTICE=1to show it there too, or0to turn it off. - The AbuseZero MCP server gives every client the latest skill version in its instructions when it connects.
Read the AbuseZero skill on the web
The whole skill is one Markdown file at https://abusezero.com/skill.md, the same as https://abusezero.com/skill, for agents that don't have it installed. Each file is also at https://abusezero.com/skill/<path>, such as https://abusezero.com/skill/references/agent-rules.md, and https://abusezero.com/skill/manifest.json lists every file with its digest.
The AbuseZero skill on GitHub
The skill also has its own public repository, abusezero/skill on GitHub, for agents' own installers and plugin marketplaces. It holds the same files under skills/abusezero, updated with every release. In Claude Code:
/plugin marketplace add abusezero/skill
/plugin install abusezero@abusezeroNext steps
How is this guide?
Last updated on