Communitygithub.com

움직이는 개인 홈페이지

만화 주인공이 커서를 따라보고, 스크롤하면 섹션 사이를 연기하는 개인 사이트를 만든 뒤 공개한다.

움직이는 개인 홈페이지란 무엇인가요?

인터뷰로 캐릭터와 배경을 하나로 고정하고, 시선과 전환 영상을 만들어 정적 페이지로 조립한 다음 배포한다. 스크롤 진행이 곧 연기이다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yaohuicong/motion-homepage/tree/HEAD

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

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

문서

움직이는 개인 홈페이지은(는) 무엇을 하나요?

결과물은 정적 웹사이트(HTML/CSS/JS, 빌드 불필요)이며, 세 가지 레이어로 구성됩니다.

  1. 캐릭터 무대: 전체 화면 캔버스. AI 생성 캐릭터 비디오 프레임을 그립니다. 첫 화면에서는 마우스 방향에 따라 '추시 폐루프'의 해당 프레임을 재생하고, 다음 섹션으로 스크롤하면 두 섹션 사이의 '연결 클립'을 재생하며, 스크롤 진행도가 재생 진행도가 됩니다. 모바일 세로 모드에서는 캐릭터를 화면 위쪽에 배치합니다.
  2. 콘텐츠 섹션: 첫 화면 / 이력서 / 포트폴리오 목록 / 주요 작품 / 마무리. 텍스트는 무대 위에 오버레이되며, 캐릭터가 있는 쪽을 피해 배치됩니다.
  3. 손 그림 장식 및 효과: 낙서(등장 시 한 획으로 그려지고 이후 손 그림 애니메이션처럼 떨림), 천천히 변형되는 물감 색 블록, 캐릭터 머리를 따라다니는 말풍선, 손 그림 원과 브러시 밑줄, 마우스가 캐릭터 위를 지나갈 때의 회전 잔물결 왜곡(React Bits의 'Ripple Distortion', WebGL, 무대에만 적용, 미지원 시 노란색 형광펜 잔상으로 대체), 한 글자씩 나타나는 효과, 떠다니는 작은 만화 스티커.

기본 템플릿은 '어두운 손 그림 낙서 + 3D 주인공' 스타일(거의 검은 배경 + 형광 노랑/초록/보라/파랑/주황, 마커 펜 손글씨 제목, 3D 만화 캐릭터와 2D 낙서 스티커)이며, 사이트 전체는 영어입니다. 스타일 변경은 theme(색상, 폰트)와 각 섹션의 decor(장식) 설정만 바꾸면 되며, 엔진을 수정할 필요가 없습니다.

웹사이트의 완성도는 70%가 소재의 일관성(동일한 캐릭터, 동일한 배경, 이전 섹션의 마지막 프레임이 다음 섹션의 첫 프레임)에 달려 있고, 30%는 레이아웃에 달려 있습니다. 따라서 이 스킬은 소재 계획과 검증에 대부분을 할애합니다. 코드는 template/에 이미 작성되어 있으며, 보통 site.config.js와 약간의 CSS만 수정하면 됩니다.

디렉토리 구조

template/                 바로 실행 가능한 템플릿 (더미 소재 포함 assets/demo/)
  site.config.js         모든 텍스트, 소재 경로, 조작 파라미터
  js/  css/              엔진과 스타일, 일반적으로 수정 불필요
  tools/calibrate.html   추시 키프레임 보정 도구
scripts/frames.py        비디오/이미지 → 웹용 프레임 시퀀스 (ffmpeg 필요)
scripts/check-site.mjs   설정과 소재가 모두 있는지 확인
scripts/fetch-reactbits.mjs  React Bits 'Ripple Distortion'을 사이트에 다운로드 (마우스가 캐릭터 위를 지날 때의 회전 잔물결 왜곡, 라이선스 문제로 템플릿에 포함되지 않음)
scripts/cutout.py        단색 배경 스티커/작은 캐릭터 → 투명 배경 webp (--split으로 스티커 모음 분할)
scripts/serve.py         로컬 미리보기 서버 (캐시 없음, 수정 후 새로고침하면 새 버전 반영)
scripts/shoot.mjs        수용 스크린샷: 헤드리스 Chrome + 실제 마우스 이벤트, 섹션별 스크린샷 (데스크탑/모바일)
scripts/make-demo-assets.py  더미 소재 재생성 (일반적으로 사용하지 않음)
references/
  01_계획.md             인터뷰 체크리스트, 섹션 및 캐릭터 동선 결정 방법
  02_소재_프롬프트.md     캐릭터, 배경, 추시, 연결, 작품 이미지 프롬프트 템플릿 및 검증 (첫 프레임만 전송하는 도구의 실제 사용법 포함)
  03_사이트_구축과_반복.md  설정 필드 설명, 일반적인 문제 및 해결 방법, 피드백 제공 방법
  04_배포.md            Netlify / Vercel / GitHub Pages / Cloudflare 및 이후 작품 추가 방법
  05_오픈소스_홈페이지_디자인_참고.md  오픈소스/공개 분해된 개인 홈페이지에서 배울 점 (사용자가 '충분히 고급스럽지 않다'고 말할 때 먼저 읽기)

작업 흐름

각 단계가 끝나면 사용자에게 실제 결과(스크린샷, 프레임 퍼즐 또는 로컬 미리보기)를 보여주고 확인을 받은 후 다음 단계로 진행합니다. 사용자가 기술에 익숙하지 않은 경우 설정을 읽게 하지 말고 화면만 보여줍니다.

1. 인터뷰 및 계획 → references/01_계획.md 읽기

먼저 다음 사항을 파악합니다: 홈페이지의 주인은 누구인지, 어떤 내용을 넣을지(이력서, 작품, 연락처), 캐릭터는 어디서 오는지(본인 사진, 기존 IP 또는 새 디자인), 어떤 스타일을 선호하는지(사용자에게 참고 이미지 1-2장 또는 웹사이트를 요청), 현재 어떤 이미지/비디오 생성 도구를 가지고 있는지. 그런 다음 사이트 디렉토리에 plan.md를 작성합니다: 섹션 순서, 각 섹션의 텍스트, 각 섹션에서 캐릭터의 포즈와 위치, 각 연결에서 캐릭터가 하는 동작. 이 '캐릭터 동선'이 이후 모든 소재의 기준이 됩니다. 포즈와 위치는 레이아웃과 일치해야 합니다(텍스트가 왼쪽에 있으면 캐릭터는 오른쪽에).

2. 소재 → references/02_소재_프롬프트.md 읽기

순서가 중요합니다. 다음 단계는 이전 단계의 결과물을 참조로 사용합니다.

  1. 캐릭터 최종 이미지: 정면, 전신 또는 반신, 표정이 선명해야 합니다. 기존 IP가 있는 경우 식별 특징(얼굴, 헤어스타일, 시그니처 액세서리)을 유지하고, 의상은 테마에 맞게 변경할 수 있습니다.
  2. 배경 바탕: 캐릭터가 없는 하나의 배경 이미지로, 사이트 전체와 모든 비디오에서 공유됩니다. 이렇게 하면 클립을 전환할 때 배경이 깜빡이지 않습니다.
  3. 포즈 키 이미지: 각 섹션당 하나씩 (캐릭터 + 동일 배경 + 동일 카메라 앵글), 계획된 포즈와 위치에 해당합니다.
  4. 추시 폐루프: 정면에서 시작하여 8개 방향을 살펴본 후 다시 정면으로 돌아옵니다. 비디오 도구가 첫 프레임과 마지막 프레임을 전송할 수 있는 경우, 분할 생성한 후 frames.py gaze-join으로 연결합니다. 첫 프레임만 전송할 수 있는 경우(많은 이미지-비디오 도구가 이렇게 동작함), '별 모양' 방법을 사용합니다: 8개 모두 첫 화면 키프레임에서 시작하여 각각 한 방향을 향하고 표정을 짓는 짧은 비디오를 생성하고, frames.py gaze-star로 합성합니다 (하나의 긴 비디오로 8개 방향을 연속 생성하면 모델이 점점 더 잘못된 방향으로 갑니다).
  5. 연결 클립: 인접한 두 포즈 키 이미지를 첫 프레임과 마지막 프레임으로 사용하여 중간 동작을 생성합니다. 첫 프레임만 전송할 수 있는 경우 순차적으로 연결 생성합니다(이전 섹션의 마지막 프레임 = 다음 섹션의 첫 프레임). 특정 섹션의 첫 프레임에 캐릭터 얼굴이 보이지 않는 경우, '역재생 방법'을 사용합니다(먼저 끝 포즈의 최종 이미지를 생성하고, 역방향 동작을 생성한 후 역재생). 그렇지 않으면 끝의 얼굴이 모델에 의해 변경될 수 있습니다.
  6. 작품 표지: 사용자가 이미 작품 이미지를 가지고 있으면 그대로 사용합니다. 가로 16:10 비율이 가장 적합합니다.

사용자가 이미지만 생성할 수 있고 비디오를 생성할 수 없는 경우, 템플릿은 여전히 작동합니다. 추시는 9장의 이미지(정면 + 8개 방향, 디졸브 전환 사용)를 사용하고, 연결은 두 포즈 이미지와 blend: true를 사용합니다. 자세한 명령과 설정은 02의 '루트 C'를 참조하세요. 효과는 약하겠지만, 사용자에게 그 차이를 정직하게 설명해야 합니다.

소재가 하나도 없는 경우 (제로 소재 첫 버전): 먼저 사이트를 구축하여 사용자에게 레이아웃과 상호 작용을 보여줍니다. 템플릿을 복사하고, 사용자 정보로 site.config.js의 텍스트, 색상, 작품을 채우고 템플릿의 더미 캐릭터를 유지합니다. 이때 다음 사항에 주의합니다.

  • 말풍선이나 텍스트에 "저는 여우입니다"와 같이 더미 캐릭터와 맞지 않는 말을 사용하지 말고, 중립적인 문장을 사용합니다.
  • 전달할 때 첫 마디로 "화면 속 캐릭터는 임시입니다. 실제 캐릭터로 교체하려면 먼저 다음 이미지/비디오를 생성해야 합니다"라고 말하고, plan.md의 소재 목록을 첨부합니다.
  • check-site.mjs는 어떤 부분에 여전히 더미 소재가 사용되고 있는지 알려줍니다. 사용자에게 전달하기 전에 이 알림을 그대로 전달합니다.

현재 환경에 이미지/비디오 생성 도구(예: 이미지 및 비디오 생성 MCP)가 있는 경우, 이를 사용하여 이미지와 비디오를 직접 생성할 수 있습니다. 도구가 첫 프레임만 전송할 수 있는 경우, 02의 '연결 생성' 방법을 따라 한 단계씩 진행합니다. 비디오 도구가 없는 경우, 사용자가 Jimeng, Kling, Vidu, Hailuo 등의 플랫폼에서 생성합니다. 이 경우 완전한 프롬프트, 업로드할 첫 프레임 및 마지막 프레임 이미지, 지속 시간 및 비율을 제공하고, 비디오를 받은 후 확인 방법을 설명합니다.

각 배치의 소재를 받으면 먼저 확인한 후 통합합니다. 프레임을 추출하여 하나의 이미지로 만듭니다(ffmpeg -i x.mp4 -vf "fps=2,scale=320:-1,tile=6x3" sheet.jpg). 02의 검증 체크리스트에 따라 항목별로 확인합니다. 문제가 있는 경우, 문제를 구체적으로 설명하고(몇 초, 무엇이 어떻게 변했는지), 프롬프트를 수정하여 다시 생성합니다.

3. 사이트 구축 → references/03_사이트_구축과_반복.md 읽기

cp -r <skill>/template <사이트_디렉토리>          # 먼저 템플릿 복사, 원본 템플릿은 수정하지 않음
cd <사이트_디렉토리>
node <skill>/scripts/fetch-reactbits.mjs .                            # 마우스가 캐릭터 위를 지날 때의 왜곡, 다운로드 실패 시 자동으로 liquid 효과로 대체
python3 <skill>/scripts/frames.py extract 연결1.mp4 assets/clips/t1     # 각 연결 클립 처리
python3 <skill>/scripts/frames.py gaze-join assets/clips/gaze 클립1.mp4 클립2.mp4 …   # 추시 (첫/마지막 프레임 분할)
python3 <skill>/scripts/frames.py gaze-star assets/clips/gaze L=왼쪽.mp4 UL=왼쪽_위.mp4 …   # 추시 (첫 프레임만 전송 가능: 별 모양)
node <skill>/scripts/check-site.mjs .
python3 <skill>/scripts/serve.py 8000                                  # http://localhost:8000 열기 (캐시 없음)

frames.py가 출력한 설정 조각을 site.config.js에 채워 넣고, 텍스트, 색상(theme.bg는 스크립트가 출력한 배경 색상을 사용하여 페이지와 비디오가 매끄럽게 연결되도록 함), 폰트를 입력합니다. 추시 비디오가 분할되어 연결된 경우, http://localhost:8000/tools/calibrate.html을 사용하여 키프레임과 머리 위치를 보정합니다.

참고 이미지를 기반으로 theme과 decor를 결정합니다. 먼저 03의 '참고 이미지에서 스타일 가져오기'에 따라 배경색, 강조색, 제목 폰트, 장식 스타일, 캐릭터 표현 방식을 기록한 후 설정을 변경합니다. 템플릿 기본값은 사이트 전체가 영어입니다(고정된 인터페이스 텍스트는 ui에서 변경). 중문과 영문 혼합 시, 영문 제목 폰트 뒤에 항상 중문 폰트를 추가합니다(예: "Permanent Marker", "ZCOOL QingKe HuangYou"). 참고 이미지가 다른 사람의 작품인 경우, 스타일 방향만 빌리고 캐릭터, 이름, 텍스트 및 레이아웃을 그대로 가져오지 않습니다.

4. 반복

브라우저에서 처음부터 끝까지 스크롤하며 03의 체크리스트에 따라 항목별로 확인합니다: 첫 화면 추시 8개 방향이 모두 자연스러운지, 첫 화면을 떠날 때 정면으로 돌아간 후 연결되는지, 각 연결 클립의 처음과 끝이 끊기지 않는지, 텍스트와 낙서가 캐릭터 얼굴을 가리지 않는지, 작품 목록 열기/닫기, 작품 캐러셀, 마지막 섹션에서 캐릭터가 패널에 가려지지 않는지, 모바일 세로 모드.

한 번에 한 가지 유형의 문제만 수정하고, 수정 후 다시 확인합니다. 이렇게 하면 각 변경 사항의 효과가 명확하고, 이미 만족스러운 부분이 손상되지 않습니다. 03에는 일반적인 문제와 해당 해결 방법이 있습니다.

5. 배포 → references/04_배포.md 읽기

기본적으로 Netlify Drop을 권장합니다(폴더를 웹페이지로 드래그 앤 드롭하면 공개 링크를 얻을 수 있음). 배포 전에 check-site.mjs를 다시 한 번 실행하여 더미 소재나 누락된 파일이 없는지 확인합니다.

전달 시 설명할 사항

  • 사이트 디렉토리 위치, 로컬 미리보기 방법, 텍스트 및 작품 교체 방법(site.config.js의 어느 부분을 수정해야 하는지).
  • 어떤 검사를 실제로 수행했는지(어떤 브라우저, 어떤 화면 크기에서 확인했는지, shoot.mjs 스크린샷은 화면 배치가 올바르다는 것만 증명하며, 애니메이션이 자연스러운지 여부는 사용자가 실제 브라우저에서 확인해야 함), 어떤 검사를 수행하지 않았는지(예: 실제 모바일 기기에서 테스트하지 않음).
  • 소재 파일 크기와 첫 화면 로딩 시간. 너무 큰 경우 압축 방법을 제시합니다.

관련 스킬