Communitygithub.com

DDS-Solutions/AI-TadPole-OS

UIコードをWebインターフェースガイドラインに準拠しているかレビューします。「UIをレビューして」「アクセシビリティを確認」「デザインを監査」「UXをレビュー」「ベストプラクティスに沿ってサイトをチェック」といった依頼に使用します。

AI-TadPole-OS とは?

このスキルは、開発者が作成したUIコードを、Vercel Labsが提供するWebインターフェースガイドラインに照らして自動レビューするためのエージェントスキルです。主にClaude CodeやCoder上で動作し、コードがアクセシビリティ、パフォーマンス、ユーザビリティのベストプラクティスに準拠しているかをチェックします。動作はシンプルで、指定されたURLから最新のガイドラインをフェッチし、ユーザーが指定したファイル群を読み込んで、各ルールに違反していないかを検証します。結果は `file:line` 形式で出力されるため、開発者は問題のある箇所を即座に特定し修正に取り掛かれます。ファイルが指定されなかった場合は、ユーザーにレビュー対象を尋ねる対話的な動作もサポートしています。また、このスキルはフロントエンドデザインの学習スキル(frontend-design)と連携し、「デザイン→コーディング→監査→修正」という一貫した開発ワークフローを実現します。AIエージェントが設計段階から品質保証までを統合的に支援する点が大きな強みです。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DDS-Solutions/AI-TadPole-OS/tree/HEAD/.agent/skills/web-design-guidelines

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

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

ドキュメント

[!IMPORTANT] AIコンテキストと知識の継承

  • サブシステム: Agent Skills Registry / web-design-guidelines
  • アーキテクチャ: @docs ARCHITECTURE:Documentation
  • 障害パス: 情報のずれ、レガシー用語、ドキュメントの不一致
  • 観測可能性: execution/parity_guard.py によるトレーサビリティ([SKILL])

Webインターフェースガイドライン

ファイルがWebインターフェースガイドラインに準拠しているかレビューします。

動作の仕組み

  1. 以下のソースURLから最新のガイドラインを取得
  2. 指定されたファイル(またはユーザーにファイル/パターンを促す)を読み込む
  3. 取得したガイドラインのすべてのルールに対してチェックを実行
  4. 簡潔な file:line 形式で結果を出力

ガイドラインのソース

各レビューの前に最新のガイドラインを取得してください:

https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md

最新のルールを取得するにはWebFetchを使用してください。取得したコンテンツにはすべてのルールと出力形式の指示が含まれています。

使用方法

ユーザーがファイルまたはパターン引数を指定した場合:

  1. 上記のソースURLからガイドラインを取得
  2. 指定されたファイルを読み込む
  3. 取得したガイドラインのすべてのルールを適用
  4. ガイドラインで指定されている形式で結果を出力

ファイルが指定されなかった場合は、レビューするファイルをユーザーに尋ねてください。


関連スキル

スキル使用タイミング
frontend-designコーディング前 - デザイン原則(色、タイポグラフィ、UX心理学)を学ぶ
web-design-guidelines(これ)コーディング後 - アクセシビリティ、パフォーマンス、ベストプラクティスを監査する

デザインワークフロー

1. デザイン → frontend-designの原則を読む
2. コーディング → デザインを実装する
3. 監査    → web-design-guidelinesレビューを実行 ← ここ
4. 修正    → 監査結果に対処する

関連スキル