사용 가이드로 건너뛰기
design-handoff작성자 Anthropic

Design Handoff 스킬.

브랜드 및 디자인 시스템 작업을 위한 Claude Code 및 Codex 스킬입니다. 디자인으로부터 개발자 핸드오프 사양을 생성합니다: 레이아웃, 토큰, 컴포넌트 상태, 중단점.

  • Brand & Design Systems
  • 핸드오프 사양
anthropics/knowledge-work-plugins · design/skills/design-handoff/SKILL.mdSKILL.md
--- name: design-handoff description: 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. --- ## Usage ## What to Include ## Principles ## Output ## Handoff Spec: [Feature/Screen Name] ## If Connectors Available
2026-09-14에 업스트림 파일에서 읽은 전문 및 섹션 제목 · 전체 3,939자

01 기능

Claude Code와 Codex에서 design-handoff Skill이 하는 일

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

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

스킬 자체의 표현으로

디자인으로부터 개발자 핸드오프 문서를 생성하며, 디자인이 엔지니어링에 넘길 준비가 되어 스펙 시트가 필요한 팀을 대상으로 합니다. Figma URL을 지정하거나, 없으면 설명이나 스크린샷으로 대체하며, 시각 명세, 인터랙션 명세, 콘텐츠 명세, 예외 상황, 접근성을 차례로 다룹니다.

출력물은 개요, 레이아웃, 사용된 디자인 토큰, 컴포넌트, 상태 및 인터랙션, 반응형 동작, 엣지 케이스, 애니메이션 및 모션, 접근성 노트 섹션으로 구성된 Markdown Handoff Spec입니다. 여기서 명시된 네 가지 원칙은 추측하지 않고 모든 것을 명시할 것, 원시 값 대신 토큰을 참조할 것, 모든 상태를 보여줄 것, 동작의 이유를 설명할 것입니다.

산출물

  • 각 토큰과 그 값, 용도를 나열한 디자인 토큰 표입니다.
  • 각 컴포넌트의 variant, props, 특별 동작 노트를 정리한 컴포넌트 표입니다.
  • 요소, 트리거, 애니메이션, 지속 시간, 이징을 기록한 애니메이션 및 모션 표입니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    디자인 소스 확인하기

    Figma URL이 있으면 디자인을 Figma에서 가져오고, 없으면 스킬은 작성된 설명이나 스크린샷을 기반으로 작동합니다.

  2. 02
    비주얼 명시하기

    정확한 패딩, 마진, 너비, 색상·타이포그래피·간격에 대한 디자인 토큰 참조, 반응형 브레이크포인트, 컴포넌트 variant와 상태입니다.

  3. 03
    인터랙션 명시하기

    클릭 및 탭 동작, 호버 상태, 제스처 지원, 지속 시간과 이징이 기록된 전환입니다.

  4. 04
    콘텐츠와 엣지 케이스 다루기

    글자 수 제한, 말줄임, 빈 상태, 로딩 및 오류 상태, 그리고 최소·최대 콘텐츠, 더 긴 다국어 문자열, 느린 연결, 데이터 누락 상황입니다.

  5. 05
    접근성 세부 사항 추가하기

    포커스 순서, ARIA 레이블 및 role, 키보드 인터랙션, 스크린 리더 안내입니다.

  6. 06
    템플릿 형식으로 스펙 출력하기

    결과물은 파일의 섹션 및 표 구조를 사용하여 Markdown Handoff Spec 형태로 작성됩니다.

02 적합성 확인

design-handoff Skill 사용 시기

이러한 종류의 브랜드 및 디자인 시스템 작업일 때 Claude Code 또는 Codex에서 design-handoff 스킬을 사용합니다. 적합성과 한계는 스킬 자체 파일에서 가져왔습니다.

적합한 경우

  • 디자인이 완료되어 엔지니어링에 넘길 준비가 되었고, 팀에서 레이아웃, 토큰, 컴포넌트 props, 상태, 브레이크포인트, 엣지 케이스, 애니메이션을 다루는 스펙 시트가 필요한 경우입니다.
  • 프로젝트 트래커가 연결되어 있고, 핸드오프를 구현 티켓과 연동하고자 하는 경우입니다.

한계 인지하기

  • Figma에서 도출된 정확한 측정값, 토큰 값, 내보낸 에셋, 완전한 스펙 시트는 디자인 도구가 연결되어 있을 때만 제공됩니다.
  • 각 스펙 섹션에 대한 하위 작업 설정은 프로젝트 트래커 연결 여부에 따라 달라집니다.

제공할 사항

  • Figma URL 또는 디자인 설명이것이 명령어가 기대하는 인자이며, 스펙이 여기서부터 생성됩니다.

03 스킬 내부

design-handoff 스킬이 Claude Code와 Codex에 부여하는 규칙

SKILL.md가 에이전트를 위해 설정하는 7가지 구체적 지침, 기본값, 한도 — 결과를 바꾸는 파일의 부분

  1. 모든 것을 명시하기

    첫 번째 원칙은 추측하지 않는 것입니다. 무언가가 명시되어 있지 않으면 개발자는 추측하게 되므로, 핸드오프는 이를 반드시 다루어야 합니다.

  2. 원시 값이 아닌 토큰을 참조합니다

    값은 픽셀 숫자가 아니라 spacing-md와 같은 토큰 이름으로 작성됩니다.

  3. 모든 상태 표시

    default, hover, active, disabled, loading, error, empty 등 모든 상태가 포함되어야 합니다.

  4. 이유를 설명합니다

    동작과 함께 근거를 포함하면 개발자가 올바른 판단을 내릴 수 있습니다. 예를 들어 모바일에서 왜 접히는지를 설명합니다.

  5. 엣지 케이스를 명시적으로 요청합니다

    항목이 100개일 때 어떻게 되는지와 같은 경계 질문을 명시하면 해당 경계 조건이 스펙에 반영됩니다.

  6. 기술 스택을 알려줍니다

    예를 들어 React와 Tailwind처럼 스택을 명시하면 해당 스택에 맞는 구현 노트가 생성됩니다.

  7. Figma 링크를 공유합니다

    링크가 있어야 추측이 아니라 정확한 치수, 토큰, 컴포넌트 정보를 가져올 수 있습니다.

04 활용하기

Claude Code 또는 Codex에 design-handoff 설치

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

Claude Code, Codex 또는 사용자 에이전트에 design-handoff 추가

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

Terminal
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill design-handoff

design/skills/design-handoff/SKILL.md에 대한 일반적인 skills CLI 형식입니다. 저장소가 자체 경로를 문서화할 수도 있습니다.

스킬에 첫 브랜드 및 design-system 작업 과제를 제공합니다

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

Starter prompt
Generate a developer handoff spec for the [checkout confirmation screen] in [Figma URL]. I need exact padding and margins, design token references instead of raw values, all component states including loading and error, and the responsive behavior at each breakpoint. We use [React + Tailwind], and please spec the empty state and what happens with [very long product names].

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

첫 번째 결과 확인

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

  • 반응형 동작 표에는 768px 미만 모바일에 대한 빈 자리표시자가 아니라 채워진 행이 있습니다.
  • 엣지 케이스는 데이터가 없을 때 무엇을 표시할지를 잘림, 로딩, 오류 동작과 함께 명시합니다.
  • 접근성 노트는 포커스 순서와 필요한 ARIA 레이블을 명시합니다.

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

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

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

Author
Anthropic
스킬 파일
design/skills/design-handoff/SKILL.md 검증 시점의 콘텐츠 체크섬 기록됨; 커밋 8f877b6
License
Apache-2.0 LICENSE에서 확인
리포지토리 스타
24,012 anthropics/knowledge-work-plugins 저장소 전체에 대한 GitHub 스냅샷(2026-09-14 기준). 이 카탈로그에 포함된 7개 스킬의 수치이며, design-handoff 단독 평가나 사용 횟수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 스타 수가 확인되었습니다. OpenDesign 메인에 번들로 포함되지 않음(2026-08-28 확인); 이 페이지에 실제 실행 기록이 없습니다.

SKILL.md 내부

  1. 사용법/design-handoff 호출과 $ARGUMENTS, @$1 플레이스홀더를 보여줍니다.
  2. 포함할 내용다룰 항목을 나열합니다: 시각적 스펙, 인터랙션, 콘텐츠, 엣지 케이스, 접근성 스펙.
  3. 원칙네 가지 규칙: 추측하지 않는다, 토큰을 사용한다, 모든 상태를 표시한다, 이유를 설명한다.
  4. 출력제목과 표가 포함된 Markdown Handoff Spec 템플릿을 제공합니다.
  5. 커넥터가 있는 경우연결된 디자인 도구와 프로젝트 트래커에 대한 조건부 추가 항목입니다.
  6. 팁세 가지 팁: Figma 링크를 공유한다, 엣지 케이스를 언급한다, 기술 스택을 명시한다.
스킬 자체 설명
디자인에서 개발자 인수인계 명세서를 생성합니다. 디자인이 엔지니어링 준비를 마치고 레이아웃, 디자인 토큰, 컴포넌트 속성, 상호작용 상태, 반응형 중단점, 엣지 케이스, 애니메이션 세부사항을 다루는 명세서가 필요할 때 사용합니다.

SKILL.md의 front-matter 설명입니다. 전체 파일은 약 3,939자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

design-handoff 스킬에 대한 질문

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

디자인 도구가 연결되면 무엇이 달라지나요?

Figma에서 정확한 측정값, 토큰, 컴포넌트 스펙을 직접 가져오며, 에셋을 내보내고 완전한 스펙 시트를 생성할 수 있습니다.

Design Handoff

실제 브랜드 및 design-system 작업 태스크에서 design-handoff를 실행합니다.

OpenDesign를 다운로드하고, SKILL.md 링크에서 design-handoff를 가져온 뒤, 위 프롬프트를 붙여넣고 결과 전에 계획을 확인하십시오.

터미널
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill design-handoff

OpenDesign 데스크톱

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

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

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

macOS, Windows 지원