Communitygithub.com

xoai/sage

フレームワークに依存しないユニバーサルなウェブ開発原則 — アクセシビリティ(WCAG 2.2)、パフォーマンス(Core Web Vitals)、セキュリティヘッダー(OWASP)、SEO、レスポンシブデザイン、エラーUX、ローディング状態。

sage とは?

このスキルは、フレームワークに依存しない普遍的なウェブ開発のベストプラクティスをエンコードしたパックです。React、Vue、Svelte、バニラJSといったあらゆるプロジェクトに適用可能で、アクセシビリティ(WCAG 2.2)、パフォーマンス(Core Web Vitals)、セキュリティヘッダー(OWASP)、SEO、レスポンシブデザイン、エラーUX、ローディング状態をカバーします。エージェントが個別の知識は持っていても実践で一貫性を欠きがちな「知識と適用のギャップ」を埋めるために設計されており、具体的なパターン7つ、アンチパターン6つ、憲法7原則から構成されます。Claude Code、Cursor、Codexなど、スキルベースのAIエージェントで使用でき、プロジェクトの基盤となるウェブ知識を即座に注入します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xoai/sage/tree/HEAD/skills/web

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

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

ドキュメント

web

レイヤー1 — ドメイン基盤 (v2.0)

フレームワークに関係なく、すべてのウェブプロジェクトに適用されるユニバーサルなウェブ開発原則。 React、Vue、Svelte、バニラJS — これらの原則はどのフレームワークでも通用します。

哲学

このパックは、エージェントが個々には正しく理解しているものの、実際の開発では見落としがちな、ウェブプラットフォームの基礎知識をエンコードしています。エージェントはARIAラベルが何かを知っています。しかし、スクリーンリーダー向けのエラー通知がないフォームを生成してしまいます。エージェントはCore Web Vitalsを知っています。それでも寸法指定なしで2MBのヒーロー画像をレンダリングします。

問題は「知識」ではなく、「一貫した適用」です。

含まれる内容

タイプ数カバレッジ
パターン7アクセシビリティ(WCAG 2.2)、パフォーマンス(Core Web Vitals)、セキュリティヘッダー(OWASP)、SEO、レスポンシブデザイン、エラーUX、ローディング状態
アンチパターン6Divスープ、代替テキスト欠落、レイアウトシフト、保護されていないフォーム、クライアントのみのクリティカルパス、セキュリティヘッダーなし
憲法7原則

基盤とする資料:W3C WCAG 2.2(2023年10月)、Google Core Web Vitals(2025年)、 OWASP Secure Headers Project、OWASP CSP Cheat Sheet、MDN Web Docs、 Web Almanac 2025、European Accessibility Act(2025年6月)。

このパックがカバーしないこと

  • フレームワーク固有のパターン(react、nextjsなどを参照)
  • CSSメソッドの意見(BEM vs ユーティリティファースト vs CSS-in-JS)
  • ビルドツールの設定(Webpack、Vite、Turbopack)
  • バックエンド/APIパターン(apiまたはbaasを参照)

関連スキル