AbuseZeroAbuseZero

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 install

The 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.

OptionDescription
--agent <name>Install for one agent only. Repeat it for several. The names are in Supported agents.
--globalInstall for the whole machine instead of the current project.
--no-agents-mdLeave 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--agentProject folderMachine folder (--global)
Claude Codeclaude-code.claude/skills~/.claude/skills
Codexcodex.agents/skills~/.agents/skills
Cursorcursor.agents/skills~/.cursor/skills
Gemini CLIgemini-cli.agents/skills~/.gemini/skills
GitHub Copilotgithub-copilot.agents/skills~/.copilot/skills
Windsurfwindsurf.windsurf/skills~/.codeium/windsurf/skills
Clinecline.agents/skills~/.agents/skills
Antigravityantigravity.agents/skills~/.gemini/config/skills
OpenClawopenclawskills, only with --agent~/.openclaw/skills
OpenCodeopencode.agents/skills~/.config/opencode/skills
Ampamp.agents/skills~/.config/agents/skills
Roo Coderoo.roo/skills~/.roo/skills
Kiro CLIkiro-cli.kiro/skills~/.kiro/skills
Goosegoose.goose/skills~/.config/goose/skills
Droiddroid.agents/skills~/.factory/skills
Juniejunie.junie/skills~/.junie/skills
Continuecontinue.continue/skills~/.continue/skills
Traetrae.trae/skills~/.trae/skills
Kilo Codekilo.agents/skills~/.kilo/skills
Augmentaugment.augment/skills~/.augment/skills
Zedzed.agents/skills~/.agents/skills
Warpwarp.agents/skills~/.agents/skills
OpenHandsopenhands.openhands/skills~/.openhands/skills
Crushcrush.crush/skills~/.config/crush/skills
Devindevin.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:

FileAgent
CLAUDE.mdClaude Code
GEMINI.mdGemini CLI
.cursor/rules/abusezero.mdcCursor
.github/copilot-instructions.mdGitHub 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/versions returns the latest version as skill.version, with no key. The installed version is the version in SKILL.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=1 to show it there too, or 0 to 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@abusezero

Next steps

How is this guide?

Last updated on