Communitygithub.com

애니메이션 웹사이트 파이프라인

URL을 입력하면 전체 브랜드 북, 히어로 배경 영상, 프론트엔드 디자인을 생성하여 Netlify에 실시간 배포하는 종단간 파이프라인입니다. 중간 질문 없이 4단계를 자동으로 실행합니다.

애니메이션 웹사이트 파이프라인란 무엇인가요?

이 스킬은 개발자와 AI 에이전트가 단일 URL로부터 완전한 브랜딩이 적용된 애니메이션 랜딩 페이지 리비전을 생성하고 Netlify에 실시간 배포할 수 있게 해주는 종단간 파이프라인입니다. 사용자가 "animated website for <url>" 또는 "/animated-website <url>"과 같은 트리거 구문을 말하면, 에이전트는 URL에서 브랜드 북을 추출하고(타이포그래피, 색상, Tailwind 토큰 포함), Nano Banana 2와 Seedance 2 모델을 사용하여 브랜드 맞춤형 히어로 배경 영상을 생성하며, Tailwind CSS와 Lucide 아이콘을 사용하여 반응형 HTML 페이지를 빌드하고, 최종적으로 Netlify에 배포합니다. 모든 출력물은 `$PWD/sites/<slug>/` 아래에 네임스페이스되어 여러 사이트가 한 프로젝트에 공존할 수 있습니다. 파이프라인은 4개의 독립적인 단계로 구성되어 있으며, 각 단계는 이미 완료된 경우 건너뛰어 크레딧과 시간을 절약합니다. 이 도구는 Claud AI의 Artifacts보다 더 높은 품질의 출력을 목표로 하며, 중간에 어떤 창의적 입력이나 승인도 요청하지 않습니다. 특히 디자인 비교, 신속한 프로토타이핑, 또는 기존 브랜드의 프리미엄 리브랜딩이 필요할 때 유용합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ChuchoMonster/claude-code-skills/tree/HEAD/skills/animated-website

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

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

문서

애니메이션 웹사이트 파이프라인은(는) 무엇을 하나요?

종단간 - URL을 입력하면 배포된 Netlify URL이 출력됩니다. 네 단계, 중간 프롬프트 없음. 출력물은 $PWD/sites/<slug>/ 아래에 네임스페이스되어 여러 사이트가 하나의 상위 프로젝트에 공존할 수 있습니다.

작동 방법

  1. 사용자 메시지 또는 $1 인수에서 URL을 추출합니다. URL이 없으면 한 번만 물어보고 중단합니다. 그렇지 않으면 조용히 진행합니다.
  2. URL 호스트에서 슬러그(slug) 와 사이트 이름을 파생합니다:
    • 호스트 acmegrowthpartners.com → 슬러그 acme-growth, 사이트 이름 Acme Growth Partners (타이틀 케이스)
    • www. 제거, TLD 제거, 점을 하이픈으로 바꾸고 소문자로 변환. 사람 친화적인 사이트 이름은 브랜드 인식에 기반한 합리적인 타이틀 케이스를 사용합니다 (예: acmegrowthpartners.com → Acmegrowthpartners가 아닌 Acme Growth Partners). 슬러그는 파일명과 URL에만 사용합니다.
  3. 필수 구성 요소를 병렬로 확인합니다:
    • npx playwright --version (브랜드 북 추출 의존성)
    • grep -l KIE_AI_API_KEY "$PWD/.env" || grep -l KIE_AI_API_KEY "$HOME/<your-project-dir>/.env" (KIE.ai API 키)
    • command -v netlify (배포 단계를 위한 Netlify CLI)
    • mkdir -p "$PWD/sites/<slug>"

필수 구성 요소 중 하나라도 실패하면 정확한 문제를 표시하고 중단합니다. Playwright, Netlify를 설치하거나 API 키를 추측하려고 시도하지 마세요.

1단계 — 브랜드 북 (건너뛰기 가능)

건너뛰기 조건: $PWD/sites/<slug>/brand/typography.md, colors.md, tailwind.snippet.js, reference.png가 모두 존재하고 reference.png가 최근 24시간 이내에 수정된 경우. 건너뛰면 "→ 브랜드 북 캐시 재사용"을 로그로 기록하고 진행합니다.

  1. 브랜드 북 추출기를 실행합니다:
    node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand"
    
  2. sites/<slug>/brand/type-styles.json, sites/<slug>/brand/css-variables.json을 읽고 sites/<slug>/brand/reference.png를 봅니다.
  3. 브랜드 북 스킬의 형식에 따라 sites/<slug>/brand/typography.md, colors.md, tailwind.snippet.js, README.md를 작성합니다 - 불일치 우선, 타입 스케일 표, 팔레트 그룹, 의미론적 이름의 Tailwind 토큰. 합리화하고 코드화하지 않는 규칙을 적용합니다.
  4. 묻지 않고 GitHub에 자동 게시합니다 (이것은 귀하의 GitHub 계정 아래에 공개 리포지토리를 생성합니다 — 아래에 <your-github-username>을 설정하거나, 브랜드 북을 게시하고 싶지 않으면 이 단계를 제거하세요):
    • 리포지토리 이름: Brand-Book-<TitleCaseSlug> (예: Brand-Book-Acme-Growth-Partners). 단어 사이에 하이픈.
    • mcp__github__create_repository (소유자: <your-github-username>, 공개, autoInit: true)를 사용한 다음, 6개 파일 모두와 함께 mcp__github__push_files를 사용합니다 (reference.png는 도구 인수 제한에 비해 너무 크므로 건너뜁니다).
    • 리포지토리가 이미 존재하는 경우 (create에서 HTTP 422), 계속 진행합니다 - 바로 mcp__github__push_files를 호출하여 업데이트합니다.

캡처: BRAND_REPO_URL, 그리고 colors.md에서 합리화된 기본, 강조, 중립, 표면-어두움 16진수 값 (3단계에서 다시 읽습니다).

2단계 — 히어로 루프 영상 (건너뛰기 가능)

건너뛰기 조건: $PWD/sites/<slug>/hero-loop-7s.mp4가 존재합니다. "→ 히어로 영상 캐시 재사용"을 로그로 기록하고 진행합니다.

  1. 방금 작성한 브랜드 북 아티팩트에서 시각적 컨셉을 도출합니다:
    • colors.md에서 합리화된 팔레트를 검사합니다 → 지배적인 브랜드 감정을 선택합니다 (예: 성장 지향 브랜드의 경우 궤적 + 잠금 해제; 따뜻한 팔레트의 경우 따뜻함 + 장인정신; 미니멀 단색의 경우 절제 + 정밀).
    • reference.png에서 시각적 모티프를 살펴봅니다 (그라데이션 방향, 선 작업, 입자/그레인 처리, 기하학적 모양).
    • 브랜드의 언어적 포지셔닝을 모션에 매핑하는 한 문장 영상 은유를 종합합니다.
    • 이것은 창의적인 작업입니다 - 진지하게 받아들이고 일반적인 템플릿에 의존하지 마세요. 스크린샷을 확인하세요.
  2. 루프의 "시작" 비트를 포착하는 1:1 정지 이미지로 Nano Banana 2 이미지 프롬프트를 작성합니다. 정확한 브랜드 16진수 코드를 참조하세요. "텍스트 없음, 로고 없음, 시네마틱, 프리미엄 B2B 미학"으로 끝맺습니다.
  3. Nano Banana 2에 제출합니다:
    source "$PWD/.env" 2>/dev/null || source "$HOME/<your-project-dir>/.env"
    curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \
      -H "Authorization: Bearer $KIE_AI_API_KEY" \
      -H "Content-Type: application/json" \
      --data-binary @- <<EOF
    { "model": "nano-banana-2", "input": { "prompt": "<IMAGE_PROMPT>", "output_format": "png", "image_size": "1:1" } }
    EOF
    
    taskId를 캡처합니다. state == "success"가 될 때까지 https://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID>를 폴링합니다. data.resultJson (JSON 문자열)에서 URL을 파싱합니다. 다운로드하지 마세요 - 클라우드 URL을 유지합니다.
  4. 7초 동안의 시간 코드 비트로 Seedance 프롬프트를 작성합니다. 항상 다음을 포함하세요:
    • 0-2초: 구축 (카메라 드리프트, 분위기)
    • 2-4초: 빌드 (모션 가속화/수렴)
    • 4-5초: 해제 (브랜드 "잠금 해제" 순간 - 일반적으로 강조 색상이 퍼짐)
    • 5-7초: 해결 (루프 가능한 상태로 안정화)
    • 꼬리말: "느린 제어된 카메라, 떨림 없음. 현실적인 빛 발광 물리. 텍스트 없음, 로고 없음."
  5. 클라우드 이미지 URL을 image_url로 Seedance 2에 제출합니다:
    cat > /tmp/seedance-payload.json <<'EOF'
    { "model": "bytedance/seedance-2",
      "input": { "prompt": "<VIDEO_PROMPT>", "image_url": "<CLOUD_IMAGE_URL>",
                 "duration": 7, "resolution": "480p", "aspect_ratio": "16:9" } }
    EOF
    curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \
      -H "Authorization: Bearer $KIE_AI_API_KEY" \
      -H "Content-Type: application/json" \
      --data-binary @/tmp/seedance-payload.json
    
    taskId를 캡처합니다. 백그라운드에서 폴링 루프를 실행합니다 (run_in_background: true) - 일반적으로 3-5분 소요. 완료 알림을 받으면 recordInfo 엔드포인트를 직접 호출하여 state를 읽습니다 (bash 내 Python 폴링 파서는 취약하므로 백그라운드 알림 후 직접 curl을 선호).
  6. 최종 영상을 $PWD/sites/<slug>/hero-loop-7s.mp4로 다운로드합니다.

캡처: VIDEO_PATH.

3단계 — 프론트엔드 디자인 빌드 (건너뛰기 가능)

건너뛰기 조건: $PWD/sites/<slug>/index.html이 존재합니다. "→ 사이트 캐시 재사용"을 로그로 기록하고 진행합니다. (사용자가 재빌드를 원하면 파일을 삭제하거나 요청에 --force를 전달합니다.)

이것은 사용자가 claude.ai의 Artifacts와 비교하는 작업 산출물입니다. 품질이 중요합니다.

  1. 프론트엔드 디자인 하위 스킬에 대한 컨텍스트를 로드합니다:
    • sites/<slug>/brand/tailwind.snippet.js 읽기 (전체 내용)
    • sites/<slug>/brand/typography.md 및 colors.md 읽기 (합리화 요약만)
    • 로컬 영상 경로 참고: ./hero-loop-7s.mp4 (index.html과 형제 — 중요: 이전 구조처럼 ../references/...를 사용하지 마세요)
    • 소스 URL 참고 (콘텐츠/카피 참조용 - 페이지는 복제본이 아닌 리비전이어야 함)
  2. Skill 도구를 통해 frontend-design:frontend-design 스킬을 호출합니다. 모든 다음을 포함하는 단일 자체 포함 프롬프트를 전달하세요:
    • 출력 경로 - $PWD/sites/<slug>/index.html (단일 파일, 자체 포함). 영상은 그 옆에 ./hero-loop-7s.mp4에 있습니다.
    • 브랜드 토큰 - sites/<slug>/brand/tailwind.snippet.js의 전체 Tailwind theme.extend 블록을 붙여넣습니다.
    • 히어로 영상 - 히어로 배경으로 <video autoplay loop muted playsinline>과 함께 src ./hero-loop-7s.mp4를 참조하고, 텍스트 가독성을 위해 어두운 그라데이션 스크림을 추가합니다.
    • 콘텐츠용 소스 URL - 디자인 하위 스킬에 <URL>의 랜딩 페이지 리비전을 작성하라고 지시합니다: 가치 제안과 주요 섹션(히어로, 사회적 증명, 서비스/솔루션, CTA, 푸터)을 유지하되 디자인 품질, 타이포그래피 계층 구조 및 모션 폴리시를 향상시킵니다.
    • 품질 기준 - "프로덕션 수준, 차별화됨, 일반적인 AI 미학 피함. 사용자는 이것을 claude.ai Artifacts 출력과 비교하고 있습니다 - 더 높은 목표를 설정하세요."
    • 기술 스택 - 바닐라 HTML + CDN을 통한 Tailwind (https://cdn.tailwindcss.com) + Lucide 아이콘 + Google Fonts. Tailwind 구성을 인라인으로 포함하여 브랜드 토큰을 사용합니다.
    • 콘텐츠 정확성 - 라이브 사이트에 명명된 제품/모듈/서비스가 있으면 그대로 사용합니다. 확실하지 않으면 카피를 작성하기 전에 WebFetch를 사용하여 URL에서 실제 모듈을 열거합니다. 존재하지 않는 제품을 만들어내지 마세요.
  3. 하위 스킬이 완료된 후 $PWD/sites/<slug>/index.html이 존재하고 ./hero-loop-7s.mp4를 참조하는지 확인합니다.

캡처: SITE_PATH.

4단계 — Netlify 배포

  1. 이 슬러그에 대한 Netlify 사이트를 생성하거나 재사용합니다. 명확하고 안정적인 사이트 이름 패턴을 사용하세요: animated-<slug> (예: animated-acme-growth).
  2. $PWD/sites/<slug>/에서 프로덕션으로 배포합니다:
    cd "$PWD/sites/<slug>" && netlify deploy --prod --dir=. --site=animated-<slug> 2>&1
    
    • 슬러그에 대한 첫 번째 실행에서 Netlify는 사이트가 존재하지 않는다고 말할 것입니다. 그 경우 명시적으로 생성하세요: netlify sites:create --name=animated-<slug> 그런 다음 배포를 다시 실행하세요.
    • 배포 출력에서 Website URL:을 캡처합니다 (라이브 *.netlify.app URL).
  3. 빠른 스모크 체크: curl -sI <LIVE_URL> | head -1은 HTTP/2 200을 반환해야 합니다. 그렇지 않으면 실패를 표시하지만 로컬 경로는 여전히 보고합니다.

캡처: LIVE_URL.

최종 출력

네 단계가 모두 성공하면 사용자에게 하나의 짧은 메시지 - 네 개의 링크만 보냅니다:

라이브      - <LIVE_URL>
브랜드 북 - <BRAND_REPO_URL>
히어로 영상 - <VIDEO_PATH>
로컬 사이트 - <SITE_PATH>

무엇이 빌드되었는지 요약하지 마세요. 요약하지 마세요. 로컬 파일을 자동으로 열지 마세요 - 라이브 URL이 이제 전달물입니다.

주의 사항

  • 실행 중에 사용자에게 묻지 마세요. 핵심은 중간에 핸드오프가 없다는 것입니다. 진정으로 누락된 것이 있으면 (URL 없음, API 키 없음, Netlify CLI 없음) 차단기를 표시하고 중단하세요 - 창의적 입력을 요청하지 마세요.
  • 이미 실행된 단계는 건너뛰세요. 세 가지 아티팩트 단계는 모두 파일 존재 여부에 따라 멱등적입니다. 다시 실행하면 크레딧이 낭비됩니다.
  • 영상 경로는 형제 HTML 파일에 상대적이어야 합니다. ./hero-loop-7s.mp4를 사용하고 ../references/...를 사용하지 마세요. 각 사이트는 sites/<slug>/에 완전히 자체 포함됩니다.
  • 각 사이트는 자체 Netlify 사이트이지 하위 경로가 아닙니다. --site=animated-<slug>로 배포하여 자체 *.netlify.app URL을 얻습니다. 5개 사이트를 하나의 Netlify 프로젝트에 마운트하려고 하지 마세요.
  • KIE 호스팅 이미지 URL은 임시입니다 - 동일한 세션 내에서 Seedance 작업을 제출하세요.
  • data.resultJson은 객체가 아닌 JSON 문자열입니다. 파싱하세요.
  • GitHub 리포지토리가 이미 존재합니까? 실패하지 마세요 - 새 파일을 푸시하여 업데이트하세요.
  • netlify-cli를 자동으로 설치하지 마세요. command -v netlify가 실패하면 사용자에게 npm install -g netlify-cli && netlify login을 실행하라고 알리고 중단하세요.
  • 브랜드 충실도 > 제품 이름에 대한 창의적 자유. 항상 라이브 사이트의 실제 제품/모듈 이름을 사용하세요. 페이지 카피를 작성하기 전에 WebFetch를 실행하여 확인하세요.
  • 브랜드 북 스크린샷 품질은 컨셉 도출에 중요합니다. 스크린샷이 대부분 비어 있어도 (쿠키 배너 오버레이, 지연 로드된 섹션이 렌더링되지 않음) 계속 진행하세요 - type-styles JSON + 색상 팔레트 + 브랜드 포지셔닝에 대한 지식을 사용하여 컨셉을 도출하세요.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬