Meticulous

Meticulous エージェントスキル

Meticulous 向けエージェントスキルのコレクションです。Meticulous は、Web フロントエンド向けの自動ビジュアルリグレッションテストプラットフォームです。

これらのスキルにより、AI コーディングアシスタント（Cursor、Claude Code など）が Meticulous を使って、テスト実行の確認、リプレイの調査、差分のデバッグなどを行えるようになります。

セットアップ

セットアップ手順の詳細は、Meticulous のドキュメントにあります。app.meticulous.ai/docs/agents/setup では、CLI のインストール、認証、これらのスキルのインストールについて説明しています。

概要は以下のとおりです。

# 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 プラグイン

このリポジトリは Claude Code プラグインとしてもパッケージ化されており、以下のすべてのスキル（/meticulous:<skill-name> として名前空間が設定されています）をインストールし、ホスト型の Meticulous MCP サーバーに自動的に接続します。インストールするには、Claude Code で次のコマンドを実行します。

/plugin marketplace add alwaysmeticulous/skills
/plugin install meticulous@meticulous

次に /mcp と入力し、Meticulous MCP サーバーの Authenticate を選択します（ログインはブラウザーで行います。CLI の meticulous auth login ですでに認証している場合は不要です）。

Codex プラグイン

このリポジトリは Codex プラグインとしてもパッケージ化されており、以下のすべてのスキルをインストールし、ホスト型の Meticulous MCP サーバーに自動的に接続します。インストールするには、次のコマンドを実行します。

codex plugin marketplace add alwaysmeticulous/skills
codex plugin add meticulous@meticulous

次に codex mcp login meticulous を実行して MCP サーバーを認証します（ログインはブラウザーで行います）。後から加えられた変更を反映するには、codex plugin marketplace upgrade meticulous を実行します。

Cursor Marketplace

このリポジトリは Cursor プラグインとしてもパッケージ化されています。Cursor Marketplace に掲載されると、Cursor ユーザーは npx skills を使わずに、Customize → Plugins から（またはマーケットプレイスで検索して）Meticulous スキルをインストールできます。複数のエージェントで同じスキルを使う必要がある場合は、引き続き上記の npx skills の方法を推奨します。

スキル

スキルは、AI コーディングアシスタントに分野固有の知識と段階的なワークフローを提供する Markdown ファイルです。エージェントがスキルを読み込むと、すべての会話にそのコンテキストを組み込むことなく、特定のタスクに関する専門知識を得られます。

スキルは、Cursor と Claude Code で使用される SKILL.md format に準拠しています。

スキル	説明
レビュー用スキル
meticulous-review	Meticulous のテスト実行結果を確認し、レビュー状態に応じて対応します。未レビューの差分を PR で変更する意図と照らし合わせてレビューし、潜在的なリグレッションを指摘します。PR のコードを作業している場合は、修正が必要な内容を meticulous-fix に引き継ぎます。テスト実行結果が重要な場合に使用します。たとえば、プルリクエスト／マージリクエストをレビューするとき、フロントエンドの変更をプッシュした直後、Meticulous CI チェックが失敗または保留中のとき、あるいは Meticulous の結果を確認するよう依頼されたときです。
meticulous-fix	テスト実行でレビューされ、却下されたビジュアル差分を、レビューコメントがあればそれに従って修正します。ユーザーがテスト実行結果をレビューし、修正の実装をエージェントに引き継ぐとき、または meticulous-review から修正が必要な内容を引き継いだときに使用します。
meticulous-test	フロントエンドの変更を実装した後に Meticulous のテストを実行し、各ビジュアル変更が意図したものか意図しないものかを分類するために、meticulous-review スキルへ引き継ぎます。
meticulous-zero-diff-task	最初から最後までビジュアル差分が発生しない想定のタスクを実装します。Meticulous を使って差分がなくなるまで反復し、その後 PR を作成します。タスクの前提全体が「UI は変わらないはず」という場合、たとえば依存関係／バージョンのアップグレード、コードのリファクタリング、移行などに使用します。
meticulous-increase-coverage	Meticulous プロジェクトで、カバレッジが不足している特定のファイルをコードベース内の実際の UI 操作までたどり、その操作を実際に記録したブラウザーセッションで実行し、カバレッジ比較がクリーンであることを検証して、カバレッジを高めます。また、ブラウザー内では構造上実行されないコードについて、.meticulousignore エントリーを提案する PR も作成します。プロジェクトの「カバレッジを高める」「テストされていないコードを見つける」「.meticulousignore エントリーを追加する」よう依頼されたときに使用します。
meticulous-iterative-dev	Meticulous を使って各ステップでビジュアル検証を行う、反復的なフロントエンド開発ワークフローです。複数ステップにわたるフロントエンド変更を実装し、最終的なクラウドテストを実行する前に、各ステップでビジュアルリグレッションや意図しない副作用を検出したいときに使用します。
meticulous-simulate-and-diff	実行中の URL に対して Meticulous セッションシミュレーションを実行し、スクリーンショットを直接確認する（クイックチェックモード）か、ベースのリプレイとピクセルおよび HTML の差分を比較して、ビジュアル出力を分析します。特定のセッションでコード変更によるビジュアルリグレッションが発生したか確認するときに使用します。
meticulous-use-session-data	構造化された Meticulous セッションデータ（ユーザーフローとネットワークモック）をダウンロードし、コード変更のローカルテストに使用します。テストで対象となるユーザー操作や API 呼び出しを把握する必要があるときや、テスト作成にネットワークモックを使いたいときに使用します。
meticulous-improve-test-env	ライブバックエンドに対するテストで Agent swarm がブロックされないよう、プロジェクトのテスト環境で何を変更すべきかを調べます。テストデータの改善、テストユーザーの権限拡大、フィーチャーフラグの有効化、テストログインの修正などを行います。Agent swarm が記録したセットアップ上のブロッカーを読み取り、コードベースとテスト環境の設定を調査して、具体的な修正案を提示します。
補助スキル
meticulous-cli	Meticulous CLI ツールとそのグローバルオプションの概要です。meticulous CLI 全般、利用可能なコマンド、またはすべてのコマンドに適用されるグローバルフラグについて尋ねられたときに使用します。
meticulous-cli-update	Meticulous CLI (@alwaysmeticulous/cli) とスキルがインストール済みで最新かどうかを確認し、そうでない場合はインストールまたは更新します。CLI とスキルは活発に開発され、頻繁に変更・改善されているため、他のすべての Meticulous スキルの開始時に呼び出されます。

コントリビュート

このリポジトリ内のすべての Markdown、JSON、YAML は oxfmt でフォーマットされており、CI でその遵守を徹底しています。

pnpm install
pnpm format        # format in place
pnpm check-format  # what CI runs

これは単なる独自のスタイルに関する話ではありません。このリポジトリのスキルは、npx skills add を介してほかのリポジトリにインストールされます。その中には、インストールしたスキルファイルを含むツリー全体に oxfmt を適用するものもあります。スキルがソースで oxfmt に準拠していないと、インストール時にフォーマッターによって書き換えられ、インストール先のコピーが skills-lock.json に記録されたアップストリームのハッシュと一致しなくなり、その後の npx skills update のたびにフォーマッターと競合します。ソースも同じ方法でフォーマットしておけば、この問題を完全に避けられます。そのため、ここにある .oxfmtrc.json は、これらのスキルが利用されるリポジトリで使われている設定（特に printWidth: 80）を反映しています。

ライセンス

ISC © Meticulous, Inc.