Communitygithub.com

moat-landing

회사의 기존 사이트 또는 'moat(핵심 경쟁력)' 문장으로부터 스크롤 기반 3D 랜딩 페이지를 구축합니다. 하나의 콘텐츠 파일이 공유 엔진을 구동하여 각 클라이언트 페이지가 고유하게 유지되도록 합니다.

moat-landing란 무엇인가요?

이 스킬은 회사의 라이브 사이트나 간단한 'moat(핵심 경쟁력)' 문장 하나를 바탕으로, 실제로 운영되고 스크린샷으로 검증된 완전한 3D 랜딩 페이지를 생성하는 데 사용됩니다. 내부적으로는 `template/` 디렉토리에 공통 엔진이 있으며, 각 클라이언트별로는 `src/content.js` 파일 하나만 작성하면 됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 주요 AI 코딩 에이전트에서 사용할 수 있도록 설계되었습니다. 이 스킬의 핵심은 체계적인 워크플로우에 있습니다. 먼저 클라이언트 사이트를 크롤링하여 브랜드 정보, 경쟁 우위, 대상 고객 등을 조사합니다. 그런 다음 조사 내용을 바탕으로 스토리텔링, 색상 이론, 3D 씬 디자인을 포함한 전략과 아트 디렉션을 수립합니다. 이후 실제 3D 페이지를 빌드하고, 예산 제한, 반응형 디자인, SEO 및 행동 체크리스트에 대해 엄격한 QA(품질 보증)를 수행합니다. 마지막으로 운영 및 후속 작업에 대한 자세한 핸드오버를 제공합니다. 참조 문서(예: `intake.md`, `narrative.md`, `engine.md`)는 `references/` 디렉토리에 별도로 제공되며 필요한 경우에만 읽으면 됩니다. 이 스킬은 이전 고객의 기억과 'lessons.md' 파일에 기록된 교훈을 기반으로, '일초 인식성', '글로우 효과 없음', '질감 위에 텍스트 금지'와 같은 특정 디자인 규칙을 시행합니다. 페이지당 하나의 주인공(3D 오브젝트 또는 씬)을 유지하고, 텍스트를 항상 HTML로 유지하며, 허위 지표를 절대 게시하지 않는 등의 비타협적 규칙을 따릅니다. 출력물은 완전히 브랜드화되고, 예산에 맞춰 최적화되며, 데스크톱과 모바일 모두에서 크로마 키 프레임이 캡처된 검증된 페이지입니다. 또한, 클라이언트가 실제로 증거, 양식 엔드포인트, 분석 ID를 제공해야 하는 부분을 명확히 하는 핸드오버가 포함되어 있어, AI 개발자와 궁극적인 클라이언트 모두에게 원활한 경험을 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/thisisshivamtiwari/3d-landing-pages-skill/tree/HEAD/moat-landing

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

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

문서

Moat → 3D 랜딩 페이지

회사(라이브 사이트 또는 moat 문장)를 완성되어 실행 중이고 스크린샷으로 검증된 랜딩 페이지로 전환합니다. 엔진은 template/에 작성되어 있습니다. 각 클라이언트마다 하나의 파일, src/content.js 를 작성하고, 이미지를 생성한 후 검증합니다. 엔진 변경 사항은 template/로 다시 포팅되어 다음 클라이언트가 모두 그 혜택을 받을 수 있게 합니다.

필요할 때 읽으세요 (모두 references/ 안에 있습니다): intake.md 클라이언트 조사 · narrative.md moat → 스토리 → 카피 · art-direction.md 색상 이론, 타이포그래피, 조명, 가독성 · scenes.md 오브젝트 vs 씬, 섹션 컷 · engine.md 스키마 및 모듈 · qa.md 캡처 스크립트 및 평가 기준 · advanced.md 실제 자산 및 트렌드 로드맵 · lessons.md 지금까지의 모든 실수 — 시작하기 전에 훑어보세요. 참조 조사 자료(스킬과 함께 보관): references/research/oryzo-teardown.md, graphify-teardown.md, video-and-writeup-research.md. 작업한 클라이언트: pages/poolco/, pages/secureco/, pages/hotelsaas/.

참조 자료를 한 문단으로 요약

Oryzo는 하나의 히어로 오브젝트를 중앙에 배치하고 그 주변 세계(카메라, 렌더 모드, 그레이딩, 라이트/다크)를 변경합니다 — 짧고 무표정한 카피, 각 비트마다 하나의 주장 + 하나의 증거; 키가 큰 DOM 뒤에 고정된 단일 WebGL 캔버스, 모든 이징된 값은 스프링입니다. Graphify는 3D를 양념처럼 사용합니다: 스티키 "작동 방식" 섹션의 다이어그램 자체가 제품 은유(투영된 SVG 와이어프레임)이며, 증거 밀도로 판매합니다. 우리는 이 둘을 융합합니다 — 그리고 물리적 비즈니스의 경우 추상적인 오브젝트를 잘라서 라벨을 붙일 수 있는 실제적이고 식별 가능한 씬으로 대체합니다.

워크플로우 (모든 단계를 순서대로 수행하세요)

1 · 인테이크 및 조사 → research/<slug>/brief.md

클라이언트에 사이트가 있으면 모든 페이지를 먼저 크롤링하세요(intake.md): 텍스트, 서비스, 프로세스, 위치, FAQ, 약관/면책조항, 실제 로고 파일, 샘플 브랜드 색상 및 글꼴, 공개 연락처 정보. 추출할 내용: 회사, 한 문장으로 된 moat(반복되는 주장), 구매자, 실제 CTA, 실제로 존재하는 증거. 찾을 수 없거나 추론할 수 없는 것에 대해서만 사용자에게 한 번 질문하세요. 입력에 자격 증명 / 계정 번호 / 개인 데이터가 있으면 중단하고 먼저 경고하세요.

2 · 전략 (코드 작성 전에 brief에 기록)

  1. Moat 유형 → 은유 (narrative.md §2).
  2. 오브젝트 또는 씬? 1초 테스트 적용(scenes.md). 장소/설치 → 씬 (pool 패턴); 접근성/가시성에 관한 소프트웨어 → repo; 시계에 의해 운영되는 장소(호텔, 공연장, 소매업)를 위한 소프트웨어 → city; 제품 → 오브젝트 형태.
  3. 테제 라인(카테고리 습관 vs moat가 실현하는 것).
  4. 챕터 계획: 10–15개 챕터 (narrative.md §3, 또는 서비스 비즈니스의 경우 §3b 시공 순서). 모든 챕터는 카메라, 스테이지/모드, 그레이딩, 값, 레이아웃 모양 중 ≥ 2개를 변경합니다.
  5. 모든 카피 (§4): 헤드라인 ≤ 7단어, 본문 ≤ 35단어, 하나의 주장 + 하나의 증거, brief에서만 가져올 것.
  6. 형식을 다양화하세요 — 어떤 두 클라이언트도 같은 페이지를 가질 수 없습니다. 스크롤이 의미하는 바(여정, 빌드 순서, 시계…), 독자가 하는 일(읽기, 탭, 드래그, 재생), 3D가 반응하는 대상(스크롤 전용 또는 send/receive를 통한 위젯)을 결정하고 brief에 작성하세요. 저장소가 있는 소프트웨어의 경우 챕터를 플레이 가능하게(type: 'play') 만드세요: 데모 데이터에서 제품의 실제 컴포넌트를 작고 정직하게 복사하여 3D를 움직이는 것 (engine.md → HotelSaaS).

3 · 아트 디렉션

art-direction.md: 조명 우선 60·30·10 팔레트(브랜드 색상 + 제품 색상 + 보조 포인트 색상, 핸드오버에 이론 설명), 클라이언트 고유의 글꼴, 사실성을 위한 bloom 0, 복잡한 3D 위의 카피 카드, 모든 3D 챕터에 대한 모바일 키프레임.

4 · 이미지 (병렬 작업)

research/<slug>/images.json 작성(서비스별 사진 1장 + og) 후 node .claude/skills/moat-landing/tools/gen-batch.mjs research/<slug>/images.json 실행 (빌드하는 동안 백그라운드에서). 연락처 시트를 검토하고; 거부된 것은 다시 생성하세요. 원시 파일은 research/에 유지하고, 절대 public/에 넣지 마세요. 중요: GEMINI_API_KEY는 셸 환경에 있어야 합니다 — 절대 출력하거나 인수로 전달하지 마세요. 소프트웨어 / 개발자 브랜드: 사진 촬영은 건너뛰고; 히어로가 승인된 후 히어로 렌더링에서 직접 public/og.jpg를 만드세요(1200×630 뷰포트 스크린샷).

5 · 빌드

SLUG=<slug>; ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
mkdir -p "$ROOT/pages/$SLUG" && rsync -a --exclude node_modules --exclude dist "$ROOT/.claude/skills/moat-landing/template/" "$ROOT/pages/$SLUG/"
cd "$ROOT/pages/$SLUG" && npm install

src/content.js 재작성 (스키마: 템플릿의 content.js 상단 + engine.md), meta.url/image, business, brand.copyCards, quickActions, 챕터 notes/cover/mobile 포함. 페이지별 CSS는 brand.css에 넣습니다. 새로운 기능 → template/에 먼저 구축한 후, rsync -a --exclude content.js template/src/ pages/<slug>/src/ 실행.

5b · 기타 페이지 (클라이언트 사이트에 다른 페이지가 있을 때)

원본 사이트의 모든 페이지를 원래 URL로 다시 구축하세요(src/pages/<slug>.js, engine.md → 다중 페이지): 각 하위 페이지는 동일한 3D 세계, 카드 언어 및 하나의 플레이 가능한 조각을 유지합니다(기능 → 탐색기, 가격 → 플랜 선택기, 정보 → 스토리 위젯); 법률 페이지는 라이브 텍스트와 함께 doc 유형을 사용하며(검토를 위해 날짜 및 관할권 플래그 지정); 연락처는 WhatsApp/이메일 양식을 사용합니다(승인 없이 백엔드 없음).

6 · 검증 (필수, 모든 반복, 두 사이즈 모두)

npm run check (예산 게이트) → 미리보기 → 모든 챕터를 1440×900 및 390×844로 캡처 → 연락처 시트 → 동작 + SEO 검사 → qa.md의 평가 기준. 2–3회 반복 예상.

7 · 핸드오버

실행 위치(npm run dev / 미리보기 URL), 테제, 챕터 맵, 색상 이론 근거, 클라이언트가 여전히 제공해야 하는 것(실제 증거, 양식 엔드포인트, 분석 ID, 도메인), 선택된 기본값, advanced.md §9의 상위 2–3개 업그레이드. 게시 전에 수치, 규제 및 비교 주장을 반드시 검증해야 한다는 점을 상기시키세요. lessons.md와 메모리를 학습한 내용으로 업데이트하세요.

디자인 규칙 (클라이언트 피드백 기반 — 기본 적용)

  • 일초 인식성. 실제 것을 먼저 만드세요; 그런 다음 잘라서 보여주세요.
  • 글로우 효과 없음. 실제 물체에는 Bloom 0; 빛은 태양, 하늘 및 씬 내 소스에서 옵니다.
  • 물리적/서비스 비즈니스에는 밝고 햇살 가득한 팔레트; 야간/기술 주제에만 어두운 팔레트.
  • 절대 질감 위에 텍스트를 배치하지 마세요. 물, 타일 및 복잡한 3D 위에는 카드 사용.
  • 섹션 컷 + 고정 라벨로 설명하고, X-ray 글로우는 사용하지 마세요.
  • 보이는 플레이스홀더를 절대 출시하지 마세요. 증거가 없으면 → 해당 챕터를 생략하고 핸드오버에 목록을 작성하세요.

비타협적 규칙

  • 전체 페이지에 하나의 히어로(오브젝트 또는 씬); 흐름 콘텐츠는 cover 챕터에 있습니다.
  • 스테이지를 스크럽하고, 카피를 트리거하세요 (카피는 재진입 시 다시 재생됨; 절대 단발성 아님).
  • 텍스트는 HTML이며, 절대 텍스처나 이미지에 베이킹되지 않음; 구조화된 데이터는 페이지가 보여주는 것만 명시합니다.
  • 정직함. 허위 지표, 고객, 로고, 인용, 인증 또는 경쟁사 사실 없음; 생성된 이미지는 일러스트레이션용으로 라벨링됨; 생성된 인물은 절대 고객으로 제시되지 않음.
  • 브랜드를 사칭하지 마세요. 사용자가 대표할 자격이 없는 브랜드를 절대 사칭하지 않음; 가상 데모는 그렇게 명시해야 함.
  • 브랜드. 항상 클라이언트 고유의 브랜드(글꼴, 색상, 로고) — 라이브 사이트에서 읽어오세요.
  • 예산 (npm run check): 페이지 JS ≤ 55 KB gz, 스테이지 ≤ 205 KB gz, 이미지 ≤ 500 KB, 캔버스 1개, DPR ≤ 1.75; WebGL 꺼짐, 동작 축소 켜짐, 390px에서 작동; 콘솔 오류 0개; 오버플로 0개.
  • 사용자의 명시적인 동의 없이 배포, 양식 엔드포인트, 분석 ID 또는 외부 계정을 설정하지 마세요.

관련 스킬