{ "markdown": "# Meticulous Agent Skills\n\nA collection of agent skills for [Meticulous](https://meticulous.ai) — the automated visual regression testing platform for web frontends.\n\nThese skills enable AI coding assistants (Cursor, Claude Code, etc.) to use Meticulous: review test runs, investigate replays, debug diffs, etc.\n\n## Setup\n\nFull 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.\n\nThe short version:\n\n```bash\n# 1. Install/update the Meticulous CLI\nnpm install --global @alwaysmeticulous/cli@latest\n\n# 2. Authenticate (opens a browser to sign in and pick a default project)\nmeticulous auth login\n\n# 3. Install these skills into your project\nnpx skills add alwaysmeticulous/skills --skill \"*\" --agent claude-code --agent codex --agent cursor -y\n```\n\n### Claude Code plugin\n\nThis 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:`) and automatically connects the hosted [Meticulous MCP server](https://app.meticulous.ai/api/mcp). To install, run in Claude Code:\n\n```shell\n/plugin marketplace add alwaysmeticulous/skills\n/plugin install meticulous@meticulous\n```\n\nThen 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).\n\n### Cursor Marketplace\n\nThis 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.\n\n## Skills\n\nSkills 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.\n\nSkills follow the [`SKILL.md` format](https://docs.cursor.com/context/rules-for-ai) used by Cursor and Claude Code.\n\n| Skill | Description |\n| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| **Review skills** | |\n| [`meticulous-review`](skills/meticulous-review/SKILL.md) | Analyze a completed Meticulous test run — compare the diffs against the PR description to see what's expected, then focus on finding and flagging potential regressions. Use when asked to review Meticulous test results, right after implementing a frontend change, or while babysitting a pull/merge request's Meticulous Tests CI check. |\n| [`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. |\n| [`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. |\n| [`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. |\n| [`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. |\n| [`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. |\n| [`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. |\n| [`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. |\n| **Supporting skills** | |\n| [`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. |\n| [`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. |\n\n## Contributing\n\nAll Markdown, JSON and YAML in this repository is formatted with\n[oxfmt](https://www.npmjs.com/package/oxfmt), and CI enforces it:\n\n```bash\npnpm install\npnpm format # format in place\npnpm check-format # what CI runs\n```\n\nThis isn't only about house style. Skills from this repository get installed\ninto other repositories (via `npx skills add`), some of which run oxfmt over\ntheir whole tree — including the installed skill files. If a skill isn't\nalready oxfmt-clean at the source, their formatter rewrites it on the way in,\nthe installed copy no longer matches the upstream hash recorded in\n`skills-lock.json`, and every subsequent `npx skills update` there fights the\nformatter. Keeping the source formatted the same way avoids that entirely, so\n`.oxfmtrc.json` here mirrors the settings used in the repositories these skills\nare consumed from (notably `printWidth: 80`).\n\n## License\n\n[ISC](LICENSE) © Meticulous, Inc.\n", "bytes": 11023, "sha": "ebc22fc409516a3468349588357eec626dec946f1580a9baadeefe7b0a52c00c", "repo_slug": "alwaysmeticulous/skills", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/skl_alwaysmeticulous_skills_meticulous_simul_b3a72d4e/readme" }