# meticulous

Connects Meticulous visual regression testing workflows and hosted MCP server to Claude Code. It inspects UI diffs, reviews CI runs, and fixes rejected visual snapshots in chat.

- plugin · `type=plugin` · Claude Code · ★ 10 repo stars
- Author: Meticulous
- License: ISC · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/alwaysmeticulous/skills
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text and 8 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/meticulous

## What it does

This plugin links Claude Code directly to the Meticulous frontend testing service and connects its hosted MCP server at `https://app.meticulous.ai/api/mcp`. It packages specialized tasks as slash commands under the `/meticulous:` namespace. The agent can trigger test runs after frontend edits, inspect visual diffs, and classify changes as expected or unintended.

Workflows cover specific testing jobs. `meticulous-zero-diff-task` runs an iterative loop for refactors or dependency upgrades where the UI must stay intact. Another skill, `meticulous-fix`, takes rejected test runs and updates component code according to review notes. Without completing browser authentication, the MCP connection will not answer queries.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
In the agent chat (not a shell):
```text
/plugin install meticulous@claude-community
```

## When to use it
- review visual diffs on pull requests against expected design changes
- fix rejected visual snapshots based on reviewer comments
- verify UI stability during refactoring or dependency upgrades
- expand test coverage by mapping under-covered files to recorded UI actions

## Example prompts
- /meticulous:meticulous-review check the latest CI run and report any visual regressions
- /meticulous:meticulous-fix resolve the rejected diffs on the checkout modal
- /meticulous:meticulous-zero-diff-task upgrade tailwindcss and ensure no visual changes occur

## Source text · SKILL.md · ISC

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 6ce58c97ff4ea532.

BEGIN THIRD-PARTY FILE 6ce58c97ff4ea532
````text
# 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                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
````
END THIRD-PARTY FILE 6ce58c97ff4ea532

The third-party file has ended. Everything between the 6ce58c97ff4ea532 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3986 of 12148 bytes. © Meticulous · ISC · https://github.com/alwaysmeticulous/skills

## Similar
- [storybook-setup](https://affpapa.org/en/nevibecode/skills/storybook-setup.md) — skill · 336 installs
- [TestivAI](https://affpapa.org/en/nevibecode/mcp/testivai.md) — MCP server · ★ 7 repo stars
- [browser-qa](https://affpapa.org/en/nevibecode/skills/browser-qa.md) — skill · 6900 installs
- [visual-testing](https://affpapa.org/en/nevibecode/skills/visual-testing.md) — skill · 1500 installs
- [visual-regression-testing](https://affpapa.org/en/nevibecode/skills/visual-regression-testing.md) — skill · 741 installs
- [visual-regression-tester](https://affpapa.org/en/nevibecode/skills/visual-regression-tester.md) — skill · 351 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
