Percy Visual Testing Agent — Testing skill for Claude Code

Percy Visual Testing — Plugin for AI Coding Agents

Visual review loop for agentic UI development. Works in Claude Code, Cursor, Codex, Antigravity, GitHub Copilot, and any AI IDE that reads `AGENTS.md`.

⚠️ **Beta** — this plugin is in beta. Capabilities, commands, and behavior may change; feedback welcome via GitHub issues.

When an agent changes UI code, this plugin makes sure a Percy build runs, the diffs are checked against the agent's stated intent, and the change is rejected + iterated on if real bugs are found — all without leaving the editor.

---

Install

**Claude Code**

/plugin marketplace add percy/percy-visual-testing-agent
/plugin install percy-visual-testing

**Cursor · Codex · Antigravity · Gemini (Code Assist agent mode or CLI)** — any IDE that reads `AGENTS.md` (all major agents do). One command, run in your repo:

curl -fsSL https://raw.githubusercontent.com/percy/percy-visual-testing-agent/main/install.sh | bash

**GitHub Copilot** — same command with `--copilot` (adds the `/percy-*` slash commands to Copilot Chat):

curl -fsSL https://raw.githubusercontent.com/percy/percy-visual-testing-agent/main/install.sh | bash -s -- --copilot

**QA / regression-suite repo** (your automation suite lives in its own repo and you triage scheduled runs) — add `--qa` (combine with `--copilot` if you use Copilot):

curl -fsSL https://raw.githubusercontent.com/percy/percy-visual-testing-agent/main/install.sh | bash -s -- --copilot --qa

The installer only touches your repo: skills → `.percy/skills/`, a short section appended to your `AGENTS.md`, a one-line `GEMINI.md` pointer (created or appended — Gemini reads `GEMINI.md` by default, not `AGENTS.md`), and (with `--copilot`) prompts → `.github/prompts/`. Prefer manual? Copy those files from this repo — that's all it does.

Outside Claude Code/Copilot (Cursor, Codex, Antigravity, Gemini Code Assist agent mode in VS Code, Gemini CLI — any `AGENTS.md` IDE) there a