Communitygithub.com

LinXueyuanStdio/viben

最小限のプレローンチランディングページ—メールアドレス収集、ブランドロゴ、オプションの装飾レイヤーを備えています。DESIGN.mdから色、タイポグラフィ、レイアウトルールを読み取ります。製品ローンチ、ベータ版サインアップ、アーリーアクセスプログラム、インディープロジェクトに最適です。

viben とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)が、ブランドの一貫性と品質を重視した、ミニマルで誠実なウェイティングリストページを生成するためのものです。事前に用意された堅牢なテンプレート(assets/template.html)をベースに、DESIGN.mdから読み取った色・フォント・レイアウト情報をトークン置換で注入します。生成されるページは、シングルCTA(メール収集フォーム)に特化し、カウントダウンや偽のソーシャルプルーフなどのアンチパターンを排除。P0/P1の品質ゲートを通過するまで出力を許可しないため、安全でアクセシブルなコードが保証されます。すべてのカラーはCSS変数で管理され、インジェクション対策が施されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LinXueyuanStdio/viben/tree/HEAD/resources/design-templates/waitlist-page

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

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

ドキュメント

ウェイティングリストページスキル

プレローンチページは、将来のユーザーとの最初の握手です。このスキルは、焦点を絞った誠実な入口を構築します。ブランド ID、開発中のもの、アーリーリストに参加するための明確なパスが1つ。人工的な希少性、偽のカウントダウン、誇張された戦術は一切なし。クリーンでモバイルファーストな、純粋な関心を集めるための器です。

ワークフロー

準備:強化テンプレートとブランド基盤の読み込み

  1. ブランド ID を読み込む — DESIGN.md を読み、カラーシステム、フォントペアリング、空間ルールを確認します。これが基盤です。ウェイティングリストページは、それが代表するブランドとの一貫性によって成否が決まります。DESIGN.md がない場合は、先に進む前にユーザーに提供を依頼してください。
  2. 再利用可能なテンプレートを読み込み、コピーする — assets/template.html を読み込みます。このテンプレートは、すべての出力のための強化されたシードです。これをベースとして index.html にコピーします。HTML をゼロから記述したり、この構造から逸脱したりしないでください。テンプレートには、必要なレイアウト、フォーム構造、装飾、フォーカススタイル、アクセシビリティの下地がすべて組み込まれています。

手順:検証とエスケープを伴うトークン置換

  1. 入力からトークンをマッピングする — テンプレート内の各プレースホルダー(例: {{PRODUCT_NAME}}、{{BG_EXPRESSION}}、{{BORDER_EXPRESSION}}、{{LOGO_MARK}})について、以下の置換ルールに従います。
    • テキストトークン({{PRODUCT_NAME}}、{{TAGLINE}}): HTML テキストノードまたは属性値に挿入する前に、<、>、&、"、' を HTML エスケープします。
    • HTML トークン({{LOGO_MARK}}): テキストのイニシャルを使用する場合は、デフォルトで HTML エスケープします。インライン SVG を使用する場合は、許可リストを使用して厳密にサニタイズする必要があります。<script> タグ、イベントハンドラ(on*)、<foreignObject>、外部参照(href、xlink:href、url())、および許可されていない属性/要素を削除してから挿入します。SVG を安全にサニタイズできない場合は、エスケープされたテキストイニシャルにフォールバックします。未サニタイズの任意の HTML をそのまま出力しないでください。SVG がコンテナ内でクリーンにスケールすることを確認してください。
    • カラー式トークン({{BG_EXPRESSION}}、{{FG_EXPRESSION}}、{{ACCENT_EXPRESSION}}、{{DECO_EXPRESSION}}、{{STRIPE_EXPRESSION}}、{{SUCCESS_EXPRESSION}}、{{BORDER_EXPRESSION}}、{{BTN_LABEL_EXPRESSION}}、{{TICKER_BG_EXPRESSION}}、{{TICKER_FG_EXPRESSION}}、{{DECO_STROKE_EXPRESSION}}、{{LOGO_SHADOW_EXPRESSION}}、{{LOGO_FG_EXPRESSION}}): 明示的なカラー文法(#hex、rgb/rgba、hsl/hsla、oklch、またはローカル変数のみを使用した color-mix())に厳密に従う必要があります。CSS インジェクションを防ぐため、;、{}、<、>、コメント(/*)、@、url(、外部参照を含む入力は厳密に拒否します。# でラップしたり、余分な引用符を追加したりしないでください。例: rgba(196, 169, 154, 0.38)、color-mix(in srgb, var(--fg) 38%, transparent)、#FDE8DF。そのまま :root CSS 変数に挿入します。--success は DESIGN.md にあればそこから派生させ、ない場合は許可されたフォールバック #2D6A4F のみを使用します。
    • フォント名トークン({{DISPLAY_FONT_CSS}}、{{BODY_FONT_CSS}}): これらは CSS の font-family 値であり、スペースが含まれる場合は既に引用符で囲まれています(例: 'DM Sans'、Syne)。そのまま --font-display および --font-body 宣言に挿入します。余分な引用符を追加しないでください。
    • フォント URL トークン({{DISPLAY_FONT_URL}}、{{BODY_FONT_URL}}): Google Fonts URL では、スペースを + としてエンコードする必要があります(例: DM+Sans、IBM+Plex+Serif)。挿入前に URL が適切な形式であることを検証します。
  2. トークンマッピングルールを確認する — すべてのカラートークンは CSS 変数に設定されます。
    • --bg = {{BG_EXPRESSION}}(例: #FDE8DF)
    • --fg = {{FG_EXPRESSION}}(例: #1A1410)
    • --accent = {{ACCENT_EXPRESSION}}(ブランドバッジ)
    • --deco = {{DECO_EXPRESSION}}(装飾プライマリ)
    • --deco-stripe = {{STRIPE_EXPRESSION}}(アクセントストライプ)
    • --input-border = {{BORDER_EXPRESSION}}(不透明度を含む完全な CSS 式)
    • --success = {{SUCCESS_EXPRESSION}} または #2D6A4F フォールバック
    • --btn-label = {{BTN_LABEL_EXPRESSION}}(コントラストのためのボタンテキスト色)
    • --ticker-bg = {{TICKER_BG_EXPRESSION}}(アニメーション表示の背景)
    • --ticker-fg = {{TICKER_FG_EXPRESSION}}(アニメーション表示のテキスト)
    • --deco-stroke = {{DECO_STROKE_EXPRESSION}}(SVG ストローク、通常は 12~15% の不透明度で控えめに)
    • --logo-shadow = {{LOGO_SHADOW_EXPRESSION}}(ロゴコンテナの影、前景色の微妙な影)
    • --logo-fg = {{LOGO_FG_EXPRESSION}}(ロゴイニシャルのためのコントラストのあるテキスト色)
  3. レスポンシブレイアウト — テンプレートにはモバイルファーストのスケーリングが含まれています。
    • 375px: フォームはシングルカラムにスタック、ロゴは 40px に縮小、装飾は圧縮、水平スクロールなし。
    • 768px: 快適な2カラムの余裕。
    • 1440px+: 中央揃えのレイアウトで十分なホワイトスペース。
    • すべてのテキストが読みやすく、メール入力とボタンが 375×667 および 390×844 で完全に表示されている(クリッピングがない)ことを確認します。

検証:出力前に強化された品質ゲートを実行

  1. 品質チェックリストを実行する — references/checklist.md を読みます。出力前にすべての P0 ゲート を検証します。
    • CTA は1つだけ(メールフォーム)
    • カウントダウンタイマー、偽のソーシャルプルーフ、絵文字はなし
    • 375px で水平スクロールがないこと
    • メール入力は type="email" と required を持つこと。名前に required はなし
    • フォームは novalidate を使用しないこと。JS は checkValidity() ガードを使用すること
    • 成功メッセージには role="status" または aria-live="polite" があること
    • すべての色は DESIGN.md または許可されたフォールバックから取得すること。独自の16進数値を発明しないこと
    • すべてのユーザーテキストは HTML エスケープされていること。カラートークンは厳格な文法に従い、フォントは URL エンコードされていること
    • P0 を通過するか、出力しないこと。 いずれかの P0 ゲートが失敗した場合は、ユーザーに問い合わせるか、トークンマッピングを修正して再試行します。
  2. P1 ゲート を確認し、品質の高い提出を実現します(推奨)。
    • 送信ボタンのホバー状態とアクティブ状態
    • 明確なフィードバックを伴うフォーム検証
    • ティッカーアニメーションが prefers-reduced-motion: reduce を尊重していること
    • すべてのインタラクティブ要素に可視のフォーカススタイルがあること(input:focus には outline が含まれる)
    • Tab/Enter キーボードサポート
    • 本文テキスト(≥4.5:1)とボタンラベル(≥4.5:1)の WCAG AA コントラスト
    • ロゴの alt/aria-label が存在すること。ティッカーには aria-hidden="true" があること
    • <html lang=""> が設定されていること

出力

  1. クリーンな HTML を出力する — 単一ファイル、CSS インライン化、グラフィックは SVG。インタラクティブ要素には data-od-id(見出し、フォーム、ロゴ、ティッカー、グリッドなど)をマークし、エージェントがパースせずにカスタマイズできるようにします。

品質ゲート

このスキルは、コンプライアンスを確保するために、強化されたテンプレートベースのワークフローを強制します。この実行パスに従う必要があります。テンプレートから逸脱すると、出力は無効になります。

必須のテンプレートベースの実行:

  • assets/template.html をベースとして読み込むこと。HTML をゼロから記述しないでください。
  • それを index.html にコピーし、{{PLACEHOLDER}} トークンのみを検証/エスケープされた値で置換します。
  • 出力前に references/checklist.md のすべての P0 ゲートを実行します。いずれかが失敗した場合は修正して再検証します。

P0 ゲート(必ず通過すること):

  • シングル CTA: メールフォームのみがインタラクティブ要素。ナビゲーション、セカンダリボタン、ソーシャルリンクはなし。
  • ロゴ配置: 左上に固定、DESIGN.md のアクセントカラーと一致、モバイルで縮小(50px → 40px)。
  • 色の一貫性: すべての色は DESIGN.md のパレットから。許可される唯一のハードコードされた例外: --success の #2D6A4F。
  • アンチパターンなし: カウントダウンタイマー、偽のソーシャルプルーフ、絵文字アイコン、Lorem ipsum はなし。
  • コンテンツの整合性: 見出しとコピーは product_name と tagline の入力に直接結びついていること。埋め草のコピーはなし。
  • モバイル適合: 375px で水平スクロールなし。メール入力と送信ボタンは、375×667 および 390×844 で完全に表示される(クリッピングなし)。垂直方向のオーバーフローはスクロール可能で、非表示ではないこと。
  • タイポグラフィの規律: ディスプレイフォント + ボディフォントのみ(2フォントルール)。セクション間で一貫したサイズ設定。
  • フォーム構造: 2つのフィールド(名は任意、メールは必須)、checkValidity() ガード、role="status" を持つ成功メッセージ。
  • トークンエスケープ: すべてのユーザー提供テキストは HTML エスケープ。カラートークンは厳格な文法に従い、安全でない文字(;、{}、<、>、/*、@、url()を含まないこと。フォント名は URL エンコード。{{LOGO_MARK}} はエスケープされたテキストイニシャル、または厳密にサニタイズされたインライン SVG(スクリプト、イベントハンドラ、foreignObject、外部 href なし)。

P1 ゲート(品質の高い提出のために通過推奨):

  • ヒーローセクションが視覚的に区別され、スクロールせずに見える範囲にあること。
  • メール送信ボタンにホバー状態とアクティブ状態があること。
  • フォーム検証が明確なフィードバックを提供すること。
  • すべてのモバイルビューポートでページがスクロール可能(クリッピングされていない)であること。CTA がスクロールせずに見えること。
  • prefers-reduced-motion: reduce の下でティッカーアニメーションが一時停止/削除されること。
  • すべてのインタラクティブ要素に可視のフォーカススタイルがあること(outline。outline:none だけではない)。
  • キーボード: Tab キーで各フォームフィールドに到達。Enter キーで送信。
  • WCAG AA コントラスト: 本文テキスト ≥4.5:1、ボタンラベル ≥4.5:1。
  • ロゴの alt/aria-label が存在すること。ティッカーには aria-hidden="true" があること。
  • <html lang=""> が正しい言語コードに設定されていること。

装飾の抑制:

  • 下部ゾーンは、気を散らさずに強化。不透明度、微妙なストローク、控えめなアニメーション。
  • ビューポートの高さの 20% を超えるグラデーションはなし。
  • コイル、ストライプ、グリッド、ティッカーはすべて、DESIGN.md の色のみを使用。

出力

references/checklist.md のすべての P0 ゲートが通過した後にのみ出力します。

アーティファクトをタグで囲んで出力します:

<artifact identifier="waitlist-id" type="text/html" title="Coming Soon — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="en">
...
</html>
</artifact>

アーティファクトの上に説明を 1 行。下には何もなし。

出力後: ユーザーが変更を要求した場合は、index.html をその場で更新し、次のバージョンを出力する前に P0 チェックリストゲートを再実行します。反復処理で検証をスキップしないでください。

関連スキル