Communitygithub.com

cosmic-forge

디자인 스킬. 시네마틱하고 포토리얼한 실시간 3D 웹 경험(우주, 블랙홀, 은하, 행성 또는 모든 '유니버스'/객체 장면)을 구축하기 위한 마스터 워크플로우입니다. 스크롤 기반 카메라 여정, 스튜디오급 UI/UX, 즉시 로딩 및 완벽한 모바일 레이아웃을 갖춥니다. 사용자가 3D/WebGL/Three.js/몰입형/어워즈 수준/시네마틱/스크롤 애니메이션 웹사이트, 포트폴리오, 랜딩 페이지, 히어로 장면 또는 제품 장면을 요청하거나 '블랙홀 사이트처럼 만들어 줘'라고 말할 때 사용하세요. 사용자가 개념을 제공하지 않으면 템플릿/event-horizon에 있는 기본값인 Event Horizon 블랙홀 → 은하 → 태양계 포트폴리오를 구축하세요.

cosmic-forge란 무엇인가요?

Cosmic Forge는 시네마틱하고 포토리얼한 실시간 3D 웹 경험을 구축하기 위한 종합적인 마스터 워크플로우입니다. 이 스킬은 사용자가 3D/WebGL/Three.js 기반의 몰입형 웹사이트, 포트폴리오, 랜딩 페이지 또는 히어로 장면을 요청할 때 활성화되며, '블랙홀 사이트처럼'이라는 요청에도 대응합니다. 주요 기능은 스크롤 기반 카메라 여정, 스튜디오급 UI/UX, 즉시 로딩 및 완벽한 모바일 레이아웃을 포함합니다. 이 스킬은 7개의 마스터 스킬(webgl-cinematic-engine, space-realism, scroll-camera-direction, ui-ux-mastery, instant-load-performance, mobile-first-3d, quality-gate)을 오케스트레이션하며, 사용자가 특정 개념을 제공하지 않으면 기본값으로 Event Horizon 블랙홀→은하→태양계 포트폴리오 템플릿을 사용합니다. 모든 구현은 연속적인 카메라 이동, 실제 물리학 및 텍스처 참조, 깊은 블랙과 의도적인 하이라이트, 그리고 엄격한 성능 예산(데스크탑에서 ≤16ms/프레임, 폰에서 첫 로드 ≤1.5MB)을 준수해야 합니다.

지원 대상~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/을 복사하고 개인화하세요(이름, 역할, 이메일, 페이지, 프로젝트 목록). 그 템플릿 자체가 참조 품질 기준입니다: 슈바르츠실트 블랙홀(렌즈 효과가 적용된 실제 하늘 포함) → 체적 은하 → 사진 같은 태양계, 모두 하나의 연속적인 스크롤로 구성됩니다. "단순화"하지 마세요.
  • 다른 개념인 경우 (바다, 도시, 제품, 애니메이션 성, 숲, 원자, DNA…): 여전히 템플릿의 엔진과 파이프라인(TAA, 블룸, 동적 해상도, 로더, 스크롤 스프링, 페이싱 곡선, 모바일 프로필, 스크롤 큐)에서 시작하고 장면 셰이더, 카메라 키 및 콘텐츠만 교체하세요. 처음부터 배관을 다시 구축하지 마십시오. 품질은 거기에 있습니다.
  • Three.js가 명시적으로 요청된 경우: 허용되지만 동일한 규칙을 이식하세요(엔진 스킬 §Three.js 참조).

1. 브리프 → 트리트먼트 (코딩하기 전에 이것을 작성하세요)

모든 요청(한 줄짜리라도)을 6줄짜리 트리트먼트로 전환하세요:

  1. 히어로 이미지: 사람들이 스크린샷을 찍을 단일 프레임입니다. 빛, 색상, 스케일을 설명하세요.
  2. 여정: 카메라가 통과하는 3-6개의 비트로, 각 비트는 다음 비트와 연속적이어야 합니다(요청되지 않는 한 컷, 플래시 또는 터널 없음). 예: 구멍 → 어둠 → 은하 → 별 → 행성 → 홈.
  3. 페이지: 어떤 콘텐츠가 어떤 비트에 나타나고, 프레임의 어느 쪽에 나타나는지.
  4. 팔레트: 하나의 주요 광원색, 하나의 악센트, 하나의 깊은 배경색. 실제 참조(NASA/ESA 사진, 영화 스틸)가 상상보다 낫습니다.
  5. 모션 느낌: 예: "느린 장엄한 돌리, 구멍 속으로 가속, 페이지에서 부드러운 정지".
  6. 예산: 데스크탑에서 동적 해상도로 ≤16ms/프레임, 폰에서 첫 로드 ≤1.5MB.

사용자의 표현이 모호하면 자신 있게 결정하고 각 선택을 한 줄로 명시하세요. 선택이 진정으로 사용자의 몫인 경우에만 질문하세요(브랜드 이름, 실제 이메일, 실제 프로젝트 이름).

2. 빌드 순서 (절대 건너뛰거나 순서를 바꾸지 마세요)

  1. 템플릿을 복사 → 로컬에서 실행(python -m http.server) → 렌더링되는지 확인하세요.
  2. 콘텐츠 개인화(js/main.js → SITE, PAGES; index.html 제목/meta/로더 이름).
  3. 장면 작업(엔진 + 리얼리즘 스킬). 한 번에 하나의 비트를 변경하고, 각 변경 후 확인하세요.
  4. 카메라 및 페이싱(스크롤-카메라 스킬). ?u=0.42 스타일의 점프 링크로 조정하세요.
  5. UI 레이어(ui-ux 스킬): 패널, 내비게이션, 로더, 스크롤 큐, 레이블.
  6. 폰 프로필(모바일 스킬): 프레이밍, 텍스처, 레이아웃, 메뉴.
  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".

관련 스킬