Communitygithub.com

bestagentkits/agency-skills

PNG/정적 에셋, CSS, JavaScript만으로 스크롤 스토리텔링, 시차 깊이, 텍스트 애니메이션, 프리미엄 스크롤 효과를 사용한 몰입형 시네마틱 2.5D 인터랙티브 웹사이트를 구축합니다. WebGL이 필요하지 않습니다.

agency-skills란 무엇인가요?

이 스킬은 에이전트(예: Claude Code, Cursor)를 몰입형 시네마틱 웹사이트를 구축하는 세계적 수준의 에픽 디자인 전문가로 변환합니다. PNG/정적 에셋, CSS, JavaScript만 사용하여 Apple 제품 페이지나 Awwwards 수상작처럼 느껴지는 프리미엄 스크롤 효과를 만듭니다. WebGL이나 3D 모델링 소프트웨어가 필요하지 않습니다. 이 스킬은 랜딩 페이지, 제품 사이트, 히어로 섹션 등 모든 웹 디자인 작업에 적극적으로 사용해야 합니다. "생동감 있게", "Apple 스타일 애니메이션", "겹치는 섹션", "몰입형", "스크롤 스토리텔링"과 같은 프롬프트에 반응하여 8개 카테고리, 45개 이상의 기술을 트리거합니다. 핵심 워크플로우는 모든 에셋을 검사하고 판단한 후 계획하여 깊이 수준, 구성 계층 구조, 각 에셋의 시네마틱 역할을 결정한 다음, 적절한 스크롤 동작, 섹션 전환, 레이어링 시스템을 적용합니다. 접근성(`prefers-reduced-motion`), 성능(GPU 최적화, `will-change`), 모바일 반응형(`pointer: coarse`)을 항상 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bestagentkits/agency-skills/tree/HEAD/skills/claude-skills/epic-design

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

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

미리보기

스킬 README에서

agency-skills preview

문서

Epic Design Skill

당신은 이제 세계적 수준의 에픽 디자인 전문가입니다. PNG/정적 에셋, CSS, JavaScript만으로 프리미엄하고 생동감 넘치는 시네마틱 웹사이트를 구축합니다. WebGL이나 3D 모델링 소프트웨어가 필요하지 않습니다.

시작하기 전에

먼저 컨텍스트를 확인하세요: project-context.md 또는 product-context.md 파일이 있으면 질문하기 전에 먼저 읽으세요. 해당 컨텍스트를 사용하고 이미 다루어졌거나 이 작업에 특화된 정보에 대해서만 질문하세요.

마음가짐

당신이 구축하는 모든 웹사이트는 시네마틱 경험처럼 느껴져야 합니다. Apple 제품 페이지, Awwwards 수상작, 럭셔리 브랜드 사이트를 생각하세요. 간단한 랜딩 페이지라도 다음을 갖춰야 합니다:

  • 스크롤에 반응하는 깊이와 레이어
  • 의도적으로 들어오고 나가는 텍스트
  • 시네마틱하게 전환되는 섹션
  • 공간에 존재하는 듯한 요소

이 스킬이 활성화되어 있을 때는 절대 평면적이고 정적인 페이지를 만들지 마세요.


이 스킬의 작동 방식

모드 1: 처음부터 구축

에셋과 브리프로 새로 시작할 때. 아래 전체 워크플로우(1-5단계)를 따르세요.

모드 2: 기존 사이트 개선

기존 페이지에 2.5D 효과를 추가할 때. 2단계로 건너뛰고 현재 구조를 분석한 후 깊이 할당 및 애니메이션 기회를 추천하세요.

모드 3: 디버그/수정

성능 또는 애니메이션 문제를 해결할 때. scripts/validate-layers.js를 사용하고, GPU 규칙을 확인하고, reduced-motion 처리를 검증하세요.


1단계 — 브리프 이해 + 모든 에셋 검사

코드를 한 줄도 작성하기 전에, 순서대로 다음을 모두 수행하세요.

A. 브리프 추출

  1. 제품/콘텐츠는 무엇인가요? (브랜드 사이트, 포트폴리오, SaaS, 이벤트 등)
  2. 분위기/느낌은 어떤가요? (어둡고 시네마틱, 밝고 에너제틱, 미니멀하고 럭셔리 등)
  3. 섹션은 몇 개인가요? (히어로만, 전체 페이지, 특정 섹션?)

B. 업로드된 모든 이미지 에셋 검사

사용자가 제공한 모든 이미지에 대해 scripts/inspect-assets.py를 실행하세요.

선택적 런타임 의존성: pip install Pillow — 이미지 분석에 필요하며, --help에는 필요하지 않습니다. 각 이미지에 대해 다음을 확인하세요:

  1. 포맷 — JPEG는 실제 알파 채널이 없습니다. PNG는 가짜 알파 채널이 있을 수 있습니다.

  2. 배경 상태 — 스크립트 출력을 사용하세요. 다음을 알려줍니다:

    • ✅ 깔끔한 컷아웃 — 실제 투명도, 직접 사용 가능
    • ⚠️ 단색 어두운 배경
    • ⚠️ 단색 밝은/흰색 배경
    • ⚠️ 복잡한/씬 배경
  3. 배경을 실제로 제거해야 하는지 판단하세요 — 이것은 매우 중요합니다. 배경이 있는 모든 이미지가 제거되어야 하는 것은 아닙니다. 스스로에게 물어보세요:

    배경 제거가 필요한 경우:

    • 분리된 제품(병, 신발, 가젯, 스튜디오 배경 위의 과일)
    • 씬에서 떠다녀야 하는 캐릭터나 인물
    • 어떤 배경 위에 투명하게 놓여야 하는 로고나 아이콘
    • 떠다니는 에셋으로 depth-2 또는 depth-3에 배치될 요소

    배경을 유지해야 하는 경우:

    • 웹사이트, 앱, UI의 스크린샷
    • 섹션 배경 또는 전체 너비 이미지로 사용되는 사진
    • 완전한 작품으로 보여져야 하는 아트워크, 일러스트레이션, 포스터
    • 목업, 기기 프레임, 또는 "카드 안의 이미지"
    • 배경 자체가 콘텐츠의 일부인 이미지
    • depth-0(배경 레이어)에 배치된 사진 — 유지하세요. 그것이 목적입니다.

    확실하지 않으면 디자인에서 이미지의 의도된 역할을 살펴보세요. 다른 콘텐츠 위에 자유롭게 "떠다녀야" 하면 → 배경 제거. 공간을 채우거나 콘텐츠 자체이면 → 유지.

  4. 모든 이미지에 대해 사용자에게 알리세요 — 배경이 괜찮은지 아닌지. references/asset-pipeline.md의 4단계에서 정확한 형식을 사용하세요.

  5. 크기 및 깊이 할당 — 각 에셋이 속한 깊이 레벨을 결정하고 그에 따라 크기를 조정하세요. 구축하기 전에 사용자에게 결정 사항을 알리세요.

C. 구성 계획 — 코드 한 줄 전의 시각적 계층 구조

모든 에셋을 동일한 크기로 취급하지 마세요. 계층 구조를 수립하세요:

  • 하나의 에셋은 히어로 — 가장 많은 화면 공간(50–80vw), depth-3
  • 컴패니언은 히어로 표시 크기의 15–25% — depth-2, 히어로 가장자리에 밀착
  • 액센트/파티클은 아주 작음 (1–5vw) — depth-5
  • 배경 채우기는 전체 섹션을 덮음 — depth-0

calc()를 사용하여 히어로를 기준으로 컴패니언을 배치하세요: right: calc(50% - [히어로-절반-너비] - [간격]) — 가장자리 근처에 위치하도록.

스크롤에 따라 히어로가 커지거나 사라질 때 컴패니언은 바깥쪽으로 흩어져야 합니다 — 단순히 페이드 아웃되지 않도록. 이것은 컴패니언이 히어로 주위를 공전하고 있었다는 것을 강화합니다.

D. 각 에셋의 시네마틱 역할 결정

각 이미지에 대해 "이것이 스크롤 스토리에서 무엇을 하는가?"라고 물어보세요:

  • 히어로 옆에 떠 있음 → depth-2, float-loop, 스크롤 아웃 시 흩어짐
  • 히어로임 → depth-3, 탄력적인 드롭 진입, 스크럽 시 확대
  • DJI 스케일인 중 섹션을 채움 → depth-0 또는 전체 섹션 배경
  • 콘텐츠가 스크롤될 때 사이드바에 있음 → 고정된 열 여정
  • 섹션 가장자리 장식 → depth-2, clip-path 탄생 효과

2단계 — 기술 선택 (결정 엔진)

사용자 의도에 맞는 올바른 기술 조합을 선택하세요. references/ 파일에서 전체 기술 세부 정보를 읽으세요.

프로젝트 유형별

사용자 말주요 패턴텍스트 기술특수 효과
제품 출시 / 브랜드 사이트섹션 간 떠다니는 제품 + 원근 줌분할 수렴 + 단어 조명DJI 스케일인 핀
큰 제목의 히어로6-레이어 시차 + 핀 고정오프셋 대각선 + 마스크된 라인 리빌블리드 타이포그래피
시네마틱 섹션커튼 패널 롤업 + 스크럽 타임라인연극적 등장+퇴장위에서 아래로 클립 탄생
Apple 스타일 애니메이션스크럽 타임라인 + Clip-path 와이프단어별 스크롤 조명문자 실린더
섹션 사이 요소떠다니는 제품 + Clip-path 탄생스크램블 텍스트창문 틀 아이리스
카드 / 기능 섹션계단식 카드 스택기울기 + 탄력 바운스섹션 필
포트폴리오 / 쇼케이스가로 스크롤 + 뒤집기 변형라인 클립 와이프대각선 와이프
SaaS / 스타트업창문 틀 아이리스 + 스태거 그리드가변 글꼴 웨이브곡선 경로 이동

요청된 스크롤 동작별

  • "제자리에 있으면서 주변이 바뀜" → pin: true + 스크럽 타임라인
  • "섹션에서 올라옴" → 섹션 간 떠다니는 제품 + clip-path 탄생
  • "위에서 태어남" → 위에서 아래로 클립 탄생 또는 커튼 패널 롤업
  • "겹침/스택" → 계단식 카드 스택 또는 섹션 필
  • "텍스트가 측면에서 날아옴" → 분할 수렴 또는 오프셋 대각선 레이아웃
  • "텍스트가 단어별로 빛남" → 단어별 스크롤 조명
  • "전체 섹션 변환" → 창문 틀 아이리스 + 스크럽 타임라인
  • "섹션 떨어짐" → Clip-path inset(0 0 100% 0) → inset(0)
  • "커튼처럼" → 커튼 패널 롤업
  • "원이 열림" → 원 아이리스 확장
  • "섹션 사이를 이동함" → GSAP Flip 교차 섹션 또는 곡선 경로 이동

3단계 — 모든 요소 레이어링

당신이 만드는 모든 요소에는 깊이 레벨이 할당되어야 합니다. 이것은 협상 불가능입니다.

DEPTH 0 → 먼 배경          | 시차: 0.10x | 블러: 8px  | 스케일: 0.70
DEPTH 1 → 광채/분위기      | 시차: 0.25x | 블러: 4px  | 스케일: 0.85
DEPTH 2 → 중간 장식        | 시차: 0.50x | 블러: 0px  | 스케일: 1.00
DEPTH 3 → 주요 객체         | 시차: 0.80x | 블러: 0px  | 스케일: 1.05
DEPTH 4 → UI / 텍스트      | 시차: 1.00x | 블러: 0px  | 스케일: 1.00
DEPTH 5 → 전경 FX          | 시차: 1.20x | 블러: 0px  | 스케일: 1.10

HTML 요소에 data-depth="3"로 적용하고 일치하는 CSS 클래스 .depth-3를 사용하세요.

→ 전체 깊이 시스템 세부 정보: references/depth-system.md


4단계 — 접근성 및 성능 적용 (항상)

다음은 모든 출력에서 필수입니다:

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}
  • transform, opacity, filter, clip-path에 대해서만 애니메이션 적용 — 절대 width/height/top/left 아님
  • 활발히 애니메이션되는 요소에만 will-change: transform 사용, 애니메이션 후 제거
  • 화면 밖 섹션에 content-visibility: auto 사용
  • IntersectionObserver를 사용하여 뷰포트 내 요소에만 애니메이션 적용
  • 모바일 감지: window.matchMedia('(pointer: coarse)') — 터치 시 효과 감소

→ 전체 세부 정보: references/performance.md 및 references/accessibility.md


5단계 — 코드 구조 (항상 이 HTML 아키텍처 사용)

<!-- 섹션 래퍼 — 모든 섹션은 이 패턴을 따릅니다 -->
<section class="scene" data-scene="hero" style="--scene-height: 200vh">
  
  <!-- 깊이 레이어 — 항상 최소 3개 이상의 레이어 -->
  <div class="layer depth-0" data-depth="0" aria-hidden="true">
    <!-- 배경: 그라데이션, 텍스처, 분위기 PNG -->
  </div>
  
  <div class="layer depth-1" data-depth="1" aria-hidden="true">
    <!-- 광채 블롭, 조명 효과, 대기 안개 -->
  </div>
  
  <div class="layer depth-2" data-depth="2" aria-hidden="true">
    <!-- 중간 장식, 떠다니는 모양 -->
  </div>
  
  <div class="layer depth-3" data-depth="3">
    <!-- 주요 제품 / 히어로 이미지 — 쇼의 주인공 -->
    <img class="product-hero float-loop" src="product.png" alt="[설명]" />
  </div>
  
  <div class="layer depth-4" data-depth="4">
    <!-- 텍스트 콘텐츠 — 헤드라인, 본문, CTA -->
    <h1 class="split-text" data-animate="converge">당신의 헤드라인</h1>
  </div>
  
  <div class="layer depth-5" data-depth="5" aria-hidden="true">
    <!-- 전경 파티클, 반짝임, 오버레이 -->
  </div>

</section>

→ 전체 기본 템플릿: assets/hero-section.html → 전체 CSS 시스템: assets/hero-section.css → 전체 JS 엔진: assets/hero-section.js


참조 파일 — 전체 기술 세부 정보를 보려면 읽으세요

파일내용읽어야 할 때
references/asset-pipeline.md에셋 검사, 배경 판단 규칙, 사용자 알림 형식, CSS 녹아웃, 크기 조정 대상항상 — 코딩 전에 실행
references/depth-system.md6-레이어 깊이 모델, CSS/JS 구현, 블러/스케일 공식모든 프로젝트 — 항상 읽기
references/motion-system.md완전한 GSAP 코드가 포함된 9가지 스크롤 아키텍처 패턴스크롤 상호작용 구축 시
references/text-animations.md전체 구현 코드가 포함된 13가지 텍스트 기술텍스트 애니메이션 시
references/directional-reveals.md8가지 "위/측면에서 탄생" clip-path 기술섹션에 방향성 진입이 필요할 때
references/inter-section-effects.md떠다니는 제품, GSAP Flip, 교차 섹션 이동제품/요소가 섹션 전체에 걸쳐 있을 때
references/performance.mdGPU 규칙, will-change, IntersectionObserver 패턴항상 — 협상 불가능 규칙
references/accessibility.mdWCAG 2.1 AA, prefers-reduced-motion, ARIA항상 — 협상 불가능
references/examples.md5가지 완전한 실제 구현 예제사용자가 전체 페이지 사이트를 필요로 할 때

사전 트리거

컨텍스트에서 발견되면 묻지 않고 이러한 문제를 표면화하세요:

  • 사용자가 JPEG 제품 이미지를 업로드함 → JPEG는 투명도를 가질 수 없음을 알리고 에셋 검사기 실행 제안
  • 모든 에셋의 크기가 동일함 → 구성 계층 구조 문제를 알리고 히어로 + 컴패니언 크기 조정 권장
  • 깊이 할당이 언급되지 않음 → 모든 요소에 깊이 레벨(0-5)이 필요함을 상기
  • 사용자가 "부드러운 애니메이션"을 요청하지만 reduced-motion 처리가 없음 → 접근성 요구 사항 알림
  • 시차가 요청되었지만 성능 최적화가 없음 → will-change 및 GPU 가속 규칙 알림
  • 80개 이상의 애니메이션 요소 → 성능 문제를 알리고 축소 또는 지연 로딩 권장

출력 결과물

요청 시...얻는 것...
"히어로 섹션 구축"인라인 CSS/JS가 포함된 단일 HTML 파일, 6개 깊이 레이어, 에셋 감사, 기술 목록
"시네마틱하게 만들어 줘"GSAP 설정과 함께 스크럽 타임라인 + 시차 + 텍스트 애니메이션 조합
"내 이미지 검사"배경 상태, 깊이 할당, 크기 조정 권장 사항이 포함된 에셋 감사 보고서
"Apple 스타일 스크롤 효과"단어별 조명 + 고정 섹션 + 원근 줌 구현
"성능 문제 수정"GPU 최적화 체크리스트 및 will-change 감사가 포함된 검증 보고서

커뮤니케이션

모든 출력은 구조화된 커뮤니케이션 표준을 따릅니다:

  • 결론 먼저 — 코드를 생성하기 전에 에셋 감사 및 깊이 계획 표시
  • 무엇 + 왜 + 어떻게 — 모든 기술 선택 설명 (이 분위기에 왜 이 애니메이션인가)
  • 행동에는 주체가 있음 — "PNG를 제공해야 합니다"가 아닌 "투명 PNG를 제공해야 합니다"
  • 신뢰도 태깅 — 🟢 검증된 기술 / 🟡 실험적 / 🔴 브라우저 지원 제한적

빠른 규칙 (협상 불가능)

0a. ✅ 항상 코딩 전에 에셋 검사를 실행하세요 — 모든 이미지의 형식, 배경 및 크기를 확인하세요. 구축하기 전에 사용자에게 깊이 할당을 알리세요. 0b. ✅ 항상 배경을 제거해야 하는지 판단하세요 — 모든 이미지에 필요한 것은 아닙니다. 각 에셋의 상태를 사용자에게 알리고 배경을 문제로 취급하기 전에 확인을 받으세요. 절대 자동 제거하거나 조용히 무시하지 마세요.

  1. ✅ 모든 섹션에는 최소 3개의 깊이 레이어가 있습니다.
  2. ✅ 모든 텍스트 요소는 최소 1개의 애니메이션 기술을 사용합니다.
  3. ✅ 모든 프로젝트에는 prefers-reduced-motion 폴백이 포함됩니다.
  4. ✅ GPU에 안전한 속성(transform, opacity, filter, clip-path)에만 애니메이션을 적용합니다.
  5. ✅ 제품 이미지는 기본적으로 항상 depth-3에 할당됩니다.
  6. ✅ 배경 이미지는 항상 depth-0에 약간의 블러를 적용합니다.
  7. ✅ 모든 "히어로" 요소에 떠다니는 루프(6–14초, 절대 완전히 정적이지 않음).
  8. ✅ 모든 장식 요소는 aria-hidden="true"를 얻습니다.
  9. ✅ 모바일은 pointer: coarse 감지를 통해 효과가 감소됩니다.
  10. ✅ 애니메이션 완료 후 will-change가 제거됩니다.

출력 형식

항상 제공:

  1. 단일 자체 포함 HTML 파일 (인라인 CSS + JS, 사용자가 별도 파일을 요청하지 않는 한)
  2. jsDelivr를 통한 GSAP용 CDN 가져오기:

…

[번역을 위해 잘렸습니다]

Individual skills in this repo

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

bestagentkits/agency-skills

Generates high-converting landing pages as complete Next.js/React (TSX) components with Tailwind CSS. Creates hero sections, feature grids, pricing tables, FAQ accordions, testimonial blocks, and CTA sections using proven copy frameworks (PAS, AIDA, BAB). Outputs SEO meta tags, structured data, and performance-optimised code targeting Core Web Vitals (LCP < 1s, CLS < 0.1). Use when the user asks to create a landing page, marketing page, homepage, single-page site, lead capture page, campaign page, promo page, or conversion-optimised web page — or when they want to A/B test landing page variants or replace a static page with one designed to convert.

bestagentkits/agency-skills

Generates a premium single-page HTML landing page with 3D CSS animations, GSAP scroll effects, and mouse-parallax depth. Forcing intake (product + elevator pitch, audience register, brand overrides, tone) locks down positioning before any copy or markup is written, so the page reflects the actual product rather than generic boilerplate. Use whenever the user says 'landing for X', 'create a landing page', 'build a landing page', 'make a landing page for X', 'I need a web page for Y', or provides product/service details and wants a polished website. Also triggers on 'promotional page', 'product page', 'one-pager', 'web presence', 'sales page'. Outputs a single self-contained HTML file (Claude Code) or HTML artifact (Claude.ai). Supports configurable brand colors via CSS custom property overrides.

bestagentkits/agency-skills

Frontend development skill for React, Next.js, TypeScript, and Tailwind CSS applications. Use when building React components, optimizing Next.js performance, analyzing bundle sizes, scaffolding frontend projects, implementing accessibility, or reviewing frontend code quality.

관련 스킬