Communitygithub.com

사이트 분석 및 재구축 브리프 생성

라이브 웹사이트를 분석하여 섹션별 브랜드명, 색상, 글꼴, 이미지를 플레이스홀더로 대체한 빌드 브리프로 변환합니다. 누군가 '이 사이트 분석해줘', '이런 느낌으로 만들어줘', '빌드용 프롬프트 줘', '이 효과 재현해줘', '내 브랜드로 레이아웃 복제해줘'와 같이 URL을 공유할 때 사용하세요.

사이트 분석 및 재구축 브리프 생성란 무엇인가요?

**사이트 분석(Site Teardown)** 은 개발자나 AI 에이전트가 라이브 웹사이트의 구조, 동작, 스타일을 분석하여 원본 브랜드 자산(로고, 글꼴, 이미지, 카피)을 포함하지 않은 재구축 가능한 브리프를 생성하는 스킬입니다. 이 스킬은 분석 결과를 플레이스홀더 기반 브리프로 제공하여 저작권 침해 없이 다양한 브랜드에 재사용할 수 있도록 합니다. Claude Code, Cursor, Codex 등의 AI 코딩 에이전트는 텍스트와 HTML 소스를 가져와 섹션 인벤토리, 레이아웃, 모션(트리거, 속성, 지속 시간, 이징)을 수치로 명시하고, GSAP, ScrollTrigger, Framer Motion 등 사용된 라이브러리를 탐지합니다. 또한 `webcraft` CLI 도구를 활용하면 초안을 자동 생성할 수 있으며, 추정된 부분과 관찰된 부분을 명확히 구분하여 정확도를 높입니다. 최종 출력은 마크다운 템플릿에 맞춰 정리된 하나의 코드 블록으로 제공되어, 다른 사람이나 AI가 바로 빌드에 사용할 수 있습니다. 사이트 소유자가 자신의 사이트를 요청한 경우 별도 '현재 콘텐츠' 부록을 추가하여 원본 자산을 유지할 수도 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/site-teardown

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

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

문서

사이트 분석 (Site Teardown)

누군가가 감탄한 페이지를 원본의 브랜드, 카피, 미디어를 복사하지 않고 재구축할 수 있을 만큼 정확한 브리프로 변환합니다.

출력이 브리프인 이유 (카피가 아닌 이유)

레이아웃 패턴, 섹션 순서, 모션 기법은 일반적인 기술이며 자유롭게 학습할 수 있습니다. 원본의 문구, 로고, 사진, 일러스트레이션, 코드는 소유자에게 귀속됩니다. 따라서 브리프는 구조와 동작을 설명하고, 브랜드별 모든 요소를 플레이스홀더로 대체합니다. 이렇게 하면 브리프를 재사용할 수 있습니다. 하나의 분석으로 여러 브랜드의 사이트를 생성할 수 있습니다.

워크플로우

  1. 페이지 가져오기. 렌더링된 텍스트와 가능하다면 HTML 소스, 연결된 스타일시트, 스크립트를 읽습니다. 브라우저 도구를 사용할 수 있다면 페이지를 스크롤하여 움직이는 요소를 기록합니다. webcraft CLI를 사용할 수 있다면 webcraft teardown URL (MCP: teardown_site)로 마크업에서 섹션 인벤토리, 스택, 플레이스홀더 브리프 초안을 생성하고, webcraft detect URL은 라이브러리와 버전 목록을 출력합니다. 초안을 골격으로 사용하고 '추정됨'으로 표시된 부분을 채웁니다.
  2. 볼 수 없었던 것을 명시합니다. 텍스트 가져오기는 구조와 카피를 제공하지만 CSS나 JS는 제공하지 않습니다. 브리프 중 관찰된 부분과 추정된 부분을 명확히 명시하여 독자가 확인해야 할 지점을 알 수 있게 합니다. 조용히 추측하면 확신에 찬 것처럼 보이지만 잘못된 빌드로 이어지는 브리프가 만들어집니다.
  3. 섹션을 순서대로 목록화합니다. 각 섹션에 대해: 목적, 레이아웃(열, 그리드, 정렬), 콘텐츠 슬롯(눈썹, 헤드라인, 본문, CTA, 미디어), 반복되는 항목 수를 기록합니다.
  4. 반복되는 패턴을 식별합니다. 섹션 레이블 형식, 버튼 스타일, 카드 스타일, 나타나는 애니메이션을 설명합니다. 각각은 섹션별로 반복하지 않고 '글로벌 패턴' 아래에 한 번만 설명합니다.
  5. 스택을 탐지합니다. 소스에서 라이브러리 특징을 찾습니다: gsap, ScrollTrigger, lenis, swiper, splide, three, locomotive, aos, framer-motion, barba. CMS를 위해 meta generator, 테마 및 플러그인 경로를 확인합니다.
  6. 모션을 숫자로 명시합니다. 트리거, 속성, 시작 및 끝 값, 지속 시간, 이징, 스테거. "멋지게 페이드 인"은 빌드할 수 없지만 "y 40px에서 0, opacity 0에서 1, 0.8초, power3.out, 0.1초 스테거, 뷰포트 80% 진입 시"는 빌드할 수 있습니다.
  7. 브랜드별 요소를 대괄호 안의 플레이스홀더로 대체합니다: [브랜드명], [강조색], [히어로 이미지], [헤드라인, 6~8단어]. 카피의 형태(줄 수, 대략적 길이)는 레이아웃에 영향을 주므로 유지합니다.
  8. 아래 템플릿을 사용하여 브리프를 작성합니다.

브리프 템플릿

[페이지 유형]을(를) [스택]으로 빌드합니다. [테마: 라이트/다크]. 완전 반응형.
prefers-reduced-motion을 존중합니다.

브랜드
- 이름, 색상(배경, 텍스트, 강조, 표면, 테두리), 글꼴, 이미지 목록

글로벌 패턴
- 섹션 레이블 형식, 헤드라인 등장 효과, 버튼 동작, 카드 동작

섹션 (번호 매김, 페이지 순서대로)
N. 이름
   레이아웃: ...
   콘텐츠 슬롯: ...
   모션: ...

품질 기준
- 성능, 접근성, 중단점

전달 전 확인 사항

  • 페이지의 모든 섹션이 순서대로 브리프에 포함되어 있는가?
  • 원본 카피 문장, 원본 이미지 URL, 브랜드 이름이 하나도 남아 있지 않은가?
  • 각 애니메이션에 트리거, 값, 지속 시간, 이징이 명시되었는가?
  • 관찰 vs 추정이 상단 근처에 한 줄로 명시되었는가?
  • 브리프가 붙여넣기 준비 완료: 하나의 코드 블록, 내부에 주석 없음.

사이트 소유자가 요청한 경우

사용자가 자신의 사이트라고 말하는 경우, 실제 카피와 에셋 이름을 별도의 "현재 콘텐츠" 부록에 보관할 수 있습니다. 메인 브리프는 여전히 플레이스홀더 기반으로 유지하여 요청한 리브랜딩에 사용할 수 있도록 합니다.

Individual skills in this repo

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

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

launch-qa

Run a pre-launch quality check on a website covering performance, accessibility, SEO basics, forms, cross-device behavior and content, and report findings ranked by severity with fixes. Use this whenever someone says a site is "ready to launch", "going live", asks "can you check my site", wants a QA pass, a website audit, a Lighthouse-style review, or wants to know why a page is slow or scoring badly.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

wordpress-theme-build

Turn a static HTML/CSS/JS design into a custom WordPress theme that the client can edit, covering theme structure, theme.json, enqueueing scripts, block patterns, custom post types and editable content. Use this whenever someone wants to convert a design or static site to WordPress, build a custom or block theme, make sections editable in Gutenberg, add GSAP or other scripts to a theme properly, or asks why their theme edits are lost or their content is hard-coded.

관련 스킬