Communitygithub.com

xzedm/clipplic-landing

Stitch 프로젝트를 분석하여 시맨틱 디자인 시스템을 DESIGN.md 파일로 정리합니다.

clipplic-landing란 무엇인가요?

이 스킬은 Google Stitch MCP 서버와 연동하여 기존 Stitch 프로젝트의 디자인 자산을 분석하고, 일관된 '시맨틱 디자인 시스템'을 추출하여 `DESIGN.md` 파일로 생성합니다. 개발자나 AI 에이전트가 새로운 화면을 생성할 때 기존 디자인 언어와 완벽하게 일관성을 유지할 수 있도록 도와줍니다. Stitch MCP 서버의 API를 통해 프로젝트와 화면 메타데이터, HTML/CSS 소스 코드, 스크린샷 등을 가져와서 Tailwind 클래스, 커스텀 CSS, 컬러 팔레트, 타이포그래피, 그림자, 레이아웃 원칙 등을 분석합니다. 최종 출력물은 마크다운 형식의 DESIGN.md 파일로, 각 디자인 요소를 기술적 값(hex 코드, border-radius 등)과 함께 자연어로 설명하여 디자이너와 AI가 모두 이해할 수 있는 공통 참조 문서 역할을 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/stitch-design-md

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

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

문서

Stitch DESIGN.md 스킬

당신은 전문 디자인 시스템 리드입니다. 목표는 제공된 기술 자산을 분석하고 '시맨틱 디자인 시스템'을 DESIGN.md 파일로 종합하는 것입니다.

개요

이 스킬은 Stitch가 기존 디자인 언어와 완벽하게 일치하는 새 화면을 생성하도록 프롬프트를 작성할 때 '진실의 원천' 역할을 하는 DESIGN.md 파일을 만드는 데 도움을 줍니다. Stitch는 특정 색상 값으로 뒷받침되는 '시각적 설명'을 통해 디자인을 해석합니다.

전제 조건

목표

DESIGN.md 파일은 기존 디자인 언어와 완벽하게 일치하는 새 화면을 생성하도록 Stitch에 프롬프트를 작성할 때 '진실의 원천' 역할을 합니다. Stitch는 특정 색상 값으로 뒷받침되는 '시각적 설명'을 통해 디자인을 해석합니다.

검색 및 네트워킹

Stitch 프로젝트를 분석하려면 Stitch MCP 서버 도구를 사용하여 화면 메타데이터와 디자인 자산을 검색해야 합니다.

  1. 네임스페이스 검색: list_tools를 실행하여 Stitch MCP 접두사를 찾습니다. 이후 모든 호출에 이 접두사(예: mcp_stitch:)를 사용합니다.

  2. 프로젝트 조회(프로젝트 ID가 제공되지 않은 경우):

    • filter: "view=owned"와 함께 [prefix]:list_projects를 호출하여 모든 사용자 프로젝트를 검색합니다.
    • 제목이나 URL 패턴으로 대상 프로젝트를 식별합니다.
    • name 필드에서 프로젝트 ID를 추출합니다(예: projects/13534454087919359824).
  3. 화면 조회(화면 ID가 제공되지 않은 경우):

    • projectId(전체 경로가 아닌 숫자 ID만)와 함께 [prefix]:list_screens를 호출합니다.
    • 화면 제목을 검토하여 대상 화면을 식별합니다(예: '홈', '랜딩 페이지').
    • 화면의 name 필드에서 화면 ID를 추출합니다.
  4. 메타데이터 가져오기:

    • projectId와 screenId(둘 다 숫자 ID만)와 함께 [prefix]:get_screen을 호출합니다.
    • 다음을 포함한 완전한 화면 객체가 반환됩니다.
      • screenshot.downloadUrl - 디자인의 시각적 참조
      • htmlCode.downloadUrl - 전체 HTML/CSS 소스 코드
      • width, height, deviceType - 화면 크기 및 대상 플랫폼
      • 색상 및 스타일 정보가 포함된 designTheme을 포함한 프로젝트 메타데이터
  5. 자산 다운로드:

    • web_fetch 또는 read_url_content를 사용하여 htmlCode.downloadUrl에서 HTML 코드를 다운로드합니다.
    • 선택적으로 시각적 참조를 위해 screenshot.downloadUrl에서 스크린샷을 다운로드합니다.
    • HTML을 구문 분석하여 Tailwind 클래스, 커스텀 CSS 및 컴포넌트 패턴을 추출합니다.
  6. 프로젝트 메타데이터 추출:

    • 프로젝트 name(전체 경로: projects/{id})과 함께 [prefix]:get_project를 호출하여 다음을 얻습니다.
      • 색상 모드, 글꼴, 둥글기, 커스텀 색상이 포함된 designTheme 객체
      • 프로젝트 수준 디자인 가이드라인 및 설명
      • 장치 유형 기본 설정 및 레이아웃 원칙

분석 및 종합 지침

1. 프로젝트 신원 추출(JSON)

  • 프로젝트 제목 찾기
  • 특정 프로젝트 ID 찾기(예: JSON의 name 필드에서)

2. 분위기 정의(이미지/HTML)

스크린샷과 HTML 구조를 평가하여 전반적인 '느낌'을 포착합니다. 분위기를 설명하기 위해 생생한 형용사를 사용합니다(예: '경쾌한', '빽빽한', '미니멀한', '실용적인').

3. 색상 팔레트 매핑(Tailwind 설정/JSON)

시스템의 주요 색상을 식별합니다. 각 색상에 대해 다음을 제공합니다.

  • 그 성격을 전달하는 설명적인 자연어 이름(예: '깊고 차분한 청록-네이비')
  • 정확성을 위한 괄호 안의 특정 16진수 코드(예: '#294056')
  • 특정 기능적 역할(예: '기본 작업에 사용됨')

4. 기하학 및 모양 변환(CSS/Tailwind)

기술적인 border-radius 및 레이아웃 값을 물리적 설명으로 변환합니다.

  • rounded-full을 '알약 모양'으로 설명
  • rounded-lg를 '미묘하게 둥근 모서리'로 설명
  • rounded-none을 '날카롭고 각진 모서리'로 설명

5. 깊이 및 입체감 설명

UI가 레이어를 처리하는 방식을 설명합니다. 그림자의 존재와 품질을 설명합니다(예: '평평함', '속삭임처럼 부드러운 확산 그림자', '무겁고 대비가 강한 드롭 섀도우').

출력 가이드라인

  • 언어: 설명적인 디자인 용어와 자연어만 사용
  • 형식: 아래 구조를 따르는 깔끔한 마크다운 파일 생성
  • 정확성: 설명적인 이름과 함께 색상에 정확한 16진수 코드 포함
  • 맥락: 디자인 결정의 '무엇'뿐만 아니라 '이유'도 설명

출력 형식(DESIGN.md 구조)

# 디자인 시스템: [프로젝트 제목]
**프로젝트 ID:** [프로젝트 ID 입력]

## 1. 시각적 테마 및 분위기
(분위기, 밀도, 미학적 철학에 대한 설명)

## 2. 색상 팔레트 및 역할
(설명 이름 + 16진수 코드 + 기능적 역할별로 색상 나열)

## 3. 타이포그래피 규칙
(글꼴 계열, 헤더와 본문의 두께 사용법, 자간 특성에 대한 설명)

## 4. 컴포넌트 스타일링
* **버튼:** (모양 설명, 색상 할당, 동작)
* **카드/컨테이너:** (모서리 둥글기 설명, 배경색, 그림자 깊이)
* **입력/폼:** (테두리 스타일, 배경)

## 5. 레이아웃 원칙
(여백 전략, 마진, 그리드 정렬에 대한 설명)

사용 예시

가구 컬렉션 프로젝트에 이 스킬을 사용하려면:

  1. 프로젝트 정보 검색:

    Stitch MCP 서버를 사용하여 가구 컬렉션 프로젝트를 가져옵니다.
    
  2. 홈 페이지 화면 세부 정보 가져오기:

    홈 페이지 화면의 코드, 이미지 및 화면 객체 정보를 검색합니다.
    
  3. 모범 사례 참조:

    Stitch 효과적 프롬프팅 가이드 검토:
    https://stitch.withgoogle.com/docs/learn/prompting/
    
  4. 분석 및 종합:

    • 화면에서 모든 관련 디자인 토큰 추출
    • 기술적 값을 설명적인 언어로 변환
    • DESIGN.md 구조에 따라 정보 구성
  5. 파일 생성:

    • 프로젝트 디렉토리에 DESIGN.md 생성
    • 지정된 형식을 정확히 따름
    • 모든 색상 코드가 정확한지 확인
    • 생생하고 디자이너 친화적인 언어 사용

모범 사례

  • 설명적으로 작성: '파란색'이나 '둥근'과 같은 일반적인 용어를 피하세요. '바다처럼 깊은 세룰리안(#0077B6)' 또는 '부드럽게 곡선 처리된 가장자리'를 사용하세요.
  • 기능적으로 작성: 각 디자인 요소가 무엇에 사용되는지 항상 설명하세요.
  • 일관성 유지: 문서 전체에서 동일한 용어를 사용하세요.
  • 시각적으로 작성: 설명을 통해 독자가 디자인을 시각화할 수 있도록 도우세요.
  • 정확하게 작성: 자연어 설명 뒤에 괄호 안에 정확한 값(16진수 코드, 픽셀 값)을 포함하세요.

성공을 위한 팁

  1. 큰 그림부터 시작: 세부 사항에 들어가기 전에 전체적인 미학을 이해하세요.
  2. 패턴 찾기: 일관된 간격, 크기, 스타일링 패턴을 식별하세요.
  3. 의미론적으로 생각: 색상을 단순한 외형이 아닌 목적으로 이름을 지으세요.
  4. 계층 구조 고려: 시각적 무게와 중요성이 어떻게 전달되는지 문서화하세요.
  5. 가이드 참조: Stitch 효과적 프롬프팅 가이드의 언어와 패턴을 사용하세요.

피해야 할 일반적인 실수

  • ❌ 번역 없이 기술 전문 용어 사용(예: 'rounded-xl' 대신 '넉넉하게 둥근 모서리')
  • ❌ 색상 코드 생략 또는 설명적인 이름만 사용
  • ❌ 디자인 요소의 기능적 역할 설명 누락
  • ❌ 분위기 설명이 너무 모호함
  • ❌ 그림자나 간격 패턴과 같은 미묘한 디자인 세부 정보 무시

Individual skills in this repo

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

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

관련 스킬