Communitygithub.com

Figma MCP: 디자인-코드 변환 스킬

Figma MCP 서버를 사용하여 디자인 컨텍스트, 스크린샷, 변수 및 에셋을 가져오고 Figma 노드를 프로덕션 코드로 변환합니다. Figma URL, 노드 ID, 디자인-투-코드 구현 또는 Figma MCP 설정 및 문제 해결과 관련된 작업에서 트리거됩니다.

Figma MCP: 디자인-코드 변환 스킬란 무엇인가요?

이 스킬은 Figma MCP 서버를 활용하여 Figma 디자인을 프로젝트 코드로 정확하게 변환하는 방법을 정의합니다. 개발자는 `get_design_context`와 `get_screenshot`을 순차적으로 실행하여 디자인의 구조적 정보와 시각적 참조를 모두 확보한 후, 에셋을 다운로드하고 구현을 시작해야 합니다. 생성된 React + Tailwind 코드는 프로젝트의 컨벤션, 디자인 시스템 토큰, 기존 컴포넌트를 최대한 재사용하여 1:1 시각적 일치를 목표로 합니다. 또한, Figma MCP 서버가 반환하는 로컬호스트 이미지/SVG 소스를 직접 사용하고, 불필요한 아이콘 패키지를 추가하지 않도록 주의합니다. 이 스킬은 Figma URL을 기반으로 노드 ID를 추출하는 링크 기반 프롬프트 방식을 지원하며, 설정 및 문제 해결을 위한 참조 문서도 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/figma

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

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

문서

Figma MCP

Figma 기반 구현을 위해 Figma MCP 서버를 사용합니다. 설정 및 디버깅 관련 세부 사항(환경 변수, 설정, 검증)은 references/figma-mcp-config.md를 참조하세요.

Figma MCP 통합 규칙

다음 규칙은 이 프로젝트에서 Figma 입력을 코드로 변환하는 방법을 정의하며, 모든 Figma 기반 변경 사항에 대해 반드시 준수해야 합니다.

필수 플로우 (건너뛰지 마세요)

  1. 먼저 get_design_context를 실행하여 대상 노드의 구조화된 표현을 가져옵니다.
  2. 응답이 너무 크거나 잘린 경우 get_metadata를 실행하여 상위 수준 노드 맵을 확인한 후, 필요한 노드만 get_design_context로 다시 가져옵니다.
  3. 구현 중인 노드 변형의 시각적 참조를 위해 get_screenshot을 실행합니다.
  4. get_design_context와 get_screenshot을 모두 확보한 후에만 필요한 에셋을 다운로드하고 구현을 시작합니다.
  5. 출력(일반적으로 React + Tailwind)을 이 프로젝트의 컨벤션, 스타일 및 프레임워크로 변환합니다. 가능한 한 프로젝트의 컬러 토큰, 컴포넌트 및 타이포그래피를 재사용합니다.
  6. 완료로 표시하기 전에 Figma에 대해 1:1로 모양과 동작을 검증합니다.

구현 규칙

  • Figma MCP 출력(React + Tailwind)은 최종 코드 스타일이 아닌 디자인 및 동작의 표현으로 취급합니다.
  • 해당되는 경우 Tailwind 유틸리티 클래스를 프로젝트의 선호 유틸리티/디자인 시스템 토큰으로 대체합니다.
  • 기능을 중복하지 않고 기존 컴포넌트(예: 버튼, 입력 필드, 타이포그래피, 아이콘 래퍼)를 재사용합니다.
  • 프로젝트의 컬러 시스템, 타이포그래피 스케일 및 간격 토큰을 일관되게 사용합니다.
  • 저장소에 이미 채택된 기존 라우팅, 상태 관리 및 데이터 페칭 패턴을 존중합니다.
  • Figma 디자인과 1:1 시각적 일치를 목표로 합니다. 충돌이 발생하면 디자인 시스템 토큰을 우선하고 간격이나 크기를 최소한으로 조정하여 시각적으로 일치시킵니다.
  • 최종 UI를 Figma 스크린샷과 비교하여 모양과 동작을 검증합니다.

에셋 처리

  • Figma MCP 서버는 이미지 및 SVG 에셋을 제공할 수 있는 에셋 엔드포인트를 제공합니다.
  • 중요: Figma MCP 서버가 이미지나 SVG에 대한 로컬호스트 소스를 반환하는 경우 해당 이미지나 SVG 소스를 직접 사용합니다.
  • 중요: 새 아이콘 패키지를 가져오거나 추가하지 마십시오. 모든 에셋은 Figma 페이로드에 있어야 합니다.
  • 중요: 로컬호스트 소스가 제공되는 경우 플레이스홀더를 사용하거나 생성하지 마십시오.

링크 기반 프롬프트

  • 서버는 링크 기반입니다. 구현 도움을 요청할 때 Figma 프레임/레이어 링크를 복사하여 MCP 클라이언트에 해당 URL을 제공합니다.
  • 클라이언트는 URL을 탐색할 수 없지만 링크에서 노드 ID를 추출합니다. 항상 링크가 원하는 정확한 노드/변형을 가리키도록 하십시오.

참조

  • references/figma-mcp-config.md — 설정, 검증, 문제 해결 및 링크 기반 사용법 알림.
  • references/figma-tools-and-prompts.md — 프레임워크/컴포넌트 선택 및 메타데이터 페칭을 위한 도구 카탈로그 및 프롬프트 패턴.

Individual skills in this repo

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

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

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.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

관련 스킬