К основному содержанию
плагин

meticulous — плагин для Claude Code: что делает и как установить

Подключает сценарии визуального регрессионного тестирования Meticulous и MCP-сервер к Claude Code. Помогает проверять диффы вёрстки, разбирать падения тестов и править отклонённые экраны.

ISC ★ 10 обновлён 2026-10-22

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install meticulous@claude-community
Открыть на GitHub

Что делает meticulous

Плагин связывает ассистента с платформой визуального тестирования Meticulous и hosted MCP-сервером https://app.meticulous.ai/api/mcp. В набор входят готовые воркфлоу в формате SKILL.md, доступные в виде команд с префиксом /meticulous:. Они позволяют запускать прогоны после правок кода, сопоставлять изменения интерфейса с задачей PR и передавать найденные баги на доработку.

Среди сценариев есть meticulous-zero-diff-task для рефакторинга и обновления библиотек, где интерфейс обязан остаться прежним, и meticulous-fix для исправления отклонённых скриншотов. Без авторизации в Meticulous через браузер удалённый MCP-сервер работать не будет.

Какие задачи решает

  • проверять визуальные диффы вёрстки после правок в pull request
  • исправлять отклонённые при ревью скриншоты по комментариям
  • контролировать неизменность интерфейса при рефакторинге и обновлении библиотек
  • находить и закрывать пробелы в тестовом покрытии экранов

Примеры запросов агенту

  • /meticulous:meticulous-review проверь результаты последнего прогона CI и покажи регрессии
  • /meticulous:meticulous-fix исправь отклонённые диффы на странице оформления заказа
  • /meticulous:meticulous-zero-diff-task обнови зависимости в package.json без изменений в UI

Как установить meticulous

Через маркетплейс плагинов

/plugin marketplace add anthropics/claude-plugins-community
/plugin install meticulous@claude-community

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о meticulous

Как установить meticulous в Claude Code?

Выполните в Claude Code последовательно две команды: /plugin marketplace add anthropics/claude-plugins-community, а затем /plugin install meticulous@claude-community. После этого авторизуйте hosted MCP-сервер через меню команды /mcp.

Что делает плагин meticulous?

Он даёт агенту готовые навыки для работы с визуальными регрессионными тестами Meticulous. Ассистент разбирает диффы, находит баги вёрстки и правит код интерфейса по результатам прогонов.

Нужна ли авторизация для работы плагина?

Да, плагин подключает удалённый MCP-сервер Meticulous, который требует авторизации через браузер. Войти в аккаунт можно через команду /mcp в Claude Code или через консольную утилиту meticulous auth login.

Исходный текст

SKILL.md · ISC
# 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`](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`](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`](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`](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`](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`](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`](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`](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`](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`](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`](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](LICENSE) © Meticulous, Inc.

© Meticulous · ISC · alwaysmeticulous/skills

Похожие плагины

Все плагины по теме «Тесты и QA» →
storybook-setup patricio0312rev Скилл storybook-setup настраивает Storybook для документации компонентов, интерактивных контролов, accessibility-проверок и визуальной регрессии. CX Codex +1 336установок TestivAI testivai TestivAI показывает ИИ-агенту результаты визуальных регрессионных тестов: снимки, diff и причины изменений. Подходит для проверки UI после правок. CX Codex +1 ★ 7звёзд репо browser-qa affaan-m Скилл browser-qa гоняет живой интерфейс через браузерный MCP: ошибки в консоли, Core Web Vitals, формы, скриншоты на трёх ширинах и axe-core. Выносит вердикт SHIP или DO NOT SHIP. CX Codex +1 6 900установок visual-testing kindlmann Скилл visual-testing для визуального регрессионного тестирования: сравнивает скриншоты с эталонами и ловит различия на уровне пикселей, которые пропускают функциональные тесты. CX Codex +1 1 500установок visual-regression-testing aj-geddes Скилл visual-regression-testing ловит случайные визуальные изменения интерфейса: снимает скриншоты компонентов и страниц и сравнивает их между версиями. CX Codex +1 741установок visual-regression-tester patricio0312rev Скилл visual-regression-tester настраивает визуальное регрессионное тестирование: снимает скриншоты, сравнивает их с базовыми и ловит случайные изменения интерфейса. CX Codex +1 351установок

Из того же набора12

Весь набор →
meticulous-iterative-dev Скилл meticulous-iterative-dev ведёт многошаговую правку фронтенда и после каждого шага сверяет картинку с записанными сессиями Meticulous, чтобы регрессии всплывали сразу. CX Codex +1 9 100установок meticulous-simulate-and-diff Скилл meticulous-simulate-and-diff запускает симуляцию сессии в Meticulous на живом URL и находит визуальные регрессии через сравнение скриншотов или разбор HTML-разметки. CX Codex +1 9 100установок meticulous-review Скилл meticulous-review разбирает результаты Meticulous, проверяет визуальные диффы и сбои проверок относительно задачи PR. Пригодится после изменений фронтенда и при проблемах с CI. CX Codex +1 9 100установок meticulous-use-session-data Скилл meticulous-use-session-data для Claude Code, Codex, Cursor и других IDE скачивает структурированные данные сессий Meticulous — записанные потоки пользователя и моки сетевых запросов. CX Codex +1 9 000установок meticulous-fix Скилл meticulous-fix исправляет отклонённые визуальные различия и сбои проверок Meticulous. Он нужен после ревью тестового запуска. CX Codex +1 5 100установок meticulous-zero-diff-task Скилл meticulous-zero-diff-task организует цикл рефакторинга или обновления библиотек во фронтенде, проверяя визуальные регрессии через Meticulous до открытия PR. CX Codex +1 5 000установок meticulous-increase-coverage Скилл meticulous-increase-coverage для Meticulous: находит файлы без покрытия, привязывает их к реальному действию в интерфейсе и подтверждает рост покрытия сравнением с базой. CX Codex +1 3 000установок meticulous-improve-test-env Скилл meticulous-improve-test-env для Claude Code находит причины блокировок Agent swarm в живом тестовом контуре. Анализирует нехватку сид-данных, права тестовых аккаунтов и флаги фичей. CX Codex +1 129установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой