using-meticulous
Using Meticulous
Meticulous records user sessions and replays them to catch visual regressions. These skills cover end-to-end workflows for testing frontend changes and investigating diffs.
Available Skills
| Skill | When to use |
|---|---|
| test-with-meticulous | Full testing workflow: build and upload artifacts, trigger a cloud test run, inspect DOM and pixel diffs, diagnose unexpected changes, and produce a final report. Start here for any frontend change that needs visual regression testing. |
| simulate-and-diff | Run a single session simulation against a live URL and analyze the resulting visual diffs (pixel + HTML). Use when you already have a sessionId and want to debug one specific session locally rather than running the full test suite. |
Quick Decision Guide
- "I changed frontend code and want to check for regressions" → test-with-meticulous
- "I have a specific session and want to replay it locally against my dev server" → simulate-and-diff
CLI Reference
These skills build on the meticulous-cli command reference skills. For full option details on any CLI command, see the corresponding meticulous-cli-* skill (auth, ci, download, project, record, simulate, schema).
More from alwaysmeticulous/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.
25test-with-meticulous
Run after implementing any frontend change to verify its visual impact. Triggers a Meticulous test run, then inspects screenshot diffs to classify each visual change as intended or unintended. Use this before marking a frontend task as complete.
21meticulous-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.
20meticulous-cli-schema
Meticulous CLI schema command for outputting the full CLI command structure as JSON. Use when you need to programmatically inspect available commands and their options, or when building tooling that drives the Meticulous CLI.
19meticulous-cli-download
Meticulous CLI download commands for fetching recorded sessions, replays, and test runs to the local data directory. Covers `meticulous download session`, `meticulous download replay`, and `meticulous download test-run`.
19meticulous-cli-auth
Meticulous CLI authentication commands. Use when logging in, checking who is authenticated, or logging out of the Meticulous CLI. Covers `meticulous auth whoami` and `meticulous auth logout`.
19