Communitygithub.com

울트라 사이트

에이전트가 '울트라 사이트'를 기획하고 구축하는 방법을 알려주며, 구체적인 결과물로 로고와 소규모 브랜드 시트를 제공합니다. 절차는 울트라 사이트, 필수 조건, 워크플로우를 통해 진행됩니다. 새로운 작업에서 이 기술이 필요할 때 사용하세요.

울트라 사이트란 무엇인가요?

이 스킬은 실제 자산과 정직한 데이터만을 사용하여 대기업의 플래그십 런칭 페이지처럼 보이는 사이트를 구축하는 방법을 에이전트에게 가르칩니다. 참조 빌드는 ARFORGE(https://github.com/ArfatArfart/arforge)이며, 라이브 데모는 https://arfatarfart.github.io/arforge/에서 확인할 수 있습니다. 에이전트는 각 단계의 작동 코드가 필요할 때 이 저장소의 소스 코드를 참조하도록 안내받습니다. 이 스킬은 '비협상 조건'이라는 엄격한 규칙을 적용합니다. 예를 들어 3D 장면에는 실제 포토스캔 모델만 사용하고, 단일 고정 캔버스에서 여러 장면을 구성하며, 모든 섹션을 히어로로 만들고, 각 애니메이션 단어에 의미 있는 움직임을 부여하며, 브라우저가 측정한 지표나 실시간 API 데이터만 증거로 사용하고, 최종적으로 GitHub Actions를 통해 배포합니다. 워크플로우는 컨셉 구상부터 자산 수집, 프로젝트 스캐폴딩, 무대 구축, 섹션 개발, QA 및 배포까지 8단계로 구성되어 있으며, '품질 기준' 섹션에서는 가독성, 모션 커브, 접근성, 반응형 성능 등에 대한 구체적인 지침을 제공합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 도구에서 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ArfatArfart/ultra-site-skill/tree/HEAD/ultra-site

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

울트라 사이트은(는) 무엇을 하나요?

이 스킬은 실제 자산과 정직한 데이터만을 사용하여 대기업의 플래그십 런칭 페이지처럼 보이는 사이트를 구축합니다. 참조 빌드는 ARFORGE (https://github.com/ArfatArfart/arforge, 라이브: https://arfatarfart.github.io/arforge/) 입니다. 아래 단계에 대한 작동 코드가 필요하면 이 저장소의 소스 코드를 읽어보세요.

필수 조건

  1. 3D에는 실제 자산만 사용. 절대 기본 도형으로 '가짜' 히어로 오브젝트를 모델링하지 마세요. 포토스캔 CC0 모델(Poly Haven), 실제 HDR 이미지, 실제 NASA 텍스처, 실제 로고(Simple Icons), 클라이언트 자체 라이브 작업의 실제 스크린샷을 사용하세요. 모든 출처를 푸터에 표시하십시오.
  2. 하나의 스테이지, 여러 장면. 고정된 단일 <canvas>가 페이지 뒤에 위치합니다. 각 섹션은 data-shot와 data-theme을 선언합니다. 스크롤 위치는 부동 소수점이 됩니다 (2.4는 샷 2에서 샷 3으로 40% 진행됨을 의미).
  3. 모든 섹션은 히어로입니다. 전체 뷰포트, 디스플레이 타입, 자체 테마, 자체 3D 순간. 푸터도 포함됩니다.
  4. 의미적 모션. 애니메이션되는 모든 단어는 그 의미에 맞게 움직입니다. 각 효과는 한 문장으로 이유를 저장합니다. 그 이유를 화면에 고정하는 Why 모드(W 키)를 제공하세요.
  5. 증명이 주장보다 우선. 통계, 고객 또는 사용 후기를 절대 조작하지 마세요. 브라우저가 측정하는 숫자(fps, 프레임 시간, 그려진 점, 드로우 콜, 바이트, 첫 프레임까지의 시간)와 라이브로 가져온 데이터(GitHub 저장소, API 지연 시간)를 표시하세요.
  6. 배포하세요. base가 저장소 경로로 설정된 Vite 빌드, GitHub Actions Pages 워크플로우, 저장소 생성 및 Pages 활성화, 그리고 확인된 라이브 URL.

워크플로우

  1. 컨셉 (5분, 막히지 않으면 질문 금지). 스튜디오 이름과 모든 시각적 결정의 근간이 될 수 있는 하나의 은유를 선택하세요 (ARFORGE: 대장간, 따라서 녹은 금속처럼 빛나는 디졸브, 프로세스 단계는 망치질, 불꽃이 솟아오름). 카피는 문장 케이스로 작성하고, 불필요한 단어는 넣지 말며, 문장 내 하이픈은 사용하지 마세요.
  2. 자산 수집. references/real-assets.md를 따르세요. Poly Haven API를 쿼리하고, 히어로에는 2k, 나머지는 1k로 glTF를 다운로드하고, gltf-transform(meshopt + WebP)으로 압축하고, 경계를 검사하고, 각 모델의 방향을 파악하기 위해 Blender 썸네일을 렌더링하세요. 헤드리스 Edge 또는 Chrome으로 클라이언트의 라이브 프로젝트를 스크린샷으로 찍으세요.
  3. 스캐폴딩. Vite + three + gsap (모든 플러그인은 무료: SplitText, ScrambleText, ScrollTrigger) + lenis + @fontsource-variable/geist. 하나의 토큰 스타일시트, GSAP에 의해 전환되는 CSS 변수로 된 11개의 테마.
  4. 무대 구축. references/stage-architecture.md를 따르세요: 실제 메시에서 샘플링된 모핑 필드, 실제 PBR 재질에 패치된 대장간 디졸브, 오브젝트가 없는 섹션을 위한 절차적 샷, 불티, 불꽃, 실제 태양 직하점이 있는 지구.
  5. 섹션 구축. 히어로 (히어로 오브젝트의 스캔 셰이더, 실제 메시 통계가 있는 HUD), 태그라인 공개, 세 개의 서비스 챕터 (각각 실제 오브젝트와 대화형 증명 포함: 라이브 캔버스 스크린, 드래그 가능한 폰 데모, 실제 요청의 터미널), 충격과 함께 고정된 프로세스, 라이브 작업 그리드, 드래그 가능한 기술 구체, 라이브 메트릭, FAQ, 지구와 히트 타입이 있는 푸터 히어로.
  6. 의미적 단어. references/semantic-motion.md의 카탈로그를 사용하세요. 모든 제목은 최소 두 개의 효과를 받습니다. 하나의 제목 내에서 효과를 재사용하지 마세요.
  7. 브라우저 창에서 QA. 데스크탑과 모바일 프리셋을 확인하고, 콘솔 오류를 읽고, 375px에서 가로 오버플로가 없는지 확인하세요. 숨겨진 브라우저 창은 requestAnimationFrame을 조절하므로, 거기서 느린 인트로는 버그가 아닙니다.
  8. 배포. references/deploy.md를 참조하세요. 저장소를 생성하고, build_type=workflow로 Pages를 활성화하고, 푸시하고, 실행이 완료될 때까지 기다린 후, 라이브 URL을 열고 거기서도 콘솔을 확인하세요.

품질 기준

  • 히어로 헤드라인은 3D 오브젝트 위에서 읽을 수 있어야 합니다 (텍스트 그림자 또는 레이아웃 여백).
  • 모션은 cubic-bezier(0.22, 1, 0.36, 1) 또는 GSAP expo/elastic을 사용하며, UI에는 절대 linear를 사용하지 않습니다.
  • prefers-reduced-motion은 효과를 페이드로 전환하고 부드러운 스크롤을 비활성화합니다.
  • 적응형 픽셀 비율: fps가 40 미만으로 유지되면 DPR을 낮춥니다.
  • 건너뛰기 링크, 포커스 링, 분할 텍스트의 aria 레이블, 스크린샷의 대체 텍스트, 개인정보 보호 및 약관 대화상자, 브랜드화된 404 페이지, 실제 히어로 오브젝트에서 렌더링된 OG 이미지.
  • 모바일: 3D는 뷰포트 상단을 차지하고, 카피는 그 아래 서리가 낀 카드 위에 위치합니다.

관련 스킬