웹사이트 스타일 복제은(는) 무엇을 하나요?
목표
특정 웹사이트의 눈에 보이는 스타일, 레이아웃, 모션 및 상호 작용 느낌을 깔끔한 정적 구현체로 재현합니다.
이 스킬은 "이렇게 만들어 줘" 유형의 작업을 위한 것입니다. 느슨한 테마 참조보다 더 엄격합니다. 출력물은 독창적이고 유지보수 가능한 HTML/CSS/JS를 사용하면서 대상 사이트의 인식 가능한 구성과 동작과 유사해야 합니다.
핵심 원칙:
- 스타일과 상호 작용 패턴을 복사합니다.
- 보호된 코드, 자산, 개인 정체성, 비공개 링크 또는 분석 스크립트는 기본적으로 복사하지 않습니다.
- 깔끔한 정적 버전을 재작성합니다.
- 페이지 상대 내부 링크와 자산을 사용하여 파일 직접 열기, 로컬 HTTP 및 정적 호스팅에서 결과물이 작동하도록 합니다.
- 실제 브라우저에서 대상 사이트와 비교하여 검증합니다.
계약
입력:
- 대상 URL, 스크린샷, 템플릿, 로컬 참조 또는 구체적인 시각/모션 참조.
- 원하는 범위: 홈페이지, 선택한 페이지, 또는 전체 탐색 가능한 정적 재현.
- 출력 폴더, 권한 컨텍스트, 대상 콘텐츠를 대체할 사용자 정체성/콘텐츠.
출력:
- 대상 사이트의 인식 가능한 레이아웃, 모션, 상호 작용 느낌 및 페이지 유형을 재현하는 깔끔한 일반 HTML/CSS/JS 정적 구현체.
- 복사된 대상 정체성 대신 플레이스홀더 또는 사용자 소유 콘텐츠.
- 페이지 맵, 콘텐츠 위치, 단순화된 상호 작용 및 생략된 경로가 포함된
EDITING.md. - 비교 및 검증 요약.
경계:
- 보호된 코드, 비공개 자산, 분석 스크립트, 원본 개인 콘텐츠 또는 라이선스 없는 미디어를 재배포하지 마십시오.
- 요청된 범위가 탐색 가능한 사이트를 암시하는 경우 단일 홈페이지에서 멈추지 마십시오.
- 기본적으로 루트 절대 경로 프레임워크 경로를 유지하지 말고 정적 상대 경로로 변환하십시오.
- 게시하지 마십시오.
publish-static-site를 사용하십시오.
성공 게이트:
- 로컬 재현이 요청된 정확도에 대해 대상 사이트의 독특한 레이아웃, 시각적 언어 및 핵심 상호 작용과 충분히 일치합니다.
- 중요한 페이지 유형이 존재하고 링크되어 있습니다.
- 대상 정체성이 대체되었거나 명시적으로 허용되었습니다.
review-static-site가 통과하거나 허용된 한계만 보고할 수 있습니다.
게이트 실패 시:
- 대상을 재검사하고 독특한 레이아웃/모션을 반복합니다.
- 정체성 잔여물에 대해
personalize-site를 사용합니다. - 구조/경로/인코딩/브라우저 차단기에 대해
review-static-site를 사용합니다.
간단한 파이프라인
웹사이트 재현을 위해 다음 파이프라인을 따르십시오:
- 브라우저에서 대상을 탐색합니다.
- 대상의 내부 페이지와 클릭 가능한 경로를 매핑합니다.
- 소스 및 자산을 연구 목적으로 검사합니다.
- 독특한 레이아웃, 모션, 상호 작용 및 시각적 요소를 추출합니다.
- 원본 사이트의 정체성과 개인 콘텐츠를 대체합니다.
- 일반 HTML/CSS/JS로 전체 탐색 가능한 사이트를 재구축합니다.
- 프레임워크/루트 경로를 정적 페이지 상대 링크로 변환합니다.
- 향후 모델/사용자 편집을 위한 편집 가이드를 추가합니다.
- 실제 브라우저에서 HTTP를 통해 로컬에서 검증합니다.
- 대상과 비교하고 반복합니다.
- 남아 있는 대상별 텍스트 또는 자산을 감사합니다.
사용 시기
사용자가 다음과 같이 말하거나 암시할 때 이 스킬을 사용하십시오:
- 이 웹사이트 스타일을 복사해 주세요.
- 이 페이지를 재현해 주세요.
- 이 사이트를 클론해 주세요.
- 이 웹사이트의 정적 버전을 만들어 주세요.
- 이 URL이나 스크린샷처럼 보이게 해 주세요.
- 원본 애니메이션, 스크롤, 호버 또는 상호 작용과 일치시켜 주세요.
- 1:1, 고충실도, 픽셀 단위, 동일한 느낌, 동일한 모션.
사용자가 느슨한 영감이 아닌 밀접한 재현을 원할 때 웹사이트, v0, Figma, GitHub 테마, Astro, Hugo, Jekyll, Quartz, Next, React, Tailwind 또는 기타 프레임워크 기반 템플릿의 참조에 사용하십시오.
사용하지 말아야 할 때
다음과 같은 경우 이 스킬을 사용하지 마십시오:
- 사용자가 테마만 검색하려는 경우.
search-blog-theme를 사용하십시오. - 사용자가 선택한 방향에서 독창적인 개인 사이트를 원하는 경우.
make-personal-site를 사용하십시오. - 사용자가 콘텐츠 마이그레이션이나 게시물 가져오기를 원하는 경우.
add-blog-posts를 사용하십시오. - 사용자가 배포 도움말만 원하는 경우.
publish-static-site를 사용하십시오. - 사용자가 소유하지 않은 사이트에서 보호된 코드, 비공개 자산 또는 개인 콘텐츠를 직접 복사하도록 요청하는 경우.
- 사용자가 일반 정적 버전을 만드는 대신 원본 프레임워크와 빌드 시스템을 유지하기를 명시적으로 원하는 경우.
입력
사용 가능한 모든 것을 사용하십시오:
- 대상 URL, 스크린샷, 비디오, 템플릿 링크 또는 로컬 참조.
- 사용자가 원하는 출력 폴더.
- 최종 결과물이 플레이스홀더 콘텐츠를 유지할지 사용자 자체 콘텐츠를 사용할지 여부.
- 필요한 페이지 또는 섹션.
- 사용자가 제공하는 경우 예상 범위: 홈페이지 전용, 선택한 페이지 또는 전체 탐색 가능한 사이트.
- 사용자가 대상을 소유했거나 자산/코드를 재사용할 권한이 있는지 여부.
- 필요한 모든 정적 제약 조건: 빌드 단계 없음, 외부 종속성 없음, 로컬 배포 전용 등.
브라우저 탐색 패스
구현 전에 URL이나 대화형 참조를 사용할 수 있을 때 실제 브라우저에서 대상을 탐색하십시오.
대상과 로컬 미리보기를 관찰하는 첫 번째 선택 방법으로 실제 사용 가능한 대화형 브라우저 도구를 사용하십시오. "사용 가능"이란 도구가 스킬, 플러그인 목록 또는 시스템 설명에 언급된 것이 아니라 현재 턴의 호출 가능한 도구 목록에 노출되어 있음을 의미합니다. Codex에서는 사용자나 클라이언트가 턴에 라우팅한 경우 Browser/앱 내 브라우저 플러그인일 수 있습니다. 다른 에이전트에서는 이에 상응하는 가시적인 브라우저, browser-use 도구 또는 devtools 기반 브라우저일 수 있습니다. 목표는 사용자가 보는 것처럼 페이지를 보는 것입니다: 뷰포트, 모션, 스크롤링, 호버/클릭 동작, 모바일 레이아웃, 콘솔 상태 및 네트워크 오류.
현재 턴에 대화형 브라우저 도구가 노출되지 않은 경우 브라우저 패스가 발생했다고 가장하지 마십시오. 대상 탐색이나 로컬 비교가 이에 의존하는 경우 사용자에게 클라이언트의 라우팅 방법을 사용하여 브라우저 도구를 활성화하거나 호출하도록 요청하십시오. Codex의 경우 @browser를 명시적으로 언급하는 요청을 보내는 것을 의미할 수 있습니다. 사용자가 다시 라우팅하지 않거나 클라이언트에 그러한 도구가 없는 경우 Playwright, 스크린샷, 정적 감사 또는 소스 검사로 대체하고 제한 사항을 명시하십시오.
대화형 브라우저 도구가 실제로 호출 가능할 때 Playwright, 헤드리스 전용 스크린샷 또는 원시 소스 검사를 기본값으로 사용하지 마십시오. 스크린샷은 관찰된 내용을 문서화할 수 있지만 대화형 브라우저 패스를 대체하지는 않습니다. Playwright는 대화형 브라우저 도구를 호출할 수 없을 때, 사용자가 명시적으로 Playwright를 요청할 때, 또는 반복 가능한 스크립트 비교가 특별히 필요할 때만 대체 수단으로 사용하십시오.
작업에 사용자의 Chrome 프로필, 기존 Chrome 탭, 확장 프로그램, 인증된 페이지 또는 Chrome 특정 동작이 필요한 경우 Chrome 자동화를 사용하십시오.
탐색 중에 검사:
- 데스크톱 첫 화면: 구성, 배율, 간격, 타이포그래피, 색상, 표시되는 탐색 및 주요 시각적 모티프.
- 모바일 첫 화면: 레이아웃 변경, 숨겨진 탐색, 스크롤 동작 및 콘텐츠 우선 순위.
- 시작 시퀀스: 로드 상태, 나타나는 순서, 불투명도/배율/클립 변경, 지연 및 이징 느낌.
- 스크롤 동작: 수직 대 수평 스크롤, 고정 영역, 스냅 포인트, 관성, 스크롤 연결 변환 및 미니맵 변경.
- 포인터 동작: 호버 상태, 커서 세부 사항, 드래그 동작, 포인터 추적 요소 및 히트 영역.
- 클릭 동작: 탐색, 토글, 복사 상태, 활성 상태, 모달 및 전환.
- 키보드 동작: 화살표 키, 탭 포커스, 관련된 경우 Escape/Enter 동작.
- 내부 페이지 맵: 기본 탐색 링크, 헤더/푸터 링크, 내부 페이지를 여는 카드, 기사/세부 정보 페이지, 아카이브/카테고리/검색/테마/설정 페이지, 페이지 매김 및 모바일 메뉴 전용 경로.
- 소스 힌트: DOM 구조, CSS 변수, 클래스 이름, 인라인 스타일, 로드된 글꼴, 이미지 자산, 번들된 CSS/JS 이름 및 네트워크 요청.
- 콘솔 상태: 동작에 영향을 줄 수 있는 표시되는 런타임 오류 또는 경고.
구현을 안내하기에 충분한 증거를 캡처하거나 정신적으로 기록하십시오. 사용자가 요청하지 않는 한 긴 탐색 로그를 사용자에게 노출하지 마십시오. 대신 독특한 기능 인벤토리와 구현 계획을 구축하는 데 사용하십시오.
소스 검사 규칙
공개 웹사이트의 경우 페이지 소스, 번들된 CSS/JS, 네트워크 로드 자산 및 DOM 구조를 검사하여 레이아웃, 중단점, CSS 변수, 애니메이션 타이밍, 스크롤 동작 및 상호 작용 로직을 이해할 수 있습니다.
검사된 소스를 연구 자료로 사용하십시오. 기본 제공 코드로 사용하지 마십시오.
다음 중 하나에 해당하지 않는 한 다른 사이트의 코드, 이미지, 글꼴, 개인 콘텐츠, 비공개 링크, 분석 스크립트 또는 번들된 자산을 직접 복사, 재배포 또는 보존하지 마십시오:
- 사용자가 사이트를 소유하고 있습니다.
- 소스 또는 자산이 명확히 오픈 소스이며 호환 가능한 라이선스가 있습니다.
- 사용자가 재사용 권한이 있음을 확인합니다.
일반적인 복제 작업의 경우 눈에 보이는 동작과 디자인 언어를 캡처하는 깔끔하고 유지보수 가능한 일반 HTML/CSS/JS 버전을 재작성하십시오. 검사된 구현 세부 사항이 중요한 경우 아이디어를 원래 코드로 번역하십시오.
정확도 워크플로우
다음 단계를 진지한 재현을 위한 필수 내부 작업으로 취급하십시오:
- 가능할 때 브라우저 탐색 패스를 실행합니다.
- 표시되는 탐색 및 중요한 내부 링크에서 대상 페이지 맵을 구축합니다.
- 구현 단서를 위해 대상 소스와 DOM을 검사합니다.
- 대상의 독특한 레이아웃, 독특한 모션, 독특한 상호 작용 및 독특한 시각적 세부 사항을 식별합니다.
- 공유 셸을 구현한 다음 연결된 내부 페이지를 구현합니다.
- 로컬 정적 버전을 HTTP를 통해 미리 봅니다.
- 유사한 브라우저 뷰포트에서 로컬 결과를 대상과 비교합니다.
- 결과가 사용자 요청에 충분히 가깝게 대상의 느낌과 일치할 때까지 반복합니다.
- 의미 있는 나머지 차이점을 보고합니다.
대상이 모션 우선인 경우 HTML 구조가 비슷해진 후 멈추지 마십시오.
전체 사이트 범위 규칙
기본적으로 단일 홈페이지가 아닌 탐색 가능한 정적 사이트로 대상을 재현합니다.
사용자가 명시적으로 "홈페이지 전용"을 요청하지 않는 한 대상의 중요한 내부 경로에 대한 정적 페이지를 만듭니다:
- 기본 탐색 페이지.
- 홈페이지 또는 기본 목록에서 연결된 기사/세부 정보 페이지.
- 아카이브, 카테고리, 태그, 링크, 테마, 미리보기, 설정 또는 검색 페이지(보이는 경험의 일부인 경우).
- 모바일 메뉴 전용 대상.
- 사이트 탐색 방식을 정의하는 페이지 매김 또는 목록 페이지.
대규모 사이트의 경우 모든 실제 콘텐츠 항목을 미러링하지 마십시오. 플레이스홀더 콘텐츠로 사이트 구조와 페이지 유형을 재현합니다:
- 하나 또는 몇 개의 대표 기사/세부 정보 페이지.
- 대표 아카이브/카테고리/목록 페이지.
- 페이지 매김, 필터링, 검색, 카드 및 사이드바 동작을 보여주는 플레이스홀더 항목.
- 생성된 정적 페이지 간의 작동하는 내부 링크.
생성된 페이지 맵을 EDITING.md에 기록합니다. 대상 경로가 의도적으로 생략된 경우 이유와 추가 방법을 설명합니다.
독특한 기능 인벤토리
코딩 전에 내부 인벤토리를 구축합니다:
- 독특한 레이아웃: 페이지 구조, 구성, 배율, 간격, 탐색, 중단점, 반복 모티프 및 특이한 레이아웃 메커니즘.
- 독특한 모션: 시작 애니메이션, 나타나는 효과, 스크롤 동작, 이징, 스프링 같은 움직임, 호버 상태, 전환, 로드 상태.
- 독특한 상호 작용: 휠 동작, 키보드 동작, 클릭 상태, 복사 상태, 활성 탐색, 드래그/스크롤 제스처, 모바일 변경 사항.
- 독특한 시각적 요소: 색상, 타이포그래피 느낌, 대비, 테두리, 그림자, 마스킹, 블렌드 모드, 모양, 일러스트레이션, 배경 처리.
보조 콘텐츠를 채우기 전에 이러한 독특한 요소를 재현합니다.
프레임워크 및 모션 변환 규칙
대상은 모든 스택을 사용할 수 있습니다. 사용자가 명시적으로 달리 요청하지 않는 한 보이는 동작을 일반 정적 파일로 변환합니다.
일반적인 변환:
- React, Next 또는 Astro 컴포넌트 -> 재사용 가능한 CSS 클래스가 있는 반복 HTML 섹션.
- Tailwind 유틸리티 클래스 -> 일반 CSS 규칙.
- 프레임워크 경로 -> 링크된
.html파일. - 콘텐츠 컬렉션 또는 CMS 데이터 -> 정적 HTML 목록 또는 작은 JSON 파일.
- 테마 구성 -> CSS 사용자 정의 속성.
- Framer Motion 스프링 -> 바닐라 JavaScript 스프링 루프,
requestAnimationFrame또는 신중하게 조정된 CSS 이징. scrollX/scrollY변환 -> CSS 사용자 정의 속성 및 변환에 매핑된 스크롤 진행률.- 클립 나타남 ->
overflow: hidden플러스translateY,clip-path또는 마스크 애니메이션. - 배율 나타남 ->
transform: scale(...)와 transform-origin 및 이징. - 레이아웃 모션 -> 레이아웃을 방해하는 너비/높이 변경 대신 변환 및 불투명도 전환.
- 스크롤 연결 가로 캔버스 -> 휠 리스너 플러스 가로 스크롤, 스냅 포인트, 활성 패널 감지 및 선택적 관성 이징.
- 미니맵 트래커 -> 스크롤 위치와 동기화된 변환/불투명도가 있는 활성 상태.
- 클립보드 복사 애니메이션 -> 변환/불투명도 전환이 있는 2상태 텍스트 전환.
- 커서/십자선 세부 사항 -> 참조의 핵심인 경우 고정 요소 또는 포인터 추적 변환.
- 블렌드 효과 -> CSS
mix-blend-mode, 마스크 또는 필요할 때 단순화된 정적 대비.
prefers-reduced-motion을 존중하지만, 축소 모션이 활성화되지 않는 한 독특한 모션을 제거하지 마십시오.
정적 경로 호환성 규칙
대상 사이트는 /assets/..., /posts/..., /blog와 같은 서버 루트 경로 또는 프레임워크 라우팅을 사용할 수 있습니다. 재현된 정적 출력은 기본적으로 이러한 루트 절대 경로를 보존하지 않아야 합니다.
기본 규칙:
- 모든 사이트 로컬 자산 및 내부 링크에 페이지 상대 경로를 사용합니다.
- 루트 페이지에서
assets/style.css,assets/script.js,posts/example.html및archive/index.html을 사용합니다. - 중첩 페이지에서
../assets/style.css,../index.html과 같은 올바른 깊이 또는 형제 상대 링크를 사용합니다. /posts/foo,/tags/bar또는/projects와 같은 대상 경로를 출력 구조에 따라posts/foo.html,tags/bar.html,projects.html또는projects/index.html과 같은 생성된 정적 경로로 변환합니다.- 사용자가 명시적으로 서버 루트 전용 동작을 수락하지 않는 한 내부 탐색에
/assets/...,/posts/...,/data/...,/images/...또는/를 유지하지 마십시오. - HTML 속성, CSS
url(...), 파비콘, 커버 이미지, 글꼴, 수학/공급업체 자산, JavaScript 생성 카드/검색 결과 및 복사된 경로 데이터에 이를 적용합니다.
publish-static-site에 의해 생성된 정적 사이트가 로컬 HTTP, 파일 프로토콜(file://) 및 정적 호스트(Caddy, Nginx, Netlify, Cloudflare Pages, GitHub Pages 등)에서 예상대로 작동하는지 확인합니다.
접근성 기본값
재현에 접근성 기본값을 적용합니다:
- 의미론적 HTML 요소와 랜드마크.
- 키보드 포커스 가능한 상호 작용 요소.
aria-label,aria-labelledby,aria-describedby,aria-current등.- 이미지의
alt텍스트. :focus-visible스타일.prefers-reduced-motion미디어 쿼리 지원.prefers-color-scheme미디어 쿼리 지원.
편집 가이드
재현을 완료한 후 EDITING.md 파일을 사이트 루트에 작성합니다. 가이드에는 다음이 포함되어야 합니다:
- 모든 생성된 정적 페이지 목록.
- 콘텐츠 위치(콘텐츠를 편집할 위치).
- 단순화된 상호 작용 목록(의도적으로 생략된 대상 동작).
- 생략된 페이지 경로 목록(생략된 이유 및 추가 방법).
- 미해결된 나머지 차이점 목록.
- 사용자가 알 수 없는 내용을 변경할 수 있도록 사이트 구조에 대한 간략한 요약.
정적 사이트 검증
검증 요구 사항:
일반 정적 사이트 요구 사항:
index.html은 사이트 루트에 있고 페이지의 루트 경로입니다.- 모든 내부 링크는 로컬 HTTP에서 작동하며 작동합니다. 파일 프로토콜에서도 작동해야 하지만 상대 링크가 깨지지 않는 구조로 되어 있습니다.
- 리소스에는 로드 오류가 없습니다. 누락된 CSS, JS, 글꼴, favicon 또는 이미지가 없습니다.
href가 없는<a>태그가 없습니다(스타일 전용이 아닌 경우).- 로컬 정적 접근 방식을 위반하지 않는 한 모든 페이지가 동일한 기본 스타일시트와 스크립트를 공유합니다.
- 사이트는 정적 파일을 제공하는 모든 HTTP 서버에서 예상대로 표시됩니다.
- 인라인 이벤트 처리기(
onclick,onmouseover,onscroll)는 드문 경우를 제외하고 사용하지 마십시오. 이벤트 처리는 JavaScript 파일에서 위임되거나 연결됩니다. - 자바스크립트 오류가 없습니다.
HTML 요구 사항:
<!DOCTYPE html>선언이 모든 페이지의 첫 번째 줄에 있습니다.<html lang="...">속성이 올바른 언어 코드로 설정되어 있습니다.<meta charset="UTF-8">이<head>에 있습니다.<meta name="viewport" content="width=device-width, initial-scale=1.0">이<head>에 있습니다.<title>이 모든 페이지에 존재합니다.- 모든 태그가 올바르게 닫혀 있고 중첩되어 있습니다.
- 유효한
<head>및<body>섹션. - 이미지와 미디어 요소에 적절한
alt및loading속성이 있습니다. <nav>,<main>,<article>,<section>,<header>,<footer>와 같은 의미론적 HTML 요소가 레이아웃에서 사용됩니다.
CSS 검증:
일반 CSS 요구 사항:
- 모든 페이지가 동일한 CSS 파일을 사용하여 대상을 시각적으로 재현합니다.
- 외부 종속성이 없습니다. CDN 스타일시트, 글꼴 또는 라이브러리는 최종 출력에서 허용되지 않습니다. 예외: Google Fonts는 CSS
@import로 인라인화되거나 로컬로 호스팅될 수 있습니다. - CSS는 유효하고 브라우저 콘솔 오류가 없습니다.
- CSS 사용자 정의 속성은 일관된 색상, 간격, 글꼴 및 중단점에 사용됩니다.
- 중단점은 모바일, 태블릿 및 데스크톱 뷰포트에서 예상대로 작동합니다.
!important는 브라우저 또는 프레임워크 기본값을 재정의해야 하는 특정한 정당화된 경우를 제외하고 사용하지 마십시오.- 키프레임 애니메이션은
prefers-reduced-motion을 존중합니다. - 전환과 애니메이션은 대상과 일치하는 부드러운 이징 곡선을 사용합니다.
JavaScript 검증:
일반 JavaScript 요구 사항:
- 모든 페이지가 동일한 JavaScript 파일을 사용합니다(해당되는 경우).
- 외부 종속성이 없습니다. 타사 라이브러리, CDN 스크립트 또는 프레임워크가 허용되지 않습니다.
- JavaScript는 유효하고 콘솔 오류가 없습니다.
- 이벤트 리스너는 문서 수준에서 위임되거나 스크립트가 로드될 때 개별 요소에 연결됩니다.
- DOM 조작은 안전하게 수행됩니다(페이지의 중요한 구조가 로드된 후
DOMContentLoaded또는defer). - 스크롤 기반 상호 작용은 성능 저하를 방지하기 위해 조절되거나 디바운스됩니다.
- 애니메이션은
requestAnimationFrame또는 CSS 전환을 사용합니다.setTimeout/setInterval은 시각적 업데이트에 사용하지 마십시오. - 콘솔 로그와 경고가 없습니다.
- 접근성 기본값: 초점 관리 및 ARIA 속성 업데이트.
파일 구조 요구 사항:
- 일관된 명명: 소문자, kebab-case, 의미 있는 이름.
- 자산 참조가 사이트 전체에서 일관됩니다.
- 이미지와 폰트 디렉토리가 존재합니다(사용하는 경우).
- 모든 파일이 예상 폴더에 있습니다.
- 파일 이름에 공백이나 특수 문자가 없습니다.
- 재현에 적용 가능한 경우 검증되지 않은 사이트의 외부 도메인을 가리키는 하드코딩된 절대 경로가 없습니다.
게시
게시 스킬 위임
publish-static-site 스킬을 사용하여 정적 사이트를 게시합니다.
라이선스
이 작업의 결과는 사용자가 명시적으로 달리 지정하지 않는 한 MIT 라이선스에 따라 라이선스가 부여된 것으로 간주되어야 합니다.