Communitygithub.com

ランディングページ構築スキル

プレーンHTML、Astro、Next、Vite + React、Tailwindでランディングページのコード実装を行う際に使用します。HTML構造、CSS、レスポンシブレイアウト、フォント、画像、メタタグ、ソーシャルカード、構造化データ、リード獲得フォーム、アクセシビリティ、読み込みパフォーマンスなどを扱います。

ランディングページ構築スキル とは?

このスキルは、承認されたコピー、ビジュアルディレクション、デザイントークンを基に、JavaScriptを無効にしても完全に機能する静的ランディングページを構築するための包括的なプロセスを提供します。訪問者はヘッダーからすべてのセクションにアクセスでき、フォームを送信できる状態を目標とします。このスキルは、過去のテストビルドで頻発した2つのバグ(セクションのパディングが上書きされる問題と、データが破棄されるデッドフォーム)を構造的に防止するよう設計されています。実装プロセスはスタック検出から始まり、インベントリ作成、ヘッド要素の記述、フォントの読み込み、レイアウト骨格の構築、各セクションの構築、メディア配置、コンバージョンアクション(外部URLリンクまたはフォーム)の構築、アクセシビリティ対応、モーションの排除、そして最終チェックと引き継ぎまでをカバーします。特に、セクションとコンテナの役割を明確に分離し、パディングショートハンドの使用を禁止することでバグを防止します。また、フォームはJavaScriptなしでも動作し、サーバー側の確認後にのみ成功メッセージを表示する堅牢な設計が特徴です。このスキルは、プレーンHTML、Astro、Next.js、Vite + React、Tailwind CSSなど、主要なスタックをサポートしており、プロジェクトファイルから自動検出します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-build

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

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

プレビュー

スキル README より

ランディングページ構築スキル preview

ドキュメント

ランディングページ構築

承認されたコピー、ビジュアルディレクション、デザイントークンを基に、JavaScriptをオフにしても完全に機能する静的ページに変換します。完全に機能するとは、訪問者がすべてのセクションを読め、ヘッダーからすべてのセクションにアクセスでき、フォームを送信できることを意味します。アニメーションや3Dは後で landing-skills:landing-motion によって追加され、すでに動作するページの上に重ねられます。

このスキルを使用せずに作成された複数のテストビルドで2つのバグが発生しており、このスキルは両方を不可能にするように設計されています。

  1. padding ショートハンドを持つコンテナクラスがセクションの垂直方向のパディングを上書きし、すべてのセクションが隣接して配置されました。修正は構造的です。セクションはブロック軸を、コンテナはインライン軸を担当し、どちらもショートハンドを使用しません(ステップ5)。
  2. 死んだフォーム:action="#"、onsubmit="return false"、または「ありがとう」と表示してデータを破棄するスクリプト。修正:実際の action、実際の method、サーバーがバックアップする成功ページ、およびページがバックできない成功メッセージなし(ステップ8)。

入力

コードを書く前に、ユーザーのプロジェクトからこれらを読み取ります。

ファイルそこから取得するもの
landing/brief.mdlanding-skills:landing-page が書き込むフィールド。使用するもの:言語(lang 用);コンバージョンアクション(フィールドとエンドポイントを持つフォーム、または none yet、または外部URL);スタック(名前付き、または detect);ドメイン(本番ドメイン、または unknown);連絡先ルート(フッターと /form-error/ 用);利用可能なアセット
landing/copy.mdページ順の各セクションのH2;最後のH2 Placeholders はすべてのギャップをリスト
landing/direction.mdソースとライセンス付きの書体、各セクションのレイアウト行、アスペクト比付きの画像、サーフェス、最終H2 Motion and 3D intent
landing/tokens.cssカスタムプロパティ:--color-*、--font-*、--text-*、--space-*、--radius-*

入力が欠けている場合:

  • copy.md がない場合:自分でマーケティングコピーを作成しないでください。ユーザーにテキストを依頼するか、landing-skills:landing-copy を提案してください。ユーザーからテキストを受け取った場合は、そのまま使用します。証拠をでっち上げないでください:推薦文、ロゴ、数値、評価は一切使用しません。欠落部分は [PLACEHOLDER: 必要なもの] になります。
  • direction.md または tokens.css がない場合:最初に landing-skills:landing-art-direction を提案してください。ユーザーがそれなしで進めたい場合は、自分で landing/tokens.css を5つのプレフィックスで作成し、ユーザーから与えられたブランド制約から値を導出し、これらのトークンは暫定的なものであることをユーザーに伝えてください。
  • brief.md がない場合:言語、コンバージョンアクション(フォームとその投稿先、または外部URL)、本番ドメイン、連絡先ルートを尋ねてください。
  • unknown または none yet と記載されたブリーフフィールドはエラーではなくギャップです:このスキルがそのルールに従って構築し(ドメインがない場合はURLタグなし、エンドポイントがない場合は /api/lead プレースホルダー、連絡先ルートがない場合はプレースホルダーの連絡先行)、引き継ぎでそれをリストします。プロジェクトファイルからスタックを検出します(「スタック検出」を参照)。可能な場合は尋ねる代わりに。

プロセス

1. スタックを検出する

「スタック検出」の表を使用します。ファイルを書き込む前に references/adapters.md の該当セクションを読んでください。他のリファレンスのプレーンレシピと異なる点のみをカバーしています。

2. インベントリを作成する

マークアップの前に、以下を書き留めてください。

  • copy.md の各H2と、それがなる <section>、およびその id。
  • tokens.css のすべてのトークン名。色、書体、スペーシング、半径にはこれらの名前のみを使用します。
  • ディレクションで要求される各画像、そのアスペクト比、およびファイルが存在するかどうか。
  • ブリーフからのコンバージョンアクション:外部URL(リンク、フォームなし)、またはフィールドとエンドポイントを持つフォーム。エンドポイントが none yet の場合、フォームは /api/lead に投稿し、そのギャップは引き継ぎに含まれます(ステップ11)。
  • ドメイン(既知または unknown)と連絡先ルート。これらはヘッド、フッター、および /form-error/ に必要です。

3. ヘッドを記述する

タイトル、説明、カノニカル、Open Graphとソーシャルカード、ファビコンセット、theme-color、lang、構造化データ。テンプレートとルールは references/seo-meta.md にあります。タイトルと説明は copy.md から記述します。フレームワークのスタータータイトルなどのデフォルトタイトルは避けてください。

4. フォントを読み込む

ディレクションで指定されたWOFF2ファイルをセルフホストし、tokens.css のスタックと正確に一致するファミリー名で @font-face を宣言し、メトリックマッチングされたフォールバックを追加し、ファーストビューで使用される1つまたは2つのファイルのみをプリロードします。references/performance.md にレシピと、フォールバック値を計算するテスト済みスクリプトがあります。フォントを指定して読み込まないページ、または system-ui にフォールスルーするページは、マシンごとに異なるレンダリングになります。

5. レイアウトの骨格を構築する

ページの各バンドは、内部に1つの <div class="container"> を持つ <section class="section"> です。この2つは決して役割を共有しません。

/* セクションは垂直方向のリズムを、コンテナは幅とガターを担当 */
.section { padding-block: var(--space-section-open); }
.container {
  inline-size: min(100% - 2 * var(--space-gutter), var(--space-content-max));
  margin-inline: auto;
}

上記のトークン名は例です。自分の tokens.css の名前を使用してください。references/css.md には、レシピが想定するすべてのトークンロールと、ファイルに対応するトークンがない場合の対処法がリストされています。 コンテナはパディングを一切設定しないため、ルールの順序や詳細度でセクションのスペーシングが消去されることはありません。セクションまたはコンテナクラスで padding または margin のショートハンドを決して使用しないでください。ショートハンドは両方の軸を設定し、他のクラスが設定したものを黙って置き換えます。これがバグ1を排除するルールです。references/css.md には、このバージョンの隣に壊れたバージョンと、全幅およびヘアラインケースが示されています。

6. セクションを構築する

  • セマンティック要素を使用:header、nav、main、section、footer、ステップには ol、仕様には dl または table、キャプション付きメディアには figure。
  • ヒーローに1つの h1。各セクションは copy.md から取得した h2 で始まります。レベルをスキップしないでください。
  • 各セクションを direction.md の該当行に従ってレイアウトします。ディレクションが形状を開いたままにしている場合は、references/css.md のレシピから選択します。ブロックの数と形状はコンテンツに従うため、3つの等しいカードは、コンテンツが3つの等しいものである場合にのみ表示されます。
  • すべての色、フォント、サイズ、スペース、半径にトークンを使用します。ページCSSでトークンを再宣言しないでください。必要な値にトークンがない場合は、トークンから構成し(calc()、color-mix())、引き継ぎにリストしてディレクションが追加できるようにします。
  • clamp() による流動的なサイズ、論理プロパティ、references/css.md のフォールバック付き oklch() 色、および独自の幅に応じて形状が変わるコンポーネントにはコンテナクエリを使用します。

7. メディアを配置する

実際の画像には width と height、内容を説明する alt テキスト、フォールバック付きの最新フォーマット、およびヒーロー画像のみに fetchpriority="high" を設定します(references/performance.md)。まだ存在しないアセットは、最終的なアスペクト比で可視のラベル付きプレースホルダーボックスになり、[PLACEHOLDER: photo, the workshop bench from above, 3:2] などのテキストを表示します。ボックスに role="img" を設定しないでください。存在しない写真をアナウンスすることになります。各プレースホルダーに、ディレクションがその画像に指定する比率、幅、背景を設定し、フレームが同一の破線ボックスの行ではなく計画されたレイアウトを示すようにします(references/css.md、メディアプレースホルダー)。偽の製品画面を描画して製品として提示しないでください。

8. コンバージョンアクションを構築する

ブリーフのコンバージョンアクションが、構築するものを決定します。

  • 外部URL(チェックアウト、予約ページ、アプリストア):アクションはリンク、<a class="button" href="https://..."> で、ラベルは copy.md から取得します。フォーム、form.js、/thanks/ や /form-error/ ページはありません。このステップの残りはスキップします。ブリーフがクリックをカウントする必要があると述べている場合、landing-skills:landing-launch がビーコンを追加します。
  • ユーザーがすでに持っているエンドポイントへのフォーム:フォームはそのURLに投稿し、/api/lead プレースホルダーは使用しません。そのエンドポイントがリダイレクトする場合にのみ結果ページを構築します。それ以外の場合は、引き継ぎでエンドポイントが訪問者をどこに送るかを記述します。
  • エンドポイントが none yet のフォーム:フォームはプレースホルダー /api/lead に投稿します。これは landing-skills:landing-launch がWorkerとして構築します。

フォームの場合、references/forms-a11y.md を読んでください。不可欠な部分:

  • <form action="..." method="post">。アクションはブリーフからのエンドポイント、または action="/api/lead" で、その隣にエンドポイントがまだ存在しないことを示すHTMLコメントを付け、引き継ぎにリストします。
  • すべてのフィールドには name、可視の <label>、適切な type と autocomplete、および形式を説明する必要がある場合は aria-describedby でリンクされたヒントがあります。
  • JavaScriptなしでブラウザはフォームを投稿し、エンドポイントは今構築する2つの静的ページのいずれかに 303 リダイレクトで応答します:/thanks/ と /form-error/。landing-skills:landing-launch がTurnstileを追加すると、JavaScriptのない訪問者はトークンを持たず、常に /form-error/ に到達するため、そのページはブリーフの連絡先ルートから取得した別の連絡手段を提供する必要があります。
  • 常に references/forms-a11y.md から form.js をプログレッシブエンハンスメントとして出荷します。フォームはそれなしでも動作しますが、このファイルはビルドの一部であり、landing-skills:landing-motion が設定する状態を拡張し、landing-skills:landing-launch がそれらをチェックするためです。成功は、応答が2xxであり、そのJSONボディが ok: true を示す場合にのみ表示されます。2xxだけでは何かが応答したことしか証明しません。fetch はリダイレクトを追跡し、着地したページを200として報告し、静的ホストは通常のHTMLページでPOSTに応答できます。どちらもテストで発生し、両方とも失敗です。失敗した場合、スクリプトはその旨を表示し、訪問者が入力した内容を保持します。サーバーが確認する前にフォームをリセットしたり、「ありがとう」を表示したりしないでください。

9. アクセシビリティの最低基準を満たす

スキップリンク、ランドマーク、実際のセクションIDを指すリンクを持つ nav、/ にリンクするロゴ、すべてのインタラクティブ要素に可視のフォーカススタイル、少なくとも44x44ピクセルのターゲット、およびページが実際にレンダリングするすべてのテキストと背景のペアのコントラストチェック:各サーフェス上の本文テキスト、キャプション、ヒント、プレースホルダーテキスト、アクセント上のテキスト。詳細と数値は references/forms-a11y.md にあります。電話でリンクを非表示にし、代替手段のないナビゲーションはこの基準を満たしません。代わりにリンクを折り返してください。

10. モーションを除外する

[reduced motion] では、動きが削減されるのであって、フィードバックが削減されるわけではありません。したがって、トランジションをゼロにするグローバルルールは記述しないでください。すべての要素を最終的な可視状態で構築してください。エントランスアニメーション、スクリプトを待つ opacity: 0、スクロールライブラリは使用しません。

ディレクションの Motion and 3D intent で指定された各モーメントについて、スタンドインを残してください:静止したポスター画像、またはラベル付きプレースホルダーを、モーメントの最終的なサイズとアスペクト比で配置し、landing-skills:landing-motion が実際のものをマウントしたときにレイアウトがずれないようにします。data-moment="<name>" でマークし、ディレクションがそのモーメントに与える短い名前を使用します。モーションはその属性でターゲットを見つけます。スタンドインはモーションなしで完全です:alt テキスト付きの実際の画像、またはそのモーメントが示す内容を説明するプレースホルダーテキスト。

<div class="hero__media" data-moment="exploded-view">
  <img src="/img/exploded-poster.jpg" width="1600" height="1000" alt="デバイスのレイヤーが広がっている:ケース、基板、バッテリー、レンズ">
</div>

インテントが none の場合、data-moment 要素を追加しないでください。

11. チェックして引き継ぐ

「完了の定義」を実行します。その後、ユーザーに短いリストで伝えます。

  • 何がどこに構築されたか(ファイル、出力フォルダ)、および detect と指定されていた場合にブリーフのスタックフィールドに書き込まれた解決済みスタック、
  • ページ上にまだ残っているすべての [PLACEHOLDER: ...] と提供すべきすべてのアセット、
  • 構築されたコンバージョンアクション:外部URLへのリンク、ユーザーのエンドポイントに投稿するフォーム、またはまだ存在しない /api/lead に投稿するフォーム、
  • フォームが送信する各フィールド、1行に1つ:その name、タイプ(email、tel、text、textarea)、required かどうか、およびマークアップからの maxlength。landing-skills:landing-launch はこのリストからWorkerの検証、長さ制限、ストレージ、リクエストサイズ制限を設定し、通知されなかったフィールドを拒否します、
  • トークンが存在しなかったために構成された値、および tokens.css に欠けていたオプショントークンと、レシピが使用したフォールバック、
  • ブリーフが unknown の場合の本番ドメイン、およびそのために省略されたURLタグ(カノニカル、og:url、og:image、サイトマップ)、
  • ブリーフが unknown のままにした連絡先ルート。フッターと /form-error/ がプレースホルダーとして表示します、
  • サブセット化されていない各フォントファイルとそのバイトサイズ、
  • 実行されなかった「完了の定義」の各チェックと、その理由とともに「未実行」とマーク、
  • Motion and 3D intent からの各モーメント:その data-moment 名と、そのスタンドインが配置されている場所(セクションと要素)、またはインテントが none の場合は「なし」、
  • 次のスキル:ディレクションの Motion and 3D intent がモーメントを指定する場合は landing-skills:landing-motion、次に landing-skills:landing-review、次にホスティングとフォームエンドポイント用の landing-skills:landing-launch。

スタック検出

プロジェクトルートをこの順序でチェックし、最初に一致した時点で停止します。brief.md の Stack フィールドは、プロジェクトフォルダが空の場合に決定します。

スタックが解決されたら、それを書き戻します。ブリーフのスタックフィールドが detect と記述されている場合、その1語を解決されたスタック(例:Astro、または plain HTML and CSS)に置き換え、landing/brief.md の他の部分は変更しません。後のスキルはフィールドを読み取り、未解決の語に遭遇するべきではありません。ユーザーが指定したスタックはそのまま保持されます。landing/brief.md がない場合は、作成しないでください。

プロジェクト内のシグナルスタックアダプターセクション
astro.config.mjs(または .ts、.js)、または package.json の依存関係に astroAstroAstro
[以下、翻訳対象のため省略]

Individual skills in this repo

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

関連スキル