Communitygithub.com

clawic/skills

モダンなベストプラクティスに従い、高速でアクセシブル、SEOに強いウェブサイトを構築します。

skills とは?

このスキルは、開発者が最新のウェブ標準に沿った高品質なウェブサイトを制作するための包括的なルール集です。パフォーマンス最適化、モバイルファースト設計、アクセシビリティ、セマンティックなHTML構造、効率的なCSSパターン、そして避けるべき一般的なミスについて詳細にカバーしています。画像の次世代フォーマットへの変換やレンダリングブロッキングリソースの遅延読み込みといった技術から、カラーのコントラスト比の確保やキーボードナビゲーションのテストに至るまで、具体的で実践的なアドバイスを提供します。Launch前のチェックリストも含まれており、プロダクション品質のサイトを確実にリリースするためのガイドラインとして機能します。このスキルは、CursorやClaude CodeのようなAIエージェントがコードレビューや新規プロジェクトの初期設定を行う際に参照することを想定しており、開発チーム全体で一貫したコーディング規約を維持するのに役立ちます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/clawic/skills/tree/HEAD/skills/website

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

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

ドキュメント

ウェブサイト開発ルール

パフォーマンス

  • 画像はサイトが遅くなる最大の原因です — WebP/AVIFを使用し、ファーストビューより下の画像は遅延読み込みし、明示的な幅/高さを設定してレイアウトシフトを防ぐこと
  • レンダリングをブロックするCSSはファーストペイントを遅らせます — 重要なCSSは<head>にインライン化し、残りは遅延読み込みすること
  • サードパーティスクリプト(アナリティクス、チャットウィジェット)はしばしば500ms以上のオーバーヘッドを追加します — asyncまたはdeferで読み込み、定期的に監査すること
  • フォントは不可視テキストのフラッシュ(FOIT)を引き起こします — font-display: swapを使用し、重要なフォントをプリロードすること
  • シークレットモードでLighthouseを使用して測定すること — 拡張機能は結果を歪めます

モバイルファースト

  • CSSはモバイルスタイルから始め、min-widthメディアクエリで複雑さを追加すること — 拡張は削減より簡単です
  • タッチターゲットは最低44x44pxが必要です — 指は不正確で、小さなボタンはユーザーをイライラさせます
  • ブラウザのDevToolsだけでなく、実際のデバイスでテストすること — スロットリングのシミュレーションは実際のジャンクを見逃します
  • 横スクロールは重大なバグです — すべてのページを最低320px幅でテストすること
  • viewportメタタグは必須です: <meta name="viewport" content="width=device-width, initial-scale=1">

アクセシビリティ

  • すべての<img>にはaltテキストが必要です — 装飾画像には空のalt=""、意味のある画像には説明的なテキストを設定すること
  • 本文テキストのカラーコントラスト比は最低4.5:1 — WebAIMのコントラストチェッカーを使用すること
  • フォーム入力には関連付ける<label>要素が必要です — プレースホルダーだけではアクセシブルではありません
  • キーボードナビゲーションは機能しなければなりません — Tabキーですべてのインタラクティブ要素をテストすること
  • スクリーンリーダーは見出し階層をアナウンスします — H1〜H6を論理的な順序で使用し、レベルをスキップしないこと

HTML構造

  • ページごとに<h1>は1つだけ — これはページタイトルであり、スタイリングツールではありません
  • セマンティック要素を使用すること: <nav>、<main>、<article>、<aside>、<footer> — これらはブラウザや支援技術に構造を伝えます
  • アクションには<button>、ナビゲーションには<a> — クリックハンドラ付きのdivは使用しないこと
  • 外部リンクにはrel="noopener"を設定すること — target="_blank"によるセキュリティ脆弱性を防ぎます
  • HTMLを検証すること — 壊れたマークアップはブラウザ間で予測不能なレンダリングを引き起こします

CSSパターン

  • !importantを避けること — カスケードを壊し、デバッグを困難にします。代わりに詳細度を修正すること
  • テキストには固定pxではなく相対単位(rem、em、%)を使用すること — ユーザーのフォントサイズ設定を尊重します
  • CSSカスタムプロパティ(変数)は繰り返しを減らします — 色とスペーシングを一度定義し、どこでも使用すること
  • 1DレイアウトにはFlexbox、2DレイアウトにはGrid — 一方に他方の役割を強制しないこと
  • CSSが読み込まれない状態でテストすること — コンテンツはプレーンなHTMLでも読み取り可能であるべきです

よくある間違い

  • ファビコンがないとサーバーログに404エラーが大量に発生します — 常に含めること。単純なPNGでも構いません
  • <html lang="en">を設定しないと、スクリーンリーダーの発音がおかしくなります
  • ハードコードされたhttp://リンクはHTTPSサイトで壊れます — プロトコル相対//または常にhttps://を使用すること
  • JavaScriptが利用可能であると仮定しないこと — コアコンテンツはJSなしでも動作するべきです(プログレッシブエンハンスメント)
  • 印刷スタイルを忘れている — ユーザーが印刷する可能性のあるページ(レシート、記事)には@media printを追加すること

ローンチ前

  • すべてのフォームが実際に送信されるかテストすること — 壊れたお問い合わせフォームはリードを静かに失います
  • 404ページが存在し、役立つことを確認すること — デフォルトのサーバー404はプロフェッショナルではない印象を与えます
  • Open Graphタグでソーシャルシェアプレビューを検証すること — Facebook/Twitterのデバッガーでテストすること
  • Google Search Consoleにサイトマップを送信すること — インデックスを高速化します
  • アップタイム監視を設定すること — ユーザーから聞く前にサイトダウンを把握します

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

clawic/skills

Build high-converting landing pages with proven structure, persuasive copy, and conversion optimization.

clawic/skills

Complete MBA curriculum with structured learning, case studies, financial analysis, and practical business decision-making.

clawic/skills

Orchestrates the announcement, assets, channels, and timing for shipping a product, covering the arc from teaser to launch day to post-launch momentum.

clawic/skills

Translates and localizes text, software strings, documents, subtitles, and marketing copy between any language pair. Use when translating anything, when fixing a translation that reads machine-made, or when localizing a product: ICU plurals and gender, placeholders that must survive, string catalogs (JSON, XLIFF, .po, .strings, .xcstrings, ARB, RESX, YAML), locale codes and fallback chains, RTL and bidi breakage, CJK typography, mojibake, text expansion that overflows the UI, subtitle timing and reading speed, hreflang and multilingual SEO, glossaries, translation memory and fuzzy matches, and post-editing machine output. Use when choosing register (tu/vous, tú/usted, du/Sie, keigo), between es-ES and es-419 or zh-Hans and zh-Hant, or when a certified, legal, or medical translation carries liability. Not for writing original copy natively in one language (spanish, french, german, japanese, chinese) or generating captions from audio (video-captions).

clawic/skills

Create viral user-generated content for marketing with effective hooks, formats, and creator strategies.

clawic/skills

Generate professional captions and subtitles with multi-engine transcription, word-level timing, styling presets, and burn-in. Use for TikTok/Reels/Shorts mute-safe captions.

関連スキル