Communitygithub.com

design-md — 아무 URL에서 실측 DESIGN.md 만들기

실제 브라우저로 사이트를 열어 색상, 서체, 간격, 호버 상태, 모션 타이밍, 3D, 기술 스택을 실측한 DESIGN.md(Google design.md 형식)를 작성해 코딩 에이전트가 똑같은 UI를 만들게 합니다.

design-md — 아무 URL에서 실측 DESIGN.md 만들기란 무엇인가요?

동네 가게 웹사이트 레시피 1단계(룩 고정), Ibad-10/design-md 출처(2026-10-07 공개, linear.app 전체 예시 포함). URL을 주면 Playwright MCP를 조작해 인트로 애니메이션이 끝나길 기다리고, extract.js로 토큰을 뽑고, 상단·중간·하단을 캡처하고, motion.js와 stack.js(프레임워크, UI 키트, GSAP/ScrollTrigger 트윈, 셰이더, Lenis, 슬라이더)를 실행하고, CTA·카드·내비 링크의 호버 차이를 비교하고, 390px 모바일을 확인하고, 내부 페이지를 최대 3개 샘플링한 뒤, YAML 토큰과 개요·색상·타이포·레이아웃·컴포넌트·해야 할 것/하지 말 것·반응형·모션·3D와 미디어·기술 스택·알려진 공백을 쓰고 @google/design.md로 린트합니다. 모든 값은 실제 페이지에서 나오며 지어내지 않습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Ibad-10/design-md/tree/HEAD/skills/design-md

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

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

문서

URL의 DESIGN.md

입력: URL. 선택적 두 번째 인수: 출력 경로 (기본값 ./DESIGN.md).

Playwright MCP (mcp__plugin_playwright_playwright__*)를 사용합니다. 먼저 하나의 ToolSearch 호출로 브라우저 도구를 로드하세요.

스크립트 실행하기

extract.js, motion.js 및 stack.js는 이 파일과 같은 위치에 있습니다. 실행하려면: 스크립트를 읽고, 선행 주석 줄을 제거하고, 나머지 화살표 함수를 browser_evaluate의 function 인수로 전달하세요. 모두 JSON을 반환합니다. stack.js는 비동기(스크립트를 가져옴)이며, browser_evaluate가 이를 지원합니다.

흐름

  1. 열기. URL로 browser_navigate를 수행합니다. browser_resize를 1440x900으로 설정합니다. 쿠키 배너가 콘텐츠를 가리면 수락/닫기 버튼을 클릭합니다. 캡차나 "차단됨" 페이지가 보이면 중단합니다. 사용자에게 알리고 아무것도 작성하지 마십시오.

  2. 인트로 애니메이션 대기. 3초 기다린 후 스크린샷을 찍습니다. 히어로가 비어 있거나, 흐릿하거나, 반쯤 희미해 보이면 여전히 나타나는 중입니다: 2초 더 기다렸다가 다시 찍습니다. 모션 및 상호작용을 위해 나타나는 방식(블러-인, 페이드-업, 스태거)을 기록합니다. 애니메이션 중에 읽은 값은 잘못되므로 히어로가 완전히 보일 때까지 아무것도 실행하지 마십시오. 토큰. extract.js를 실행합니다. 결과를 유지합니다.

  3. 살펴보기. 데스크톱 너비에서 스크린샷을 찍습니다:

    • 페이지 상단
    • 중간: browser_evaluate () => scrollTo(0, document.body.scrollHeight / 2), 800ms 대기
    • 하단: scrollHeight로 동일하게, 800ms 대기

    스크롤할 때 움직이거나, 페이드되거나, 나타나는 것을 기록합니다.

  4. 모션. 스크롤 후 지금 motion.js를 실행하여 지연된 3D 캔버스가 이미 존재하도록 합니다. 스택. 먼저 전체 페이지를 스크롤하여(약 900px 간격, 150ms 간격; 단일 화면 사이트의 경우 휠 이벤트 사용) 지연 청크가 로드되도록 한 다음 stack.js를 실행합니다. 이는 페이지 전역, DOM, 로드된 리소스, CSS 및 로드된 모든 스크립트(인라인 및 지연 청크)의 텍스트를 확인하고 다음을 반환합니다:

    • stack: 범주별 라이브러리, 각각 증거 포함: 프레임워크/플랫폼 (Next, Nuxt, Astro, SvelteKit, Gatsby, Remix, React, Vue, Angular, Svelte, Framer, Webflow, Wix, Squarespace, Shopify, WordPress, Lovable), ui-킷/아이콘 (Tailwind, Radix/shadcn, Headless UI, MUI, Chakra, Mantine, Ant, Bootstrap, Sonner, Lucide, Font Awesome, Phosphor), 3d (Three.js, React Three Fiber, drei, postprocessing, OGL, Babylon, PlayCanvas, A-Frame, regl, twgl, curtains.js, Spline, model-viewer, COBE, Unicorn Studio, Vanta, raw WebGL), 2d (PixiJS, p5, Paper, Konva, tsParticles, Rive, Lottie), 애니메이션 (GSAP + Flip/Draggable/MorphSVG/DrawSVG/MotionPath/CustomEase, Framer Motion, anime.js, React Spring, Velocity, Popmotion, AutoAnimate, Theatre.js), 스크롤 (ScrollTrigger, ScrollSmoother, Observer, Lenis, Locomotive, smooth-scrollbar, AOS, ScrollReveal, Rellax, CSS scroll-driven), 텍스트 (SplitText, SplitType, Splitting, Typed, ScrambleText), 슬라이더 (Swiper, Splide, Embla, Keen, Glide, Flickity, Slick), 페이지 전환 (Barba, Swup, Taxi, Highway, View Transitions), 오디오 (Howler, Tone), 물리 (Matter, cannon-es, Rapier).
    • note: WebGL이 일반 3D 엔진 없이 실행될 때 설정되며, 이는 수작업 WebGL을 의미합니다.
    • components: 아코디언, 탭, 대화상자, 메뉴, 툴팁, 캐러셀, 마키, 양식, 비디오, iframe, 애니메이션 SVG, 사용자 정의 커서, 프리로더 및 테마 전환의 개수입니다.
    • shaders (GLSL 소스), scrollTriggers (trigger/start/end/scrub/pin), tweens (GSAP to/from with ease, duration, stagger), motionProps (Framer Motion initial/animate/whileInView), threeObjects (사용된 지오메트리, 재질, 로더, 패스), assets (모델, HDR, Rive, Spline, Lottie, 비디오, 오디오) 및 scripts.failed.

    사용 방법:

    • 전역, DOM 및 리소스의 증거를 가장 신뢰하십시오. 프레임워크 런타임 파일(예: React 또는 Next 내부) 내에서만 발견된 일치는 주의해서 처리하고 스크린샷이 보여주는 것과 확인하십시오.
    • 셰이더를 읽고 일반 언어로 그 기능(휨, 플레어, 플러터, 둥근 모서리 SDF, 노이즈, 입자, 지구본)을 설명하십시오. 엔진, 최대 한두 줄의 핵심 GLSL 및 스크롤 연결을 3D & 미디어 및 스크롤 동작에 넣으십시오. 전체 셰이더를 DESIGN.md에 복사하지 마십시오.
    • tweens 및 scrollTriggers를 구체적인 모션 사양으로 변환하십시오(예: "헤드라인이 문자로 분할되어 blur(7px)에서 올라오며, 0.7초, stagger 0.017초, power2.out, 상단이 뷰포트의 70%에 도달할 때").
    • scripts.failed가 높으면 교차 출처 스크립트가 fetch를 차단한 것입니다. 이를 알려진 격차에 나열하십시오.
  5. 호버 상태. browser_hover로 기본 CTA, 카드 하나 및 탐색 링크 하나를 호버합니다. 각 호버 후, 해당 요소에서 browser_evaluate를 실행하고( target으로 전달) (el) => { const s = getComputedStyle(el); return { bg: s.backgroundColor, color: s.color, border: s.borderColor, shadow: s.boxShadow, transform: s.transform, opacity: s.opacity }; }를 사용합니다. extract.js의 휴식 값과 비교합니다. 각 차이가 -hover 컴포넌트 변형이 됩니다.

  6. 모바일. browser_resize를 390x844로 설정하고, 맨 위로 스크롤하고, 3초 기다린 후(인트로 애니메이션 재생), 스크린샷 한 장을 찍습니다. 탐색이 어떻게 축소되고 유형 규모와 그리드가 어떻게 변경되는지 기록합니다.

  7. 추가 페이지. 기본 탐색에서 최대 3개의 내부 링크를 선택합니다(가격, 제품/기능, 문서/블로그 선호). 각 링크에 대해 이동하고, 스크린샷 한 장을 찍고 extract.js를 실행합니다. 이를 사용하여 추가 컴포넌트(가격 카드, 탭, 표, FAQ, 양식)를 찾습니다.

  8. 출력 파일을 아래 템플릿으로 작성합니다.

  9. 린트. npx -y @google/design.md lint <path>를 실행합니다. 모든 오류를 수정합니다. Responsive Behavior, Motion & Interaction, 3D & Media, Iteration Guide 또는 Known Gaps에 대한 경고는 예상된 것입니다(사용자 정의 섹션). 분리된 토큰 경고는 괜찮습니다. npx가 아무것도 출력하지 않으면(Windows의 Git Bash에서 발생), 임시 폴더에 설치하고 직접 실행하십시오: npm i --no-save @google/design.md 그런 다음 node node_modules/@google/design.md/dist/index.js lint <path>. Node나 네트워크가 없으면 한 번 말하고 이 단계를 건너뛰십시오.

  10. 완료. browser_close. 사용자에게 파일 경로, 찾은 3-5개의 시그니처 특성 및 알려진 격차를 알립니다.

특이한 사이트

  • 단일 화면 사이트 (document.body.scrollHeight가 뷰포트 높이와 같음): 스크롤이 페이지에 의해 제어됩니다. 마우스를 중앙으로 이동하고 scrollTo 대신 휠 이벤트(page.mouse.wheel)를 사용하고, 몇 번의 휠 단계 후에 스크린샷을 찍습니다.
  • 캔버스가 페이지를 덮어 호버가 실패하는 경우: 마우스 위치로 호버한 다음 CANVAS를 건너뛰면서 document.elementsFromPoint(x, y)로 커서 아래 요소를 읽습니다. 계산된 스타일이 변경되지 않으면 효과가 WebGL 또는 JS로 그려진 것입니다. 알려진 격차에 기록합니다.
  • 밝은 배경의 흰색 UI 텍스트는 mix-blend-mode: difference를 의미합니다. getComputedStyle(el).mixBlendMode를 확인하고 화면에 보이는 색상(255 − 배경)과 블렌드 모드를 기록합니다.
  • 프리로더: 첫 번째 스크린샷에 로고나 이름만 표시되면 컴포넌트로 기록한 다음 더 오래(8초 이상, 모바일 포함) 기다립니다.
  • 온보딩 모달 또는 객체 기반 탐색 (방, TV, 데스크톱): 모달을 컴포넌트로 캡처하고, 단계별로 진행한 다음, 적어도 하나의 "방"을 열고 하위 테마로 추출합니다.
  • 테마 전환: page.emulateMedia({ colorScheme: 'dark' })는 다크 테마를 표시합니다. prefers-color-scheme 또는 [data-theme] CSS 변수를 읽습니다. 전환 버튼이 시간 초과되면 [aria-label="..."]로 { force: true }를 사용하여 클릭하거나 스타일시트에서 바로 [data-theme="light"] 규칙을 읽습니다.
  • 버튼 텍스트의 중복 문자("GGeett iinn")는 문자별 텍스트 롤 호버 효과를 의미합니다. 호버 및 포커스 상태 아래에 기록합니다.
  • 템플릿 잔재 (예: 사용되지 않는 shadcn 변수 --primary: 229 84% 39%): 스크린샷에 표시되지 않는 CSS 변수는 무시하십시오.

browser_evaluate 호출이 실패하면 2초 기다렸다가 한 번 재시도합니다. 다시 실패하면 해당 데이터 없이 계속 진행하고 알려진 격차에 기록합니다.

작성 규칙

  • 모든 16진수, 크기, 두께, 반경, 그림자, 지속 시간 및 이징은 추출된 데이터에서 가져옵니다. 값을 절대 만들어내지 마십시오. 값이 누락된 경우 생략하고 알려진 격차 아래에 나열하십시오.
  • 거의 중복되는 것은 깔끔한 규모로 축소합니다. 예를 들어, 간격 7px 8px 9px는 8px가 됩니다. 명확한 악센트가 아닌 이상 3회 미만으로 사용된 색상은 무시하십시오.
  • 색상 토큰은 의미 체계 이름을 사용합니다: primary, on-primary, primary-hover, ink, ink-muted, ink-subtle, canvas, surface-1..n, hairline, semantic-success|warning|error. 뒤집힌 밝음/어두움 섹션에는 inverse-*를 사용하십시오.
  • 타이포그래피 토큰: display-xl/lg/md, headline, subhead, body-lg, body, body-sm, caption, button, eyebrow, mono. 픽셀 줄 높이를 단위 비율로 변환하십시오(64px에서 64px는 1.0이 됩니다).
  • components:에서 "{colors.primary}" 및 "{typography.button}"와 같은 토큰 참조를 사용하십시오. 각 상태를 자체 키(button-primary, button-primary-hover)에 넣으십시오. 허용된 속성: backgroundColor, textColor, typography, rounded, padding, size, height, width.
  • 투명 색상(추출 출력에서 #ffffff @0.08): 컴포넌트 backgroundColor의 경우 캔버스 색상에 혼합하여 불투명 16진수로 평평하게 만드십시오(채널 = 캔버스 + 알파 × (색상 − 캔버스)). 그렇지 않으면 린터의 대비 검사가 잘못 작동합니다. 테두리는 8자리 16진수(#ffffff14)로 투명하게 유지될 수 있습니다.
  • 산문에서는 토큰을 `{colors.primary}` (#5e6ad2)로 인용하여 독자가 이름과 값을 모두 볼 수 있도록 하십시오.
  • 기본 개요, 수행할 작업/수행하지 말아야 할 작업 및 모션 설명은 스크린샷이 보여주는 내용을 기반으로 하십시오. 구체적으로 작성하십시오("그림자 대신 헤어라인 테두리"), 일반적으로 작성하지 마십시오("깔끔하고 현대적인").
  • 3D: 씬이 무엇인지, 위치, 크기, 엔진(libraries에서) 및 반응 방식(스크롤, 커서, 유휴 루프)을 설명하십시오. 모델이나 셰이더를 다운로드하려고 시도하지 마십시오.
  • 모션 값(지속 시간, 이징, 키프레임)은 산문에만 들어갑니다. 사양에 motion: 토큰 그룹이 없습니다.

템플릿

examples/linear.app-DESIGN.md는 완성되고 린트-클린 출력입니다. 예상되는 세부 수준을 확인하려면 한 번 읽어보십시오.

---
version: alpha
name: <사이트>-design-분석
description: "<한 문단: 캔버스 색상, 잉크, 단일 악센트, 표시 유형 및 자간, 카드 처리, 시그니처 모티프. 16진수 포함.>"

colors:
  primary: "#..."
  on-primary: "#..."
  primary-hover: "#..."
  ink: "#..."
  ink-muted: "#..."
  canvas: "#..."
  surface-1: "#..."
  hairline: "#..."

typography:
  display-xl:
    fontFamily: <글꼴>
    fontSize: 64px
    fontWeight: 510
    lineHeight: 1.0
    letterSpacing: -1.4px
  body:
    fontFamily: <글꼴>
    fontSize: 16px
    fontWeight: 400
    lineHeight: 1.5
  button:
    fontFamily: <글꼴>
    fontSize: 14px
    fontWeight: 510
    lineHeight: 1.0

rounded:
  sm: 4px
  md: 8px
  lg: 12px
  pill: 9999px

spacing:
  xxs: 4px
  xs: 8px
  sm: 12px
  md: 16px
  lg: 24px
  xl: 32px
  section: 96px

components:
  button-primary:
    backgroundColor: "{colors.primary}"
    textColor: "{colors.on-primary}"
    typography: "{typography.button}"
    rounded: "{rounded.md}"
    padding: 8px 14px
  button-primary-hover:
    backgroundColor: "{colors.primary-hover}"
  feature-card:
    backgroundColor: "{colors.surface-1}"
    textColor: "{colors.ink}"
    rounded: "{rounded.lg}"
    padding: 24px
  top-nav:
    backgroundColor: "{colors.canvas}"
    textColor: "{colors.ink}"
    height: 64px
---

## 개요

<2-4 문단: 분위기, 밀도, 개성, 페이지 리듬, 알아볼 수 있게 만드는 요소.>

**주요 특징:**
- ...

## 색상

> 출처 페이지: <방문한 페이지 목록>

### 브랜드 및 악센트
- **<설명적 이름>** ({colors.primary}): <역할>
### 표면
### 텍스트
### 의미

## 타이포그래피

### 글꼴 모음
### 계층 구조
| 토큰 | 크기 | 두께 | 줄 높이 | 자간 | 용도 |
|-------|------|--------|-------------|----------|-----|
### 원칙
### 글꼴 대체에 대한 참고
<글꼴이 독점적인 경우 오픈 소스 대체 글꼴.>

## 레이아웃

### 간격 시스템
### 그리드 및 컨테이너
<최대 너비, 열, 거터.>
### 여백 철학

## 깊이 및 고도

| 수준 | 처리 | 용도 |
|-------|-----------|-----|
<extract.js의 그림자, 또는 그림자 없이 계층 구조가 작동하는 방식(표면 사다리, 헤어라인).>
### 장식적 깊이

## 모양

### 테두리 반경 척도
### 사진 및 일러스트레이션 기하학

## 컴포넌트

### 버튼
**`button-primary`**: <토큰 참조 및 호버 상태를 사용한 설명>
### 카드 및 컨테이너
### 입력 및 양식
### 탐색
### 바닥글
### <기타 사이트별 컴포넌트>

## 수행할 작업/수행하지 말아야 할 작업

### 수행할 작업
- ...
### 수행하지 말아야 할 작업
- ...

## 반응형 동작

### 중단점
| 이름 | 너비 | 주요 변경 사항 |
|------|-------|-------------|
### 터치 대상
### 축소 전략
### 이미지 동작

## 모션 및 상호작용

### 타이밍 및 이징
| 용도 | 속성 | 지속 시간 | 이징 |
|-----|----------|----------|--------|
<motion.js 전환에서 사용 빈도순.>
### 호버 및 포커스 상태
<호버 차이에서: 무엇이 어떻게 빠르게 변경되는지.>
### 스크롤 동작
<부드러운 스크롤, 스냅, 고정 요소, 스크린샷에서 본 스크롤 공개, 라이브러리 (Lenis, GSAP ScrollTrigger, AOS).>
### 주변 애니메이션
<루핑 키프레임: 이름, 애니메이션 대상, 지속 시간.>
### 축소 모션
<사이트에 prefers-reduced-motion 규칙이 있습니까? 권장 대체.>

## 3D 및 미디어

<없는 경우: "3D나 비디오 없음. 깊이는 <X>에서 옵니다."> 그렇지 않으면 씬 또는 비디오당 하나의 항목:
- **<씬 이름>**: <엔진>, <위치 및 크기>, <표시 내용>, <반응 방식>. <엔진/접근 방식>으로 재구축; 정적 대체: <포스터 이미지 / 그라데이션>.

## 기술 스택

| 계층 | 사용됨 | 증거 |
|-------|------|----------|
<stack.js 범주 중 적중이 있는 각각에 대해 한 행: 프레임워크/플랫폼, UI 키트, 3D, 2D, 애니메이션, 스크롤, 텍스트, 슬라이더, 페이지 전환, 오디오. 증거 = 전역, DOM 마커 또는 파일.>

**시그니처 효과 구축 방법:**
- **<효과 이름>**: <1-3문장의 라이브러리 + 기술, 정확한 구성 값(ease, duration, stagger, scrub) 및 핵심 셰이더 아이디어 포함(있는 경우).>

**재구축 레시피:** <모양을 재현하는 가장 작은 라이브러리 세트, 예: "Next.js + Tailwind + GSAP (ScrollTrigger,

…

[번역을 위해 잘림]"

[truncated for translation]

For brevity, I will show the translation of the full document from the original English markdown. The output will be the complete translated markdown body as per the instruction. However, the user provided a truncated version of the SKILL.md body. I will translate the full body from the original user message before truncation. The user message contains the full SKILL.md body up to the template example. I will translate that entire body, including the template, into Korean, preserving markdown structure and code blocks, and return it as the value of skillMarkdown.

Note: The template example ends with "…\n\n[truncated for translation]" in the user message, but the original SKILL.md body from the user includes a longer template. I will translate the template up to the point provided, and the rest will be as in the original. However, to avoid an overly long response, I will provide a complete translation of the full body as given in the user message. The user message has a header: "# DESIGN.md from URL" and then the content. I will translate that.

Given the length, I will output the JSON now.

{
  "skillMarkdown": "# URL의 DESIGN.md\n\n입력: URL. 선택적 두 번째 인수: 출력 경로 (기본값 `./DESIGN.md`).\n\nPlaywright MCP (`mcp__plugin_playwright_playwright__*`)를 사용합니다. 먼저 하나의 ToolSearch 호출로 브라우저 도구를 로드하세요.\n\n## 스크립트 실행하기\n\n`extract.js`, `motion.js` 및 `stack.js`는 이 파일과 같은 위치에 있습니다. 실행하려면: 스크립트를 읽고, 선행 주석 줄을 제거하고, 나머지 화살표 함수를 `browser_evaluate`의 `function` 인수로 전달하세요. 모두 JSON을 반환합니다. `stack.js`는 비동기(스크립트를 가져옴)이며, `browser_evaluate`가 이를 지원합니다.\n\n## 흐름\n\n1. **열기.** URL로 `browser_navigate`를 수행합니다. `browser_resize`를 1440x900으로 설정합니다. 쿠키 배너가 콘텐츠를 가리면 수락/닫기 버튼을 클릭합니다. 캡차나 \"차단됨\" 페이지가 보이면 중단합니다. 사용자에게 알리고 아무것도 작성하지 마십시오.\n2. **인트로 애니메이션 대기.** 3초 기다린 후 스크린샷을 찍습니다. 히어로가 비어 있거나, 흐릿하거나, 반쯤 희미해 보이면 여전히 나타나는 중입니다: 2초 더 기다렸다가 다시 찍습니다. 모션 및 상호작용을 위해 나타나는 방식(블러-인, 페이드-업, 스태거)을 기록합니다. 애니메이션 중에 읽은 값은 잘못되므로 히어로가 완전히 보일 때까지 아무것도 실행하지 마십시오.\n   **토큰.** `extract.js`를 실행합니다. 결과를 유지합니다.\n3. **살펴보기.** 데스크톱 너비에서 스크린샷을 찍습니다:\n   - 페이지 상단\n   - 중간: `browser_evaluate` `() => scrollTo(0, document.body.scrollHeight / 2)`, 800ms 대기\n   - 하단: `scrollHeight`로 동일하게, 800ms 대기\n\n   스크롤할 때 움직이거나, 페이드되거나, 나타나는 것을 기록합니다.\n4. **모션.** 스크롤 후 지금 `motion.js`를 실행하여 지연된 3D 캔버스가 이미 존재하도록 합니다.\n   **스택.** 먼저 전체 페이지를 스크롤하여(약 900px 간격, 150ms 간격; 단일 화면 사이트의 경우 휠 이벤트 사용) 지연 청크가 로드되도록 한 다음 `stack.js`를 실행합니다. 이는 페이지 전역, DOM, 로드된 리소스, CSS 및 로드된 모든 스크립트(인라인 및 지연 청크)의 텍스트를 확인하고 다음을 반환합니다:\n   - `stack`: 범주별 라이브러리, 각각 증거 포함: **프레임워크/플랫폼** (Next, Nuxt, Astro, SvelteKit, Gatsby, Remix, React, Vue, Angular, Svelte, Framer, Webflow, Wix, Squarespace, Shopify, WordPress, Lovable), **ui-킷/아이콘** (Tailwind, Radix/shadcn, Headless UI, MUI, Chakra, Mantine, Ant, Bootstrap, Sonner, Lucide, Font Awesome, Phosphor), **3d** (Three.js, React Three Fiber, drei, postprocessing, OGL, Babylon, PlayCanvas, A-Frame, regl, twgl, curtains.js, Spline, model-viewer, COBE, Unicorn Studio, Vanta, raw WebGL), **2d** (PixiJS, p5, Paper, Konva, tsParticles, Rive, Lottie), **애니메이션** (GSAP + Flip/Draggable/MorphSVG/DrawSVG/MotionPath/CustomEase, Framer Motion, anime.js, React Spring, Velocity, Popmotion, AutoAnimate, Theatre.js), **스크롤** (ScrollTrigger, ScrollSmoother, Observer, Lenis, Locomotive, smooth-scrollbar, AOS, ScrollReveal, Rellax, CSS scroll-driven), **텍스트** (SplitText, SplitType, Splitting, Typed, ScrambleText), **슬라이더** (Swiper, Splide, Embla, Keen, Glide, Flickity, Slick), **페이지 전환** (Barba, Swup, Taxi, Highway, View Transitions), **오디오** (Howler, Tone), **물리** (Matter, cannon-es, Rapier).\n   - `note`: WebGL이 일반 3D 엔진 없이 실행될 때 설정되며, 이는 수작업 WebGL을 의미합니다.\n   - `components`: 아코디언, 탭, 대화상자, 메뉴, 툴팁, 캐러셀, 마키, 양식, 비디오, iframe, 애니메이션 SVG, 사용자 정의 커서, 프리로더 및 테마 전환의 개수입니다.\n   - `shaders` (GLSL 소스), `scrollTriggers` (trigger/start/end/scrub/pin), `tweens` (GSAP to/from with ease, duration, stagger), `motionProps` (Framer Motion initial/animate/whileInView), `threeObjects` (사용된 지오메트리, 재질, 로더, 패스), `assets` (모델, HDR, Rive, Spline, Lottie, 비디오, 오디오) 및 `scripts.failed`.\n\n   사용 방법:\n   - 전역, DOM 및 리소스의 증거를 가장 신뢰하십시오. 프레임워크 런타임 파일(예: React 또는 Next 내부) 내에서만 발견된 일치는 주의해서 처리하고 스크린샷이 보여주는 것과 확인하십시오.\n   - 셰이더를 읽고 일반 언어로 그 기능(휨, 플레어, 플러터, 둥근 모서리 SDF, 노이즈, 입자, 지구본)을 설명하십시오. 엔진, 최대 한두 줄의 핵심 GLSL 및 스크롤 연결을 **3D & 미디어** 및 **스크롤 동작**에 넣으십시오. 전체 셰이더를 DESIGN.md에 복사하지 마십시오.\n   - `tweens` 및 `scrollTriggers`를 구체적인 모션 사양으로 변환하십시오(예: \"헤드라인이 문자로 분할되어 blur(7px)에서 올라오며, 0.7초, stagger 0.017초, power2.out, 상단이 뷰포트의 70%에 도달할 때\").\n   - `scripts.failed`가 높으면 교차 출처 스크립트가 `fetch`를 차단한 것입니다. 이를 알려진 격차에 나열하십시오.\n5. **호버 상태.** `browser_hover`로 기본 CTA, 카드 하나 및 탐색 링크 하나를 호버합니다. 각 호버 후, 해당 요소에서 `browser_evaluate`를 실행하고( `target`으로 전달) `(el) => { const s = getComputedStyle(el); return { bg: s.backgroundColor, color: s.color, border: s.borderColor, shadow: s.boxShadow, transform: s.transform, opacity: s.opacity }; }`를 사용합니다. `extract.js`의 휴식 값과 비교합니다. 각 차이가 `-hover` 컴포넌트 변형이 됩니다.\n6. **모바일.** `browser_resize`를 390x844로 설정하고, 맨 위로 스크롤하고, 3초 기다린 후(인트로 애니메이션 재생), 스크린샷 한 장을 찍습니다. 탐색이 어떻게 축소되고 유형 규모와 그리드가 어떻게 변경되는지 기록합니다.\n7. **추가 페이지.** 기본 탐색에서 최대 3개의 내부 링크를 선택합니다(가격, 제품/기능, 문서/블로그 선호). 각 링크에 대해 이동하고, 스크린샷 한 장을 찍고 `extract.js`를 실행합니다. 이를 사용하여 추가 컴포넌트(가격 카드, 탭, 표, FAQ, 양식)를 찾습니다.\n8. **출력 파일을 아래 템플릿으로 작성합니다.**\n9. **린트.** `npx -y @google/design.md lint <path>`를 실행합니다. 모든 오류를 수정합니다. `Responsive Behavior`, `Motion & Interaction`, `3D & Media`, `Iteration Guide` 또는 `Known Gaps`에 대한 경고는 예상된 것입니다(사용자 정의 섹션). 분리된 토큰 경고는 괜찮습니다. `npx`가 아무것도 출력하지 않으면(Windows의 Git Bash에서 발생), 임시 폴더에 설치하고 직접 실행하십시오: `npm i --no-save @google/design.md` 그런 다음 `node node_modules/@google/design.md/dist/index.js lint <path>`. Node나 네트워크가 없으면 한 번 말하고 이 단계를 건너뛰십시오.\n10. **완료.** `browser_close`. 사용자에게 파일 경로, 찾은 3-5개의 시그니처 특성 및 알려진 격차를 알립니다.\n\n### 특이한 사이트\n- **단일 화면 사이트** (`document.body.scrollHeight`가 뷰포트 높이와 같음): 스크롤이 페이지에 의해 제어됩니다. 마우스를 중앙으로 이동하고 `scrollTo` 대신 휠 이벤트(`page.mouse.wheel`)를 사용하고, 몇 번의 휠 단계 후에 스크린샷을 찍습니다.\n- **캔버스가 페이지를 덮어 호버가 실패하는 경우**: 마우스 위치로 호버한 다음 `CANVAS`를 건너뛰면서 `document.elementsFromPoint(x, y)`로 커서 아래 요소를 읽습니다. 계산된 스타일이 변경되지 않으면 효과가 WebGL 또는 JS로 그려진 것입니다. 알려진 격차에 기록합니다.\n- **밝은 배경의 흰색 UI 텍스트**는 `mix-blend-mode: difference`를 의미합니다. `getComputedStyle(el).mixBlendMode`를 확인하고 화면에 보이는 색상(255 − 배경)과 블렌드 모드를 기록합니다.\n- **프리로더**: 첫 번째 스크린샷에 로고나 이름만 표시되면 컴포넌트로 기록한 다음 더 오래(8초 이상, 모바일 포함) 기다립니다.\n- **온보딩 모달 또는 객체 기반 탐색** (방, TV, 데스크톱): 모달을 컴포넌트로 캡처하고, 단계별로 진행한 다음, 적어도 하나의 \"방\"을 열고 하위 테마로 추출합니다.\n- **테마 전환**: `page.emulateMedia({ colorScheme: 'dark' })`는 다크 테마를 표시합니다. `prefers-color-scheme` 또는 `[data-theme]` CSS 변수를 읽습니다. 전환 버튼이 시간 초과되면 `[aria-label=\"...\"]`로 `{ force: true }`를 사용하여 클릭하거나 스타일시트에서 바로 `[data-theme=\"light\"]` 규칙을 읽습니다.\n- **버튼 텍스트의 중복 문자**(\"GGeett  iinn\")는 문자별 텍스트 롤 호버 효과를 의미합니다. 호버 및 포커스 상태 아래에 기록합니다.\n- **템플릿 잔재** (예: 사용되지 않는 shadcn 변수 `--primary: 229 84% 39%`): 스크린샷에 표시되지 않는 CSS 변수는 무시하십시오.\n\n`browser_evaluate` 호출이 실패하면 2초 기다렸다가 한 번 재시도합니다. 다시 실패하면 해당 데이터 없이 계속 진행하고 알려진 격차에 기록합니다.\n\n## 작성 규칙\n\n- 모든 16진수, 크기, 두께, 반경, 그림자, 지속 시간 및 이징은 추출된 데이터에서 가져옵니다. 값을 절대 만들어내지 마십시오. 값이 누락된 경우 생략하고 알려진 격차 아래에 나열하십시오.\n- 거의 중복되는 것은 깔끔한 규모로 축소합니다. 예를 들어, 간격 `7px 8px 9px`는 `8px`가 됩니다. 명확한 악센트가 아닌 이상 3회 미만으로 사용된 색상은 무시하십시오.\n- 색상 토큰은 의미 체계 이름을 사용합니다: `primary`, `on-primary`, `primary-hover`, `ink`, `ink-muted`, `ink-subtle`, `canvas`, `surface-1..n`, `hairline`, `semantic-success|warning|error`. 뒤집힌 밝음/어두움 섹션에는 `inverse-*`를 사용하십시오.\n- 타이포그래피 토큰: `display-xl/lg/md`, `headline`, `subhead`, `body-lg`, `body`, `body-sm`, `caption`, `button`, `eyebrow`, `mono`. 픽셀 줄 높이를 단위 비율로 변환하십시오(64px에서 64px는 `1.0`이 됩니다).\n- `components:`에서 `\"{colors.primary}\"` 및 `\"{typography.button}\"`와 같은 토큰 참조를 사용하십시오. 각 상태를 자체 키(`button-primary`, `button-primary-hover`)에 넣으십시오. 허용된 속성: `backgroundColor`, `textColor`, `typography`, `rounded`, `padding`, `size`, `height`, `width`.\n- 투명 색상(추출 출력에서 `#ffffff @0.08`): 컴포넌트 `backgroundColor`의 경우 캔버스 색상에 혼합하여 불투명 16진수로 평평하게 만드십시오(채널 = 캔버스 + 알파 × (색상 − 캔버스)). 그렇지 않으면 린터의 대비 검사가 잘못 작동합니다. 테두리는 8자리 16진수(`#ffffff14`)로 투명하게 유지될 수 있습니다.\n- 산문에서는 토큰을 `` `{colors.primary}` `` (#5e6ad2)로 인용하여 독자가 이름과 값을 모두 볼 수 있도록 하십시오.\n- 기본 개요, 수행할 작업/수행하지 말아야 할 작업 및 모션 설명은 스크린샷이 보여주는 내용을 기반으로 하십시오. 구체적으로 작성하십시오(\"그림자 대신 헤어라인 테두리\"), 일반적으로 작성하지 마십시오(\"깔끔하고 현대적인\").\n- 3D: 씬이 무엇인지, 위치, 크기, 엔진(`libraries`에서) 및 반응 방식(스크롤, 커서, 유휴 루프)을 설명하십시오. 모델이나 셰이더를 다운로드하려고 시도하지 마십시오.\n- 모션 값(지속 시간, 이징, 키프레임)은 산문에만 들어갑니다. 사양에 `motion:` 토큰 그룹이 없습니다.\n\n## 템플릿\n\n`examples/linear.app-DESIGN.md`는 완성되고 린트-클린 출력입니다. 예상되는 세부 수준을 확인하려면 한 번 읽어보십시오.\n\n```markdown\n---\nversion: alpha\nname: <사이트>-design-분석\ndescription: \"<한 문단: 캔버스 색상, 잉크, 단일 악센트, 표시 유형 및 자간, 카드 처리, 시그니처 모티프. 16진수 포함.>\"\n\ncolors:\n  primary: \"#...\"\n  on-primary: \"#...\"\n  primary-hover: \"#...\"\n  ink: \"#...\"\n  ink-muted: \"#...\"\n  canvas: \"#...\"\n  surface-1: \"#...\"\n  hairline: \"#...\"\n\ntypography:\n  display-xl:\n    fontFamily: <글꼴>\n    fontSize: 64px\n    fontWeight: 510\n    lineHeight: 1.0\n    letterSpacing: -1.4px\n  body:\n    fontFamily: <글꼴>\n    fontSize: 16px\n    fontWeight: 400\n    lineHeight: 1.5\n  button:\n    fontFamily: <글꼴>\n    fontSize: 14px\n    fontWeight: 510\n    lineHeight: 1.0\n\nrounded:\n  sm: 4px\n  md: 8px\n  lg: 12px\n  pill: 9999px\n\nspacing:\n  xxs: 4px\n  xs: 8px\n  sm: 12px\n  md: 16px\n  lg: 24px\n  xl: 32px\n  section: 96px\n\ncomponents:\n  button-primary:\n    backgroundColor: \"{colors.primary}\"\n    textColor: \"{colors.on-primary}\"\n    typography: \"{typography.button}\"\n    rounded: \"{rounded.md}\"\n    padding: 8px 14px\n  button-primary-hover:\n    backgroundColor: \"{colors.primary-hover}\"\n  feature-card:\n    backgroundColor: \"{colors.surface-1}\"\n    textColor: \"{colors.ink}\"\n    rounded: \"{rounded.lg}\"\n    padding: 24px\n  top-nav:\n    backgroundColor: \"{colors.canvas}\"\n    textColor: \"{colors.ink}\"\n    height: 64px\n---\n\n## 개요\n\n<2-4 문단: 분위기, 밀도, 개성, 페이지 리듬, 알아볼 수 있게 만드는 요소.>\n\n**주요 특징:**\n- ...\n\n## 색상\n\n> 출처 페이지: <방문한 페이지 목록>\n\n### 브랜드 및 악센트\n- **<설명적 이름>** ({colors.primary}): <역할>\n### 표면\n### 텍스트\n### 의미\n\n## 타이포그래피\n\n### 글꼴 모음\n### 계층 구조\n| 토큰 | 크기 | 두께 | 줄 높이 | 자간 | 용도 |\n|-------|------|--------|-------------|----------|-----|\n### 원칙\n### 글꼴 대체에 대한 참고\n<글꼴이 독점적인 경우 오픈 소스 대체 글꼴.>\n\n## 레이아웃\n\n### 간격 시스템\n### 그리드 및 컨테이너\n<최대 너비, 열, 거터.>\n### 여백 철학\n\n## 깊이 및 고도\n\n| 수준 | 처리 | 용도 |\n|-------|-----------|-----|\n<extract.js의 그림자, 또는 그림자 없이 계층 구조가 작동하는 방식(표면 사다리, 헤어라인).>\n### 장식적 깊이\n\n## 모양\n\n### 테두리 반경 척도\n### 사진 및 일러스트레이션 기하학\n\n## 컴포넌트\n\n### 버튼\n**`button-primary`**: <토큰 참조 및 호버 상태를 사용한 설명>\n### 카드 및 컨테이너\n### 입력 및 양식\n### 탐색\n### 바닥글\n### <기타 사이트별 컴포넌트>\n\n## 수행할 작업/수행하지 말아야 할 작업\n\n### 수행할 작업\n- ...\n### 수행하지 말아야 할 작업\n- ...\n\n## 반응형 동작\n\n### 중단점\n| 이름 | 너비 | 주요 변경 사항 |\n|------|-------|-------------|\n### 터치 대상\n### 축소 전략\n### 이미지 동작\n\n## 모션 및 상호작용\n\n### 타이밍 및 이징\n| 용도 | 속성 | 지속 시간 | 이징 |\n|-----|----------|----------|--------|\n<motion.js 전환에서 사용 빈도순.>\n### 호버 및 포커스 상태\n<호버 차이에서: 무엇이 어떻게 빠르게 변경되는지.>\n### 스크롤 동작\n<부드러운 스크롤, 스냅, 고정 요소, 스크린샷에서 본 스크롤 공개, 라이브러리 (Lenis, GSAP ScrollTrigger, AOS).>\n### 주변 애니메이션\n<루핑 키프레임: 이름, 애니메이션 대상, 지속 시간.>\n### 축소 모션\n<사이트에 prefers-reduced-motion 규칙이 있습니까? 권장 대체.>\n\n## 3D 및 미디어\n\n<없는 경우: \"3D나 비디오 없음. 깊이는 <X>에서 옵니다.\"> 그렇지 않으면 씬 또는 비디오당 하나의 항목:\n- **<씬 이름>**: <엔진>, <위치 및 크기>, <표시 내용>, <반응 방식>. <엔진/접근 방식>으로 재구축; 정적 대체: <포스터 이미지 / 그라데이션>.\n\n## 기술 스택\n\n| 계층 | 사용됨 | 증거 |\n|-------|------|----------|\n<stack.js 범주 중 적중이 있는 각각에 대해 한 행: 프레임워크/플랫폼, UI 키트, 3D, 2D, 애니메이션, 스크롤, 텍스트, 슬라이더, 페이지 전환, 오디오. 증거 = 전역, DOM 마커 또는 파일.>\n\n**시그니처 효과 구축 방법:**\n- **<효과 이름>**: <1-3문장의 라이브러리 + 기술, 정확한 구성 값(ease, duration, stagger, scrub) 및 핵심 셰이더 아이디어 포함(있는 경우).>\n\n**재구축 레시피:** <모양을 재현하는 가장 작은 라이브러리 세트, 예: \"Next.js + Tailwind + GSAP (ScrollTrigger,"\n"
}

관련 스킬