Communitygithub.com

Charlo-O/clone-design

종단간 웹사이트 복제, 랜딩 페이지 리믹스 및 DESIGN.md 추출 스킬. URL에서 웹사이트/랜딩페이지를 1:1로 복제하거나, 현재 프로젝트의 로컬 랜딩 페이지로 전환(레이아웃 유지, 카피 및 이미지 에셋 교체), 사이트 디자인 시스템을 DESIGN.md로 추출, 시각적 언어 분석, 여러 캡처된 페이지/상태를 재사용 가능한 디자인 가이드로 종합해야 할 때 사용합니다.

clone-design란 무엇인가요?

이 스킬은 주어진 URL 또는 로컬 HTML 파일을 기반으로 웹사이트를 정확히 1:1로 복제(clone)한 후, 두 가지 주요 모드로 활용할 수 있습니다. **모드 A (랜딩 페이지 리믹스)** 는 복제된 사이트의 레이아웃은 그대로 유지하면서 텍스트, 이미지 등 콘텐츠만 현재 프로젝트에 맞게 교체하여 새로운 랜딩 페이지를 생성합니다. **모드 B (디자인 시스템 추출)** 는 복제된 사이트의 시각적 요소(색상, 타이포그래피, 컴포넌트 스타일 등)를 분석하여 체계적인 디자인 가이드라인 문서(`DESIGN.md`)를 자동 생성합니다. 이 스킬은 주로 Codex, Cursor, Claude Code 등 AI 에이전트 플랫폼에서 사용되도록 설계되었으며, Playwright 기반 브라우저 도구를 활용하여 클라이언트 사이드 렌더링 사이트도 정확히 복제합니다. 복제의 정확성을 최우선으로 하여 1:1 복제가 검증되기 전까지는 레이아웃 변경을 금지하는 엄격한 기준을 따릅니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add Charlo-O/clone-design

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

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

문서

clone-design은(는) 무엇을 하나요?

웹사이트를 먼저 복제한 후, 프로젝트별 랜딩 페이지로 리믹스하거나 DESIGN.md로 추출합니다.

기본 자세: 1:1 복제가 확인될 때까지 원본 사이트의 렌더링된 레이아웃을 창의적 변경 없이 유지합니다. 그 후에만 현재 프로젝트를 위해 카피, 이미지 및 브랜드별 콘텐츠를 교체할 수 있습니다.

사용 시기

사용자가 다음을 요청할 때 이 스킬을 사용하세요:

  • URL에서 웹사이트 또는 랜딩 페이지 복제
  • 적응 전에 랜딩 페이지를 1:1로 복제
  • 다른 웹사이트의 랜딩 페이지를 현재 로컬 프로젝트의 랜딩 페이지로 전환
  • 복제된 웹사이트 카피를 현재 프로젝트 폴더의 카피로 교체
  • 복제된 이미지를 프로젝트 관련 생성 래스터 에셋으로 교체
  • 웹사이트를 DESIGN.md로 전환
  • 사이트의 디자인 시스템 추출
  • 페이지의 시각적 언어 분석
  • 로그인된 제품 UI 또는 워크스페이스 분석
  • 여러 페이지 또는 상태에서 디자인 가이드라인 종합
  • UI 복제본을 재사용 가능한 디자인 가이드라인으로 변환
  • 라이브 URL을 직접 디자인 번들로 전환

모드 선택

모드 A: 랜딩 페이지 리믹스

사용자가 다른 랜딩 페이지를 복제하여 현재 프로젝트에 적응시키려 할 때 사용합니다.

파이프라인:

URL -> 1:1 복제 -> 검증된 로컬 페이지 -> 프로젝트 카피 맵 -> imagegen 에셋 -> 최종 랜딩 페이지

다음을 읽고 따르세요:

모드 B: 디자인 시스템 추출

사용자가 DESIGN.md, 시각적 언어 분석 또는 디자인 가이드라인을 원할 때 사용합니다.

파이프라인:

URL 또는 clone.html -> 캡처 -> design-md/<slug>/

다음을 읽고 따르세요:

소스 캡처 규칙

사용자가 URL을 제공한 경우:

  • 사용자에게 frontend-ui-clone을 별도로 설치하거나 실행하도록 요청하지 마세요.
  • 먼저 자체 포함된 HTML 스냅샷을 생성하세요.
  • frontend-ui-clone과 동일한 복제 워크플로우 및 품질 단계를 재사용하세요.
  • 소스 자료를 captures/<slug>/ 아래에 저장하세요.
  • 캡처된 모든 페이지 또는 상태에 대해 clone.html을 포함하세요.
  • 도움이 될 때 스크린샷과 토큰 덤프를 추가하세요.
  • 리믹스 또는 추출 전에 브라우저에서 복제본을 확인하세요.

사용자가 로컬 .html 파일을 제공한 경우:

  • 직접 사용하세요.
  • 단일 파일, 여러 파일 또는 여러 clone.html 파일이 포함된 캡처 디렉토리를 허용합니다.

사이트가 클라이언트 사이드 렌더링에 의존하는 경우 원시 HTTP 가져오기에서 리믹스하거나 DESIGN.md를 작성하지 마세요.

기본 경로

사용자가 경로를 지정하지 않은 경우:

캡처 파일:

  • 단일 페이지 캡처 폴더: captures/<slug>/
  • 다중 페이지 캡처 폴더: captures/<slug>/<page-slug>/
  • 페이지별 파일: clone.html, homepage.png, live.json
  • 선택적 사이트 수준 캡처 매니페스트: captures/<slug>/capture-plan.json

랜딩 리믹스 출력:

  • 출력 폴더: landing-pages/<slug>/
  • 최종 페이지: index.html
  • 확인된 소스 복제본: source-clone.html
  • 추출된 인벤토리: content-inventory.json
  • 생성된 에셋: assets/generated/
  • 계획 및 QA 파일:
    • copy-map.json
    • image-plan.json
    • qa/original-desktop.png
    • qa/clone-desktop.png
    • qa/final-desktop.png
    • 선택적 모바일 스크린샷

디자인 추출 출력:

  • 출력 폴더: design-md/<slug>/
  • 출력 파일:
    • DESIGN.md
    • README.md
    • preview.html
    • preview-dark.html
  • 선택적 증거 파일: evidence.json

1:1 복제 표준

입력이 URL인 경우:

  • 가능하면 내장 브라우저/Playwright 도구를 선호하세요.
  • frontend-ui-clone과 동일한 기본 뷰포트 및 스크롤 전략을 사용하세요.
  • 렌더링된 DOM, CSS, 글꼴 및 확인된 에셋 URL을 보존하세요.
  • 원래 DOM 구조, 클래스 이름, 섹션 순서, 간격, 반경, 그림자, 타이포그래피, 그라디언트 및 반응형 동작을 보존하세요.
  • 확인된 복제본이 존재하기 전에는 재설계, 단순화, 리브랜딩 또는 레이아웃을 변경하지 마세요.
  • 페이지에 인증이 필요한 경우, 사용자가 브라우저에서 로그인을 완료하고 동일한 브라우저 컨텍스트를 활성 상태로 유지하세요.
  • 로그인 후, 각 요청된 페이지 또는 UI 상태를 동일한 세션에서 별도로 캡처하세요.
  • 첫 번째 캡처에 빈 히어로 영역이나 명백한 오버레이 문제가 있는 경우, frontend-ui-clone과 동일한 에스컬레이션 마인드셋을 적용하세요:
    • 레벨 1: DOM + CSS 복제
    • 레벨 1a: 대상 수정이 포함된 하이브리드 복제
    • 레벨 1b: 대상 스타일 베이크
  • 약 1440 x 900에서 데스크탑 스크린샷 QA를 수행하세요.
  • 페이지가 반응형일 때 약 390px 너비에서 모바일 스크린샷 QA를 수행하세요.
  • 계속하기 전에 눈에 띄는 불일치를 수정하세요.

사용자가 명확히 그 범위를 요청하지 않는 한 인증된 전체 앱을 자동으로 크롤링하지 마세요. 주요 페이지 또는 상태의 선별된 세트를 선호하세요.

리믹스 규칙

복제된 랜딩 페이지를 현재 프로젝트에 적응시킬 때:

  1. 카피를 작성하기 전에 현재 프로젝트 폴더를 검사하여 제품 컨텍스트를 확인하세요. README, PRODUCT.md, package.json, 기존 랜딩 페이지, 문서, 소스 문자열, 스크린샷 및 브랜드 에셋을 선호하세요.
  2. 확인된 복제본에서 scripts/extract_landing_inventory.py를 실행하여 텍스트 및 이미지 계획을 시드하세요.
  3. 원본 표시 텍스트에서 대체 텍스트로의 카피 맵을 구축하세요. 동일한 콘텐츠 계층 구조를 유지하고 레이아웃이 손상되지 않도록 대략적인 텍스트 길이를 유지하세요.
  4. 브랜드 이름, 헤드라인, 서브헤드, CTA, 기능 레이블, 사용후기, FAQ 텍스트 및 바닥글 카피를 프로젝트 관련 언어로 교체하세요.
  5. 사용자가 명시적으로 구조적 변경을 요청하지 않는 한 소스 레이아웃, 애니메이션 타이밍, 섹션 순서 및 컴포넌트 구조를 유지하세요.
  6. 래스터 이미지, 히어로 미디어, 썸네일, 아바타, 제품 목업 및 장식용 사진을 인벤토리화하세요.
  7. 소스 이미지가 유지되어서는 안 되는 경우 프로젝트 관련 래스터 대체를 위해 imagegen 스킬을 사용하세요. 생성된 에셋을 landing-pages/<slug>/assets/generated/에 저장하고 HTML/CSS 참조를 업데이트하세요.
  8. 원본 이미지 크기, 종횡비, 자르기 동작, object-fit, 테두리 반경 및 시각적 무게를 유지하는 것을 선호하세요.
  9. 사용자가 요청하지 않는 한 단순한 SVG 아이콘, 벡터 마크, CSS 그라디언트 또는 기하학적 장식을 생성된 비트맵으로 교체하지 마세요.
  10. 사용자가 개인 참조 복제본을 위해 명시적으로 유지하려는 경우가 아니라면 타사 브랜드 로고, 이름, 스크린샷 및 상표를 제거하거나 교체하세요.
  11. 카피 및 이미지 교체 후 브라우저에서 최종 적응된 페이지를 확인하세요. 텍스트 오버플로, 깨진 이미지, 모바일 줄 바꿈 및 레이아웃 이동을 수정하세요.

DESIGN.md 생성

디자인 추출 모드의 경우 번들 스크립트를 사용하세요:

python3 scripts/generate_design_md.py "$CLONE_HTML" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

여러 캡처된 페이지의 경우:

python3 scripts/generate_design_md.py \
  "captures/$SLUG/home/clone.html" \
  "captures/$SLUG/workspace/clone.html" \
  "captures/$SLUG/settings-modal-open/clone.html" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

또는 캡처 루트를 직접 스캔하세요:

python3 scripts/generate_design_md.py \
  --capture-dir "captures/$SLUG" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

해당 값이 없으면 선택적 플래그를 생략하세요.

생성 후:

  • 생성된 DESIGN.md를 읽으세요.
  • 모호한 표현을 명확히 하세요.
  • 토큰 주장이 소스에 근거하도록 하세요.
  • 불확실한 진술은 추론됨으로 표시하세요.

절대 발명하지 마세요:

  • 복제본에 없는 색상
  • CSS에서 관찰되지 않은 글꼴 패밀리
  • 추출되지 않은 중단점
  • 캡처하지 않은 런타임 상태가 필요한 상호작용
  • 세션에 실제로 포함되지 않은 페이지 또는 흐름에 대한 적용 범위 주장

필수 DESIGN.md 섹션:

  1. 시각적 테마 및 분위기
  2. 색상 팔레트 및 역할
  3. 타이포그래피 규칙
  4. 컴포넌트 스타일링
  5. 레이아웃 원칙
  6. 깊이 및 입체감
  7. 해야 할 것과 하지 말아야 할 것
  8. 반응형 동작
  9. 에이전트 프롬프트 가이드

최종 응답

랜딩 리믹스 모드의 경우 보고:

  • 소스 URL
  • 캡처 폴더 및 확인된 복제본 경로
  • 최종 랜딩 페이지 폴더 및 index.html
  • 대체 카피에 정보를 제공한 프로젝트 파일
  • 수행된 카피 교체 수
  • 생성된 이미지 수와 저장 위치
  • 수행된 데스크탑/모바일 브라우저 확인
  • 캡처되지 않은 상호작용이나 깔끔하게 교체할 수 없는 에셋과 같은 모든 제한 사항

디자인 추출 모드의 경우 보고:

  • 라이브 URL에서 복제한 경우 캡처 폴더가 저장된 위치
  • 하나의 clone.html이 포함되어 있는지 또는 여러 페이지 폴더와 각각의 clone.html, 그리고 선택적으로 homepage.png / live.json이 포함되어 있는지 여부
  • 출력 폴더가 저장된 위치
  • DESIGN.md, README.md, preview.html 및 preview-dark.html이 포함되어 있는지 여부
  • evidence.json이 생성된 경우 저장된 위치
  • 결과가 강력한 복제 소스에서 나왔는지 또는 약한 폴백에서 나왔는지 여부
  • 최종 합성에 포함된 페이지 또는 상태 수
  • 주목할 만한 제한 사항

관련 스킬