사용 가이드로 건너뛰기
stitch::react-components작성자 Google Labs

Stitch React Components 스킬.

UI 디자인을 위한 Claude Code 및 Codex 스킬: Stitch 디자인을 모듈형 React + Vite 컴포넌트로 변환하거나 동기화합니다.

  • Web & UI
  • UI 코드
google-labs-code/stitch-skills · plugins/stitch-build/skills/react-components/SKILL.mdSKILL.md
--- name: stitch::react-components description: - Converts Stitch designs into modular Vite and React components, or syncs/updates existing React components to align with the latest Stitch designs, using system-level networking and AST-based validation. --- ## Phase 1: Retrieval and networking ## Phase 2: Style extraction ## Phase 3: Architectural rules ## Phase 4: Execution steps
2026-09-14에 업스트림 파일에서 읽은 프론트 매터 및 섹션 제목 · 전체 8,725자

01 기능

Claude Code와 Codex에서 stitch::react-components 스킬이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

이 스킬은 Stitch 프로젝트를 모듈형 React 및 Vite 프런트엔드로 전환하거나, 기존 React 컴포넌트를 최신 Stitch 디자인에 맞게 동기화합니다. Stitch 화면을 기반으로 작업하는 프런트엔드 엔지니어를 위한 것으로, 에이전트는 list_tools로 Stitch MCP 접두사를 찾고, get_screen으로 모든 화면을 가져오고, scripts/fetch-stitch.sh로 HTML과 스크린샷을 내려받고, tailwind.config 토큰을 resources/style-guide.json으로 추출한 다음, AST 검증을 통과하는 컴포넌트, 훅, 목 데이터를 빌드합니다.

게이팅된 네 단계가 이 순서를 강제하며, npm run validate는 Readonly Props 인터페이스, hex 값 대신 테마 토큰 사용, 단일 거대 페이지 파일 금지를 강제합니다.

산출물

  • 각 화면에 대해 .stitch/designs/{page}.html과 .stitch/designs/{page}.png에 다운로드된 디자인 산출물.
  • projectId, title, deviceType, screens 맵, Last Sync Time 필드를 담은 .stitch/metadata.json.
  • 현재 프로젝트의 색상, 폰트, 스페이싱, radius, 타이포그래피 토큰을 담아 덮어쓴 resources/style-guide.json.
  • src/components의 React 컴포넌트, src/hooks의 hooks, src/data/mockData.ts의 목 데이터, 그리고 이를 렌더링하는 업데이트된 entry point.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    Stitch 네임스페이스 찾기

    list_tools를 실행하여 MCP 프리픽스를 알아낸 다음, 이후의 모든 Stitch 호출에 그 프리픽스를 재사용합니다.

  2. 02
    모든 화면의 메타데이터 가져오기

    프로젝트의 각 화면에 대해 get_screen을 호출하여 디자인 JSON과 다운로드 URL을 빠짐없이 가져옵니다.

  3. 03
    스크립트를 통해 다운로드

    내부 fetch 도구는 Google Cloud Storage에 대해 실패할 수 있으므로, 리다이렉트와 보안 핸드셰이크를 처리하는 제공된 bash 스크립트를 통해 다운로드합니다.

  4. 04
    디자인 토큰 추출

    다운로드한 각 HTML 파일을 열고, head 스크립트 블록의 tailwind.config 객체에서 색상, 폰트, 스페이싱, radius, 타이포그래피를 읽습니다.

  5. 05
    템플릿에서 컴포넌트 작성

    제공된 컴포넌트 템플릿을 기반으로, entry point를 연결하기 전에 placeholder 컴포넌트 이름의 모든 인스턴스를 바꿔줍니다.

02 적합성 확인

stitch::react-components Skill을 사용해야 하는 경우

이러한 종류의 UI 디자인 작업일 때 Claude Code 또는 Codex에서 stitch::react-components 스킬을 사용하십시오. 적합성 및 제한 사항은 스킬 자체 파일에서 가져온 것입니다.

적합한 경우

  • Stitch 디자인을 보유하고 있으며, 하나의 큰 변환된 페이지 대신 깔끔하고 모듈화된 React 코드를 원하는 경우.
  • 이미 React 컴포넌트가 있고, 이를 최신 Stitch 디자인과 다시 맞춰야 하는 경우.
  • 각 Stitch 화면이 독립된 페이지가 되는 멀티 페이지 앱을 구성 중이며, placeholder 링크를 실제 라우트와 동작하는 내비게이션으로 바꿔야 하는 경우.
  • 생성된 코드를 눈으로 확인하는 대신 자동화된 품질 게이트를 원하는 경우.

한계 인지하기

  • 부분적으로 실행할 수 없습니다. 이 skill은 모든 단계가 필수이며 각 섹션에는 다음으로 넘어가기 전에 충족해야 하는 게이트가 있다고 명시합니다.
  • 이미 다운로드된 디자인 HTML을 넘겨주고 MCP 조회 단계를 건너뛸 수는 없습니다.
  • 자체 판단으로 dev server를 시작하거나 브라우저 감사를 실행하지 않습니다.
  • 생성된 컴포넌트에는 Google 라이선스 헤더가 포함되어서는 안 됩니다.

제공할 사항

  • 기존 로컬 디자인 파일에 대한 결정.stitch/designs/{page}.html과 .png가 이미 존재하는 경우, 다시 다운로드할지 재사용할지 질문받게 되며, 이 skill은 임의로 가정하지 않습니다.
  • 검증 단계에 대한 승인npm run dev가 시작되거나 시각적 브라우저 감사가 시작되기 전에 승인을 요청받습니다.
  • 대상 프로젝트 고유의 제약컴포넌트 결정은 일반적인 레이아웃이 아니라 구축 중인 특정 프로젝트의 요구를 따라야 합니다.

03 스킬 내부

stitch::react-components 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. 모든 컴포넌트에는 Props 인터페이스가 필요합니다

    페이지를 포함한 각 컴포넌트 파일은 컴포넌트 이름을 딴 Readonly TypeScript 인터페이스를 선언해야 합니다. 이를 갖추지 않은 파일은 검증기에서 실패합니다.

  2. 거대한 단일 페이지 파일 금지

    카드, 배지, 페이지네이션, 검색창 같은 재사용 가능한 UI 패턴은 각각 src/components 아래에 별도 파일로 만들어야 하며, 페이지 전체를 담은 단일 파일은 금지됩니다.

  3. 로직은 훅에 둡니다

    이벤트 핸들러와 비즈니스 로직은 src/hooks 아래 커스텀 훅으로 옮겨야 하며, 예를 들어 페이지네이션은 usePagination으로, 필터링은 useFilter로 옮깁니다.

  4. 하드코딩된 콘텐츠 금지

    모든 정적 텍스트, 이미지 URL, 목록은 컴포넌트 파일 안이 아니라 src/data/mockData.ts에 있어야 합니다.

  5. 자리표시자 Href를 라우트로 전환합니다

    Stitch 화면은 href="#" 링크와 함께 제공되며, 이들 모두 올바른 라우트를 가리키는 React Router Link로 바뀌어야 합니다.

  6. 로고를 홈 링크로 만듭니다

    TopAppBar 로고 또는 제목은 루트로 향하는 Link여야 합니다. Stitch 하단 내비게이션 바는 md:hidden 처리되어 데스크톱에서는 보이지 않기 때문입니다.

  7. 모든 곳에 테마 토큰과 다크 모드를 적용합니다

    색상 클래스는 임의의 헥스 코드가 아니라 동기화된 스타일 가이드에서 가져와야 하며, 모든 색상 클래스에는 dark: 변형도 함께 있어야 합니다.

  8. 실행하기 전에 먼저 물어봅니다

    검증 스크립트, 개발 서버, 자동 브라우저 감사는 사용자가 허락한 뒤에만 실행됩니다.

04 활용하기

Claude Code 또는 Codex에 stitch::react-components 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용자 에이전트에 stitch::react-components 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/google-labs-code/stitch-skills --skill stitch::react-components

plugins/stitch-build/skills/react-components/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소마다 자체 경로를 문서화할 수 있습니다.

스킬에 첫 UI 디자인 작업 부여하기

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
Convert the screens in my Stitch project [project name] into a modular React + Vite app. Use scripts/fetch-stitch.sh to download every screen, sync the Tailwind tokens into resources/style-guide.json, then split the layout into components under src/components with logic in src/hooks and content in src/data/mockData.ts. Wire all the href="#" navigation links to React Router routes with dark mode variants, and ask me before running validation or the dev server.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • src/components와 src/pages의 모든 .tsx 파일에 대해 AST 검증기를 실행해 컴포넌트 유효성을 보고합니다.
  • 작업이 끝났다고 판단하기 전에 tsc --noEmit을 실행해 TypeScript가 컴파일되는지 확인합니다.
  • 결과물을 배포된 아키텍처 체크리스트와 비교합니다.
  • 가정하지 말고 다운로드한 각 스크린샷을 직접 확인해 디자인 의도와 레이아웃 세부 사항을 검증합니다.
  • 토큰을 다시 추출한 뒤, 스타일 가이드의 기본 색상, 글꼴, 간격이 HTML에서 가져온 값과 일치하는지 확인합니다.
  • 내비게이션을 하나씩 클릭해 각 항목이 올바른 페이지로 이어지는지 확인합니다.

OpenDesign에서 stitch::react-components를 SKILL.md 링크에서 가져옵니다: Plugins → Add → Skill → Import from link, 그런 다음 상단 바에서 선택합니다.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

스킬 파일
plugins/stitch-build/skills/react-components/SKILL.md 검증 시 콘텐츠 체크섬 기록됨; 커밋 0337446
License
Apache-2.0 LICENSE에서 확인.
리포지토리 스타
8,304 GitHub 스냅샷은 2026-09-14에 google-labs-code/stitch-skills 저장소 전체에 대해 촬영되었으며, 이 카탈로그에는 12개의 스킬이 포함되어 있습니다. stitch::react-components에 대한 평가 또는 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 1단계: 수집 및 네트워킹MCP 프리픽스를 찾고, 모든 화면을 가져오고, 스크립트로 다운로드하고, 스크린샷을 검토하고, 메타데이터를 작성합니다.
  2. 2단계: 스타일 추출현재 HTML head에서 tailwind.config 토큰을 가져와 공유 스타일 가이드를 덮어씁니다.
  3. 3단계: 아키텍처 규칙모듈화된 파일, 훅, 목 데이터, Props 인터페이스, 테마 토큰, 라우팅 및 다크 모드.
  4. 4단계: 실행 단계설치, 데이터 계층 구축, 템플릿으로부터 초안 작성, 앱 연결, 그리고 사용자 승인 시 선택적 검증.
  5. 문제 해결가져오기 오류, 검증 실패, 끊어진 내비게이션 링크, 오래된 스타일 가이드에 대한 해결 방법.
스킬 자체 설명
"- Stitch 디자인을 모듈식 Vite 및 React 컴포넌트로 변환하거나, 기존 React 컴포넌트를 최신 Stitch 디자인과 동기화/업데이트합니다. 시스템 수준 네트워킹 및 AST 기반 검증을 사용합니다."

SKILL.md의 프런트 매터 설명입니다. 전체 파일은 약 8,725자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

stitch::react-components 스킬에 대한 질문

이 답변은 2026-09-14 기준으로 확인한 SKILL.md 내용을 근거로 하며, 실행 기록을 바탕으로 한 것이 아닙니다.

이 디자인을 이미 한 번 다운로드했습니다. 덮어쓰게 되나요?

아닙니다. .stitch/designs/{page}.html과 .stitch/designs/{page}.png가 이미 존재하면 Stitch 프로젝트에서 새로 가져올지 로컬 파일을 재사용할지 묻고, 확인한 후에만 다시 다운로드합니다.

Stitch React Components

실제 UI 디자인 작업에서 stitch::react-components를 실행합니다.

OpenDesign을 다운로드하고, SKILL.md 링크에서 stitch::react-components를 가져온 다음, 위 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/google-labs-code/stitch-skills --skill stitch::react-components

OpenDesign 데스크톱

하나의 디자인 시스템으로 모든 결과물에 브랜드 일관성을

완전한 Vibe Design Workspace에서 하나의 브랜드 규칙을 웹사이트, 슬라이드, 인터랙티브 프로토타입, 대시보드, 이미지, HTML 영상에 적용하세요. 로컬 Codex, Claude Code, Cursor 등을 연결해 무료로 제작할 수 있습니다.

  • 웹, 슬라이드, 프로토타입, 대시보드, 이미지, 영상
  • 140개+ 디자인 시스템과 전체 템플릿·스킬 라이브러리
  • 로컬 Codex 및 21개+ 코딩 에이전트 연결 · 무료
무료 다운로드

macOS, Windows 지원