Communitygithub.com

website-audit

公開ウェブサイトの技術監査とコンバージョン監査を実施する読み取り専用スキルです。B2Bサイトのリビルド前のスナップショットとして、最大Nページ(デフォルト10)をヘッドレスChromeでクロールし、モバイルレイアウト、バグ、アクセシビリティ、パフォーマンス、リードパス、SEO基礎をチェックします。

website-audit とは?

このスキルは、公開ウェブサイトに対して完全に読み取り専用の技術監査およびコンバージョン監査を実施します。B2Bサイトのリニューアル前のスナップショットとして設計されており、ユーザーは「このサイトを監査して」「このURLをチェックして」などの自然言語で指示するだけで実行できます。監査はヘッドレスChromeを使用し、指定された同一オリジンページ(デフォルト10、最大25)をクロール。モバイルレイアウト(360/390/768px)、バグ(コンソールエラー、失敗リクエスト、リンク切れ、画像切れ)、アクセシビリティ(axe-core + WCAG 2.1 A/AA)、パフォーマンス(Lighthouseまたはブラウザタイミング)、コンバージョンパス(ファーストスクリーンCTA、2クリック以内の連絡先、信頼シグナル)、SEO基礎をチェックします。結果は1つのマークダウンレポートと生JSONとして出力され、スコア、P0-P3の所見(内容・場所・リード損失理由・修正方法)、スクリーンショットを含みます。Node.js 22以上とChromeが必要で、robots.txtを尊重し、フォーム送信やログインは一切行いません。このスキルはコピーライティング監査やデザインシステム生成とは異なります。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/victor-shulga/website-audit/tree/HEAD/skills/website-audit

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

website-audit は何をしますか?

1つのコマンドでサイトを測定し、スクリプトで判断できない部分を確認した上で、創業者がすぐに行動できるレポートを提供します。監査は読み取り専用です:フォームを送信したり、ログインしたり、状態を変更するクリックを一切行わず、robots.txtを尊重し、ページ読み込み間に待機時間を入れます。

入力

  • URL(必須)。ユーザーが指定していない場合は確認します。
  • ページ数制限(オプション、デフォルト10)。簡単な確認には3〜5、リビルド前の完全なベースラインには15〜25を使用します。
  • レポートの言語(オプション、デフォルトはユーザーが使用している言語)。

必要条件

  • Node.js 22以降(node --version)。Lighthouseは追加でNode ≥ 22.19とnpm(npx)が必要です。
  • Google ChromeまたはChromium。macOS、Linux、Windowsで自動検出されます(npx playwright install chromiumでダウンロードしたChromiumも含む)。それ以外の場合はCHROME_BIN=/path/to/chromeを設定します。
  • 監査対象サイトへのネットワークアクセス、および公開npm CDN(axe-core)とnpmレジストリ(Lighthouse)へのアクセス。どちらかのツールが取得できない場合、その項目はレポートでスキップされた旨と理由が記載され、実行自体は失敗しません。

手順

1. 監査の実行

<skill-dir>はこのSKILL.mdが存在するフォルダです。

node <skill-dir>/scripts/audit.mjs https://example.com --limit 10

オプション:--limit N · --delay MS(ページ間の待機時間、デフォルト1000) · --max-links N(内部リンクチェック数、デフォルト150) · --no-lighthouse · --no-axe · --max-minutes N(デフォルト15) · --out DIR。

出力先はカレントフォルダからの相対パス./website-audit/<ドメイン>/(--outまたはWEBSITE_AUDIT_OUT環境変数で上書き可能):

  • website-audit-<ドメイン>-<日付>.md:レポート
  • website-audit-<ドメイン>-<日付>.json:生の測定値、所見、スコア、スナップショット
  • screens/:各ページのファーストスクリーンショット(デスクトップおよび390px)

進捗はstderrに出力されます。最後のstdout行はJSONサマリーです(ok、report、pages、seconds、overall、counts、scores、skipped)。終了コード2は監査がまったく実行できなかったことを意味します(Node 22なし、Chromeなし、サイト到達不能):ユーザーにメッセージを表示し、何をインストールまたは確認すべきかを伝えます。

10ページの実行には約2〜4分かかります。Lighthouseにより30〜60秒追加されます。

2. 手動レビューのパス

<skill-dir>/references/manual-review.md に従います:

  1. すべてのP0が証拠と一致することを確認します(スクリプトは文字通り解釈するため、ボット対策やJavaScriptフォームによってP0が誤検出される可能性があります)。
  2. 「手動で確認」とマークされた各項目を、screens/のスクリーンショットを見て解決します。
  3. 「Fix first」がリビルドの最初のスプリントとして読めることを確認します。

マークダウンレポートをその場で編集します。JSONは変更しないでください。これは生のベースラインです。

3. 言語

スクリプトは英語で出力します。ユーザーが別の言語で記述している場合は、レポートの見出し、「なぜリードにとって重要なのか」および「Fix」の行を翻訳します。URL、セレクター、メトリクス名、HTTPコード、P0〜P3のラベルはそのままにします。

4. 引き渡し

以下の内容で返信します:全体スコア、P0 / P1の件数、「Fix first」リスト、スキップされた項目とその理由、レポートへのパス。後日、新しいサイトで同じ制限で再実行し、スナップショットの「after」列を埋めることを提案します。

ユーザーがしきい値を編集して再レンダリングを希望する場合: node <skill-dir>/scripts/report.mjs <パス-to-run>.json でJSONからマークダウンを再生成します。

各領域の内容

詳細、しきい値、優先順位ルールは<skill-dir>/references/checks.mdにあります。簡潔にまとめると:

領域方法
モバイルレイアウト各ページを360 / 390 / 768pxで確認:横スクロール、画面端からはみ出る要素、viewport meta、タップターゲット、小さなテキスト
バグコンソールエラーと例外、4xx/5xxおよび失敗リクエスト、 mixed content、画像切れ、内部リンク(HEAD/GET)、フォームターゲット(HEADのみ)
アクセシビリティaxe-coreを各ページに注入、WCAG 2.0/2.1 A + AAタグ
パフォーマンスホームページのLighthouseモバイル;すべてのページのブラウザタイミング(TTFB、LCP、CLS、重さ、リクエスト数)
コンバージョンパスデスクトップと電話でのファーストスクリーンCTA、連絡先までのクリック数、メール/電話/予約/リードフォーム、 testimonial、事例、ロゴ、数字
SEO基礎title、description、1つのH1、canonical、Open Graph、noindex、robots.txt、sitemap.xml

ルール

  • フォームの送信、記入、クリックを絶対に行わないでください。ログインも行わないでください。ボット対策やCAPTCHAをバイパスしないでください。サイトがチャレンジページを表示した場合は、その旨を報告して停止します。
  • robots.txtのdisallowルールを尊重し、ユーザーがサイト所有者でかつ高速実行を依頼した場合を除き、デフォルトの遅延を維持します。
  • 「手動で確認」とマークされた所見は、スクリーンショットを確認するまでは仮説です。
  • レポートを自身で公開しないでください。クライアントの弱点を記述している可能性があります。

このスキルではありません

  • コピー、ポジショニング、メッセージの批評 → website-copy-reframe
  • サイトからのブランド/デザインシステム → design-system-generator
  • キーワード順位、バックリンク、トラフィック推計 → SEOデータツール

関連スキル