A collection of agent skills for Meticulous — the automated visual regression testing platform for web frontends.
These skills enable AI coding assistants (Cursor, Claude Code, etc.) to use Meticulous: review test runs, investigate replays, debug diffs, etc.
Full setup instructions live in the Meticulous docs: app.meticulous.ai/docs/agents/setup. They cover installing the CLI, authenticating, installing these skills, and the agent permission allowlists for Claude Code, Codex, and Cursor.
The short version:
# 1. Install/update the Meticulous CLI
npm install --global @alwaysmeticulous/cli@latest
# 2. Authenticate (opens a browser to sign in and pick a default project)
meticulous auth login
# 3. Install these skills into your project
npx skills add alwaysmeticulous/skills --all --agents claude-code,codex,cursorThis repository is also packaged as a Claude Code plugin, which installs all the skills below (namespaced as /meticulous:<skill-name>) and automatically connects the hosted Meticulous MCP server. To install, run in Claude Code:
/plugin marketplace add alwaysmeticulous/skills
/plugin install meticulous@meticulousThen type /mcp and choose Authenticate for the Meticulous MCP server (login happens in your browser; not needed if you already authenticate via meticulous auth login for the CLI).
This repository is also packaged as a Cursor plugin. Once listed in the Cursor Marketplace, Cursor users can install Meticulous skills from Customize → Plugins (or search the marketplace) without using npx skills. The npx skills flow above remains the recommended path when you need the same skills across multiple agents.
Skills are Markdown files that provide AI coding assistants with domain-specific knowledge and step-by-step workflows. When an agent reads a skill, it gains targeted expertise for a specific task — without needing that context baked into every conversation.
Skills follow the SKILL.md format used by Cursor and Claude Code.
| Skill | Description |
|---|---|
| Review skills | |
meticulous-review |
Analyze a completed Meticulous test run — fetch the diff summary, inspect representative screenshots, DOM diffs, and timelines. Resolves the test run from the current commit. Use when asked to review Meticulous test results, or while reviewing or babysitting a pull/merge request to assess and fix a failing Meticulous Tests CI check. |
meticulous-test |
Run a Meticulous test run after implementing a frontend change, then hands off to the meticulous-review skill to classify each visual change as intended or unintended. Use when implementing a feature autonomously end-to-end before creating a PR. |
| Experimental skills | |
meticulous-iterative-dev |
Iterative frontend development loop using Meticulous for per-step visual validation. Use when implementing a multi-step frontend change and want to catch visual regressions and unintended side effects at each step, before the final cloud test run. |
meticulous-simulate-and-diff |
Run a Meticulous session simulation against a live URL and analyze the visual output — either by inspecting screenshots directly (quick-check mode) or by comparing pixel and HTML diffs against a base replay. Use when checking whether a code change has introduced visual regressions for a specific session. |
meticulous-use-session-data |
Download and use structured Meticulous session data (user flows + network mocks) for testing code changes locally. Use when you need to understand what user interactions and API calls a test covers, or when you want network mocks for writing tests. |
| Supporting skills | |
meticulous-cli |
Overview of the Meticulous CLI tool and its global options. Use when asking about the meticulous CLI in general, available commands, or global flags that apply to all commands. |
meticulous-cli-update |
Check whether the Meticulous CLI (@alwaysmeticulous/cli) is installed and up to date, and install/update it if not. Invoked at the start of every other Meticulous skill, since the CLI is under active development with frequent changes and improvements. |
ISC © Meticulous, Inc.