AgentToolHub
SkillClaude CodeCursorClineOpenClawWindsurfVS CodeChatGPT

meticulous-review

meticulous-review — a Claude Code skill from alwaysmeticulous/skills

Features

  • ✓Automated visual regression testing for web frontends
  • ✓Enhanced AI coding assistants with Meticulous skills
  • ✓Review test runs and investigate replays
  • ✓Debug diffs and streamline workflows
  • ✓Curated collection of skills for Meticulous CLI integration

Installation Guide

1. Install/update the Meticulous CLI

The Meticulous CLI is required to run simulations and test runs from the command line:

bash
npm install --global @alwaysmeticulous/cli@latest

You can also install it locally per-project instead of globally.

The CLI is under active development with frequent changes and improvements — re-run the same command to update to the latest version. The skills in this repo also invoke the [meticulous-cli-update](meticulous-cli-update/SKILL.md) skill at the start of every workflow to keep this in sync automatically.

2. Authentication

Authenticate the CLI with your Meticulous account:

bash
meticulous auth whoami

This will open a browser to sign in if you're not already authenticated. If you're a member of multiple projects, also run meticulous auth set-project to pick which one to use (it's an interactive prompt).

Alternatively, use an API token (see the docs for how to grab one) — either via the METICULOUS_API_TOKEN environment variable, or by storing {"apiToken": "xyz..."} in ~/.meticulous/config.json.

3. Install skills

Install skills into your project using npx skills:

bash
# Claude Code only: create .claude/ first if it doesn't already exist
mkdir -p .claude

# Install all skills for the specified agents
npx skills add alwaysmeticulous/skills --all --agents claude-code,codex,cursor

# Update already-installed skills to the latest version
npx skills update --project

4. Agent permissions

The Meticulous skills run a small set of CLI commands and read downloaded screenshots from ~/.meticulous/agent-images/. Pre-allowing these in your agent configuration avoids repeated permission prompts during a session.

#### 4.1 Claude Code

Add the following to .claude/settings.json (project-level) or ~/.claude/settings.json (user-level). Replace /HOME/DIR with your home directory path (e.g. /Users/alice).

json
{
  "permissions": {
    "allow": [
      "Read(~/.meticulous/agent-images/**)",
      "Bash(meticulous *)",
      "Skill(meticulous-cli-update)",
      "Bash(npm view @alwaysmeticulous/cli version)",
      "Bash(npm install --global @alwaysmeticulous/cli@latest)",
      "Bash(npx skills update --project)"
    ]
  }
}

#### 4.2 Codex

Add the following to ~/.codex/rules/default.rules:

starlark
prefix_rule(pattern=["meticulous"], decision="allow")
prefix_rule(pattern=["npm", "view", "@alwaysmeticulous/cli", "version"], decision="allow")
prefix_rule(pattern=["npm", "install", "--global", "@alwaysmeticulous/cli@latest"], decision="allow")
prefix_rule(pattern=["npx", "skills", "update", "--project"], decision="allow")

#### 4.3 Cursor

Add the following entries to Cursor's Command Allowlist:

bash
meticulous
npm view @alwaysmeticulous/cli version
npm install --global @alwaysmeticulous/cli@latest
npx skills update --project

Reviews