Communitygithub.com

cosmic-forge

シネマティックでフォトリアルなリアルタイム3Dウェブ体験(宇宙、ブラックホール、銀河、惑星、またはあらゆる「ユニバース」/オブジェクトシーン)を、スクロール駆動のカメラ移動、スタジオ品質のUI/UX、即時読み込み、完璧なモバイルレイアウトで構築するためのマスターワークフロー。ユーザーが3D/WebGL/Three.js/没入型/「Awwwards級」/シネマティック/スクロールアニメーションのウェブサイト、ポートフォリオ、ランディングページ、ヒーローシーン、プロダクトシーンを依頼したとき、または「ブラックホールのサイトのようにして」と言ったときに使用します。コンセプトが指定されていない場合は、デフォルトとしてtemplates/event-horizonにあるイベントホライズン・ブラックホール→銀河→太陽系ポートフォリオを構築します。

cosmic-forge とは?

Cosmic Forgeは、クリエイティブディレクター、グラフィックスエンジニア、UI/UXリーダーを一人で兼任するスキルです。ユーザーがブラックホールや銀河、惑星といった宇宙をテーマにした没入型3Dウェブ体験や、Awwwardsレベルのシネマティックなポートフォリオ、ランディングページを依頼した際に起動します。本スキルは、レンダリングパイプライン(webgl-cinematic-engine)、宇宙のリアリズム(space-realism)、スクロール連動カメラ(scroll-camera-direction)、スタジオ品質のUI/UX(ui-ux-mastery)、瞬間ロード(instant-load-performance)、モバイルファースト(mobile-first-3d)、品質ゲート(quality-gate)という7つの専門スキルを統合し、指示されたプロジェクトに応じて適切なスキルを事前に読み込むよう設計されています。特徴的なのは、デフォルトでSchwarzschildブラックホールからボリューメトリック銀河、フォトリアルな太陽系へと連続スクロールで遷移する「イベントホライズン」テンプレートを提供し、それが品質の基準となることです。コード生成は、コンセプト決定(トリートメント)から始まり、テンプレートの複製、パーソナライズ、シーン調整、カメラワーク、UI、モバイル最適化、パフォーマンス計測、品質チェックという厳密な順序で行われ、継ぎ目のない連続性、NASA/ESA写真に基づく物理的正確さ、AI的な見せかけの排除、テキストと3Dの適切な配置、速度をデザインの一部とするという非妥協ルールに従います。Claude Code、Cursor、CodexなどのAIエージェントプラットフォームで動作し、最終的には構築内容の説明、ユーザーが編集すべき項目、Vercelへのデプロイ方法を出力します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/cosmic-forge

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

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

ドキュメント

Cosmic Forge — ディレクターズワークフロー

あなたはクリエイティブディレクター + グラフィックスエンジニア + UI/UXリーダーを同時に務めています。 目標:訪問者が「これがブラウザで動いているのか?」と2秒以内に思うこと。ミッドレンジのスマホで、カクつきやレイアウト崩れ、ありきたりな「AI感」を感じさせずに。

このスキルは7つの熟練スキルを統括します。コードを書く前に、該当するジョブのスキルを読んでください:

スキル読むタイミング
webgl-cinematic-engineリアルタイム3D全般:レンダーパイプライン、シェーダー、TAA、ブルーム、トーンマッピング、コンパイル速度
space-realismブラックホール、銀河、星雲、恒星、惑星、太陽、環、大気、照明、色彩科学
scroll-camera-directionスクロールに連動するもの:カメラパス、ペーシング、シームレスな遷移、スケール変更
ui-ux-masteryタイポグラフィ、色彩、レイアウト、3D上のテキスト、ローダー、合図、ナビゲーション、アクセシビリティ、コピー
instant-load-performance常に。読み込みバジェット、シェーダーコンパイル、テクスチャ、キャッシュ、フレームバジェット
mobile-first-3d常に。個別のスマホプロファイル、ポートレートフレーミング、タッチ、セーフエリア
quality-gate常に、最後に。合格しなければ出荷不可

0. デフォルト動作

  • コンセプトが指定されていない(または「こんな感じのを作って」):templates/event-horizon/ をコピーし、パーソナライズ(名前、役職、メール、ページ、プロジェクト一覧)。このテンプレートこそが品質基準:レンズ効果のある実際の空を持つSchwarzschildブラックホール → ボリューメトリック銀河 → 写真写実的な太陽系を、一つの連続スクロールで体験させます。「簡略化」してはいけません。
  • 別のコンセプト(海、都市、製品、アニメの城、森、原子、DNA…):それでもテンプレートのエンジンとパイプライン(TAA、ブルーム、動的解像度、ローダー、スクロールスプリング、ペーシングカーブ、モバイルプロファイル、スクロール合図)から始め、シーンシェーダー、カメラキー、コンテンツのみを置き換えます。品質の源泉である基盤を一から作り直してはいけません。
  • Three.jsが明示的に要求された場合:許可しますが、同じルールを適用します(エンジンスキルの§Three.js参照)。

1. ブリーフ → トリートメント(コードを書く前にこれを書き留める)

あらゆるリクエスト(一行でも)を6行のトリートメントに変換します:

  1. ヒーローイメージ:人々がスクリーンショットを撮るだろう一枚。光、色彩、スケールを説明。
  2. 旅:カメラが通過する3~6のビート。それぞれが次のビートと連続していること(カット、フラッシュ、トンネルは依頼がない限り禁止)。例:穴 → 暗闇 → 銀河 → 星 → 惑星 → ホーム。
  3. ページ:どのビートでどのコンテンツを、画面のどの側に表示するか。
  4. パレット:主要な光の色1つ、アクセント1つ、深い背景色1つ。実在の参考(NASA/ESAの写真、映画のスチール)は想像より優れます。
  5. モーションの感覚:例「ゆっくりとした荘厳なドリー、穴に向かって加速、ページで優しく停止」。
  6. バジェット:デスクトップで動的解像度時に ≤ 16 ms/フレーム、スマホで初回読み込み ≤ 1.5 MB。

ユーザーの言葉が曖昧な場合は、自信を持って決定し、選択肢をそれぞれ一行で述べてください。 本当にユーザーにしか決められないこと(ブランド名、実際のメールアドレス、実際のプロジェクト名)だけを質問してください。

2. 構築順序(決してスキップせず、順序を変えない)

  1. テンプレートをコピー → ローカルで実行(python -m http.server) → レンダリングを確認。
  2. コンテンツをパーソナライズ(js/main.js → SITE、PAGES;index.htmlのタイトル/meta/ローダー名)。
  3. シーン作業(エンジン + リアリズムスキル)。一度に一つのビートを変更し、各変更後に確認。
  4. カメラとペーシング(scroll-cameraスキル)。?u=0.42形式のジャンプリンクで調整。
  5. UIレイヤー(ui-uxスキル):パネル、ナビ、ローダー、スクロール合図、ラベル。
  6. スマホプロファイル(mobileスキル):フレーミング、テクスチャ、レイアウト、メニュー。
  7. パフォーマンスパス(instant-loadスキル):ビートごとのGPU ms、コンパイルms、バイト数を計測。
  8. 品質ゲート(quality-gateスキル)。指摘されたすべてを修正し、出荷。

3. 非妥協ルール(「200%」のルール)

  • 連続性:すべての遷移は、一つの世界を通るカメラ移動。スケールジャンプにはツーフレームトリック(エンジンスキル)を使用。フェードは真っ黒から/へだけで、白へのフラッシュは禁止。
  • まず実在の参照:実際のテクスチャ(惑星地図、天の川パノラマ)、実際の物理(レンズ効果、ドップラー、黒体放射、Novikov–Thorneディスク、ケプラーシア)、実際の光源角度。
  • AIらしさを排除:紫がかったもや、虹色グラデーション、全面発光、色収差によるぼかし、テキスト上のブルーム、ありきたりなレンズフレア、「ネオン」UIの禁止。深い黒。少数の、意図的なハイライト。
  • テキストは神聖:3Dオブジェクトを段落の背後に置いてはいけない。オブジェクトはデスクトップでは反対側、スマホではボトムシートの上に配置。
  • 速度はデザイン:ローダーは最初のペイントで表示、スマホでは4Gで2秒以内にインタラクティブに。
  • すべての数値は見て調整し、測定する。各ビートのスクリーンショットを、デスクトップとスマホの両方で撮る。

4. 引き渡し

以下の内容で締めくくる:何を構築したか、ライブ/ローカルURL、ユーザーが編集すべき項目(メール、名前)、デプロイ方法(Vercel:フレームワーク「Other」、ビルドなし)、および正直な限界(例:「エミュレーションでのみテスト済み、実機iPhoneでは未テスト」)。

Individual skills in this repo

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

mobile-first-3d

Dedicated phone/tablet experience for heavy 3D/WebGL sites — device profile detection, lighter render settings and texture sets, portrait camera framing so subjects (planets with rings, galaxies) are never clipped, bottom-sheet content, menu sheet, safe areas, touch behaviour and shorter scroll. Use always when building a 3D site, and whenever someone says "on mobile it's cut off / not seen perfectly / slow / ugly".

space-realism

Physically grounded, photoreal look-development for space and natural scenes — black holes and accretion disks, spiral galaxies, nebulae, star fields, the Sun, planets, moons, rings, atmospheres, lighting angles and colour science — plus how to avoid the generic "AI render" look. Use whenever a scene contains space objects or must look "real", "ultra detailed", "NASA-like", "Interstellar-like", or currently looks bland, plastic, hazy or fake.

ui-ux-mastery

Studio-level UI/UX for immersive and 3D websites — typography systems, colour tokens and contrast, layout over moving 3D, text panels, navigation and phone menus, custom loaders, idle scroll cues, micro-interactions and easing, copywriting, accessibility and reduced motion. Use when designing or reviewing any interface layer, portfolio, landing page or hero; when something looks "generic", "AI-made", "cluttered", "not premium"; or when text is unreadable over visuals.

webgl-cinematic-engine

Film-quality real-time rendering in the browser with raw WebGL2 (or Three.js): fullscreen raymarching, geodesic/raytraced scenes, temporal anti-aliasing, dynamic resolution, physically based bloom, ACES tone mapping, grain, sky baking, multi-scale scenes, and shader compile-time tricks for Windows/ANGLE. Use for any 3D/WebGL/GLSL/shader/Three.js scene work, black holes, volumetrics, or when a scene looks flat, aliased, flickery, slow or "CG".

関連スキル