Catalog›Plugins›Developer tools›meticulousMmeticulousAgent skills for Meticulous visual regression testing — review test runs, investigate replays, debug diffs. Also connects the hosted Meticul Open site Project Open in the app JSON README (API)Agent skills for Meticulous visual regression testing — review test runs, investigate replays, debug diffs. Also connects the hosted Meticulous MCP server.READMELoading documentation…# Meticulous Agent Skills A collection of agent skills for [Meticulous](https://meticulous.ai) — 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. ## Setup Full setup instructions live in the Meticulous docs: **[app.meticulous.ai/docs/agents/setup](https://app.meticulous.ai/docs/agents/setup)**. They cover installing the CLI, authenticating, and installing these skills. The short version: ```bash # 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 --skill "*" --agent claude-code --agent codex --agent cursor -y ``` ### Claude Code plugin This repository is also packaged as a [Claude Code plugin](https://code.claude.com/docs/en/discover-plugins), which installs all the skills below (namespaced as `/meticulous:<skill-name>`) and automatically connects the hosted [Meticulous MCP server](https://app.meticulous.ai/api/mcp). To install, run in Claude Code: ```shell /plugin marketplace add alwaysmeticulous/skills /plugin install meticulous@meticulous ``` Then 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). ### Codex plugin This repository is also packaged as a [Codex plugin](https://developers.openai.com/codex/plugins), which installs all the skills below and automatically connects the hosted [Meticulous MCP server](https://app.meticulous.ai/api/mcp). To install, run: ```bash codex plugin marketplace add alwaysmeticulous/skills codex plugin add meticulous@meticulous ``` Then run `codex mcp login meticulous` to authenticate the MCP server (login happens in your browser). To pick up later changes, run `codex plugin marketplace upgrade meticulous`. ### Cursor Marketplace This repository is also packaged as a [Cursor plugin](https://cursor.com/docs/plugins). 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 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](https://docs.cursor.com/context/rules-for-ai) used by Cursor and Claude Code. | Skill | Description | | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Review skills** | | | [`meticulous-review`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-review/SKILL.md) | Work through a Meticulous test run's results, reacting to their review state — review the unreviewed diffs against what the PR is meant to change and flag potential regressions; when you're working on the PR's code, hand what needs fixing to `meticulous-fix`. Use whenever a run's results matter: reviewing a pull/merge request, right after pushing a frontend change, when its Meticulous CI check is failing or pending, or when asked to look at Meticulous results. | | [`meticulous-fix`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-fix/SKILL.md) | Fix the visual diffs that have been reviewed and rejected on a test run, following their review comments if given. Use when a user has reviewed the results of a test run and is handing off to an agent to implement the fixes, or when `meticulous-review` hands off what needs fixing. | | [`meticulous-test`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-test/SKILL.md) | 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. | | [`meticulous-zero-diff-task`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-zero-diff-task/SKILL.md) | Implement a task for which no visual diffs are expected end to end, using Meticulous as the loop you iterate against until the diff is clean, then open a PR. Use when the task's whole premise is "the UI shouldn't change" — a dependency/version upgrade, a code refactor, a migration, or similar. | | [`meticulous-increase-coverage`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-increase-coverage/SKILL.md) | Increase coverage for a Meticulous project by tracing specific under-covered files back to a real UI action in the codebase, driving that action with a real recorded browser session, and validating the improvement with a clean coverage comparison. Also opens a PR proposing `.meticulousignore` entries for code that structurally never executes in-browser. Use when asked to "increase coverage", "find untested code", or "add `.meticulousignore` entries" for a project. | | [`meticulous-iterative-dev`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-iterative-dev/SKILL.md) | 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`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-simulate-and-diff/SKILL.md) | 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`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-use-session-data/SKILL.md) | 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. | | [`meticulous-improve-test-env`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-improve-test-env/SKILL.md) | Work out what to change in a project's test environment so Agent swarm stops getting blocked when it tests against a live backend — seed better test data, widen the test user's permissions, enable feature flags, fix test login. Reads the setup blockers Agent swarm has recorded, inspects the codebase and test-environment configuration, and proposes concrete fixes. | | **Supporting skills** | | | [`meticulous-cli`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-cli/SKILL.md) | 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`](https://github.com/alwaysmeticulous/skills/blob/HEAD/skills/meticulous-cli-update/SKILL.md) | Check whether the Meticulous CLI (@alwaysmeticulous/cli) and skills are installed and up to date, and install/update them if not. Invoked at the start of every other Meticulous skill, since the CLI and skills are under active development with frequent changes and improvements. | ## Contributing All Markdown, JSON and YAML in this repository is formatted with [oxfmt](https://www.npmjs.com/package/oxfmt), and CI enforces it: ```bash pnpm install pnpm format # format in place pnpm check-format # what CI runs ``` This isn't only about house style. Skills from this repository get installed into other repositories (via `npx skills add`), some of which run oxfmt over their whole tree — including the installed skill files. If a skill isn't already oxfmt-clean at the source, their formatter rewrites it on the way in, the installed copy no longer matches the upstream hash recorded in `skills-lock.json`, and every subsequent `npx skills update` there fights the formatter. Keeping the source formatted the same way avoids that entirely, so `.oxfmtrc.json` here mirrors the settings used in the repositories these skills are consumed from (notably `printWidth: 80`). ## License [ISC](https://github.com/alwaysmeticulous/skills/blob/HEAD/LICENSE) © Meticulous, Inc. DetailsTypePluginsTopicDeveloper toolsPublisheralwaysmeticulousSourcemarketplaceCategoryToolsStars10Copies (forks)3Proposed changes2Last update2026-10-27T11:56:32ZProject statusActiveLicenseISCAdded2026-08-30 01:48:58Updated2026-08-30 01:48:58Source idalwaysmeticulous/skills/meticulousMoreMore plugins on Developer toolsAll from alwaysmeticulousA–Z index
