Communitygithub.com

elcoosp/elcoosp-skills

プロダクション品質のNext.jsランディングページをモダンなパターン(i18n、A/Bテスト、ウェイトリスト、アナリティクス、洗練されたUIコンポーネント)で作成します。

elcoosp-skills とは?

このスキルは、Next.js 14+(App Router)を使用して、プロダクション対応のハイクオリティなランディングページを構築するための完全なアーキテクチャガイドです。CodeBridge(codebridge.dev)の実例に基づき、多言語対応(i18n)、A/Bテスト、UTMトラッキング、ウェイトリスト登録、アニメーション(Framer Motion)、マスコット表示など、モダンな機能を体系的に実装する方法を提供します。開発者はスキルの指示に従い、プロジェクトのスキャフォールディング、依存関係のインストール、ファイル構造のセットアップ、主要コンポーネントのコピー・適応を行うことで、短期間で高品質なランディングページを構築できます。このスキルは自動コード生成ではなく、実装パターンとベストプラクティスのリファレンスとして機能し、CursorやClaude CodeなどのAIエージェント環境で活用できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/elcoosp/elcoosp-skills/tree/HEAD/nextjs-landing-page

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

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

ドキュメント

指示

このスキルを使用して、あらゆるプロダクト向けの高品質なNext.jsランディングページをスキャフォールディングするか、その構築方法を学んでください。このスキルは、CodeBridgeランディングページ(完全に機能するプロダクショングレードの例)のアーキテクチャ、コンポーネントパターン、ベストプラクティスを網羅しています。

使用すべきタイミング

  • SaaSプロダクト、オープンソースプロジェクト、モバイルアプリ向けに新しいランディングページが必要な場合。
  • 国際化(i18n)、A/Bテスト、UTMトラッキング、ウェイトリスト登録フォームなどのモダンな機能を実装したい場合。
  • Tailwind CSSとshadcn/uiを使用した、クリーンで保守性の高いNext.js(App Router)コードベースを探している場合。
  • サーバーコンポーネント、クライアントコンポーネント、適切に整理されたファイル階層を持つ大規模なNext.jsアプリケーションの構造を理解したい場合。

使用方法

  1. 新しいNext.jsプロジェクトを開始する(まだの場合)

    npx create-next-app@latest my-landing --typescript --tailwind --app
    
  2. コア依存関係をインストールする(CodeBridgeのpackage.jsonに基づく)

    npm install @lingui/core @lingui/react framer-motion lucide-react @icons-pack/react-simple-icons canvas-confetti
    npm install -D @lingui/cli @lingui/swc-plugin
    

    i18nのため、Linguiをセットアップしてください(Linguiドキュメントを参照)。

  3. CodeBridgeのパターンに従ってアプリを構成する

    app/
    ├── [lang]/                 # 動的言語セグメント
    │   ├── layout.tsx          # ルートレイアウト(フォント、プロバイダー)
    │   ├── page.tsx            # ホームページ – セクションを構成
    │   ├── globals.css         # Tailwind + カスタム変数
    │   ├── ABTestLayoutClient.tsx
    │   ├── blog/               # ブログページ
    │   ├── changelog/
    │   ├── faq/
    │   ├── features/
    │   ├── pricing/
    │   ├── privacy/
    │   ├── security/
    │   └── terms/
    ├── components/
    │   ├── sections/           # 大規模ページセクション(Hero、Features、Pricing…)
    │   ├── shared/             # 再利用可能コンポーネント(Header、Footer、Terminal…)
    │   ├── ui/                 # shadcn/uiコンポーネント(button、card…)
    │   └── mascot/             # カスタムアニメーションマスコット
    ├── hooks/                   # カスタムReactフック
    ├── lib/                     # ユーティリティ、設定、定数
    ├── contexts/                # Reactコンテキストプロバイダー(例:UTMContext)
    └── types/                   # グローバルTypeScript定義
    
  4. CodeBridgeコードベースから主要パターンをコピーする

    • i18n: @linguiを[lang]動的ルートとともに使用。サーバーコンポーネントは翻訳をフェッチし、クライアントコンポーネントは<Trans>を使用。
    • A/Bテスト: クッキー/ミドルウェア(proxy.ts)経由でバリアントを割り当て、ABTestProvider経由で注入。
    • UTMトラッキング: UTMパラメータを解析し、クッキーに保存(初回タッチ)、UTMContext経由で利用可能にする。
    • アナリティクス: Umami(または類似)とカスタムイベントトラッキングフック(useAnalytics)。
    • ウェイトリスト: データベース(Turso)+ APIルート + ライブカウンター。
    • アニメーション: スクロールトリガーエントランス用のframer-motionとAnimatedSection。
    • テーマ設定: ダークモード対応のCSS変数。
  5. セクションを構築する – コンポーザブルなクライアントサイドコンポーネントとして(必要な箇所で'use client'を使用)。各セクションはcomponents/sections/に配置され、page.tsxでインポートされます。

  6. マスコットを追加する(オプション) – AnimatedMascot.tsxを参照して、スクロールに対応した楽しいキャラクターを追加できます。

主要コンポーネント(CodeBridgeランディングページより)

コンポーネント目的
Heroメイン見出し、CTAボタン、ライブウェイトリストカウンター、ターミナルデモ
FeatureBeltアイコンと情報ポップオーバー付きの3つのコア機能
ComparisonTable競合他社との機能比較
WorktreeSectionアニメーション図でパラレルワークツリーを解説
HowItWorksビジュアル付き3ステップインストールガイド
PricingCards / PricingTableA/Bテスト済み価格表示
LaunchCountdownカウントダウンタイマー + ウェイトリストフォーム
TestimonialsSectionユーザーの声のカルーセル
Footerリンク、ソーシャル、著作権

ベストプラクティス

  • デフォルトでサーバーコンポーネント – クライアントロジックはリーフコンポーネントに移動するか、'use client'を控えめに使用。
  • 集中設定 – lib/constants.ts、lib/ab-tests.ts、lib/roadmap-data.ts。
  • カスタムフック – ロジックをカプセル化(例:useAnalytics、useChannelExperiment)。
  • コンテキストプロバイダー – layout.tsxでラップ(例:UTMProvider、ABTestProvider)。
  • 環境変数 – クライアントサイド値にはNEXT_PUBLIC_*を使用。
  • アクセシビリティ – フォーカスインジケーター、ARIAラベル、キーボードナビゲーション(InfoPopover.tsx参照)。
  • パフォーマンス – ファーストビューより下の画像は遅延ロード、next/imageを使用、フォントをプリロード。

出力

このスキルを実行すると、以下が得られます。

  • App Router、TypeScript、Tailwind CSS、shadcn/uiを使用したNext.jsプロジェクト。
  • 動的ルーティングを使用した完全ローカライズ済みランディングページ(英語、フランス語、スペイン語)。
  • クッキーベースのバリアント割り当てによるA/Bテストインフラストラクチャ。
  • 初回タッチアトリビューションによるUTMトラッキング。
  • Tursoデータベースとリアルタイムカウンターを使用したウェイトリスト登録。
  • アニメーションとマスコットを備えた、洗練されたレスポンシブUI。
  • ブログ、チェンジログ、FAQ、価格、法的ページ。

例

例1: 新しいSaaSプロダクトのランディングページを作成する

ユーザー: 私は新しいプロジェクト管理ツール「TaskFlow」のランディングページが必要です。
エージェント: CodeBridgeのパターンを使用して、Next.jsランディングページを構築するお手伝いをします。

まず、プロジェクトを作成しましょう。
npx create-next-app@latest taskflow-landing --typescript --tailwind --app

次に、依存関係をインストールし、スキルに記載された構造をセットアップします。

例2: 既存のランディングページにウェイトリストフォームを追加する

ユーザー: ライブカウンター付きのウェイトリストフォームを追加するにはどうすればよいですか?
エージェント: スキルから`WaitlistForm`コンポーネント、`/api/subscribe`ルート、データベーススキーマをコピーします。次に、Tursoデータベースをセットアップし、環境変数を追加します。

制限事項

  • このスキルはアーキテクチャガイダンスを提供するものであり、自動コード生成ツールではありません。パターンを手動でコピーし、適応させる必要があります。
  • i18nのセットアップはLinguiを前提としています。next-intlや他のライブラリに置き換えることもできます。
  • A/Bテストの実装はクッキーベースであり、専用サービスなしで数百万ユーザーに拡張することはできません。

依存関係

  • Next.js 14+(App Router)
  • TypeScript
  • Tailwind CSS
  • shadcn/ui(オプションですが多用)
  • Lingui(i18n用)
  • Framer Motion(アニメーション用)
  • Turso / libSQL(ウェイトリストデータベース用)
  • Umami(または任意のアナリティクスプロバイダー)

関連スキル