Young Tries AI

craft 스킬로 AI 에이전트가 모든 상태까지 챙겨 화면을 디자인하게 만들기

Claude Code나 Codex 같은 에이전트에게 화면 디자인을 맡기는 개발자와 크리에이터를 위한 중급 가이드입니다. 브리프 작성부터 상태 정리, 리뷰까지 이어지는 흐름을 익힙니다.

웹·디자인대상: 개발자, 크리에이터

시작하기 전에

  • Claude Code (또는 Codex, OpenCode, Cursor, Gemini CLI, GitHub Copilot, Windsurf)
  • 스킬이 다룰 수 있는 디자인 도구: Paper, Figma 또는 일반 HTML
  • Claude 외 에이전트용: npx 실행을 위한 Node.js (skills.sh의 skills CLI)
  1. Claude Code 세션 안에서 craft 플러그인 마켓플레이스를 추가하세요. Claude Desktop이나 claude.ai에서는 Customize › Plugins › Add › Add marketplace로 가서 diego3g/craft를 입력하세요.

    마켓플레이스 추가
    /plugin marketplace add diego3g/craft
  2. 방금 추가한 마켓플레이스에서 craft를 설치하세요. 이 플러그인은 세션 시작 훅을 추가해서, 요청마다 알맞은 스킬이 자동으로 연결됩니다. 스킬 이름 앞에는 플러그인 이름이 붙어 /craft:craft, /craft:craft-setup처럼 씁니다.

    플러그인 설치
    /plugin install craft@craft
  3. Codex, OpenCode, Cursor 같은 에이전트에서는 아래 명령어를 실행하세요. 설치할 에이전트를 물어봅니다. 현재 프로젝트뿐 아니라 모든 프로젝트에 설치하려면 -g를 붙이세요. 이런 에이전트는 세션 시작 훅을 실행하지 않으므로, README의 라우팅 블록을 AGENTS.md에 붙여 넣어야 알맞은 스킬을 고릅니다.

    터미널에서 실행
    npx skills add diego3g/craft
  4. craft-setup을 실행하세요. 제품, 대상과 말투, 분위기, 브랜드, 레퍼런스, 제약 조건을 한 번에 하나씩 묻고, 답을 바탕으로 DESIGN.md를 쓰고 토큰과 기본 컴포넌트 같은 기반을 만듭니다. 저장소에 컴포넌트 라이브러리나 토큰 파일이 이미 있으면 craft-sync를 대신 제안합니다.

    setup 실행 (Claude Code)
    /craft:craft-setup
  5. 필요한 화면을 말로 설명하세요. craft는 범위와 상태 목록을 먼저 확인하고, 디자인 시스템의 요소로 화면을 그린 뒤 스스로 점검한 결과를 보여 줍니다. 중요한 지점에서는 승인을 받으려고 멈춥니다.

    요청 예시
    Design a settings page with billing and team.
  6. 방향이 확실하지 않으면 옵션을 요청하세요. craft-explore가 구조, 인터랙션, 밀도가 실제로 다른 세 가지 방향을 현재 디자인 옆에 그려 주고, 추천안을 맨 앞에 둡니다. 출시 전에는 리뷰를 요청하세요. craft-critique가 디자인을 렌더링해 영향이 큰 순서로 문제를 정리하며, 리뷰 모드에서는 아무것도 바꾸지 않습니다.

    옵션 요청
    Give me options.
  7. 가끔 감사(craft-system)를 요청하세요. 디자인 도구에서 가이드를 바꾼 뒤에는 에이전트에게 가이드 변경을 코드에 반영해 달라고 요청하세요(craft-sync). 버튼을 2px 키우는 것처럼 작고 정확한 수정은 이 과정을 건너뛰고 에이전트가 바로 처리합니다.

주의할 점

  • Claude Code 외 에이전트는 세션 시작 훅을 실행하지 않아, AGENTS.md에 라우팅 블록이 없으면 알맞은 스킬을 고르지 못할 수 있습니다.
  • craft-setup을 먼저 실행하세요. 다른 모든 스킬이 DESIGN.md를 가장 먼저 읽고, DESIGN.md 없이 디자인을 요청하면 craft-setup으로 연결됩니다.
  • 업데이트는 Claude Code에서는 셸에서 claude plugin update craft@craft를, skills CLI에서는 npx skills update를 실행하세요.

자주 묻는 질문

craft는 어떤 디자인 도구와 함께 쓸 수 있나요?
Paper, Figma, 일반 HTML과 함께 쓰며, Claude Code, Codex, OpenCode, Cursor 등 여러 에이전트에서 동작합니다.
플러그인 시스템 없이 설치할 수 있나요?
가능합니다. skills/ 안의 폴더를 프로젝트의 .agents/skills/에 직접 복사한 뒤, AGENTS.md에 라우팅 블록을 추가하세요.
craft-states는 무엇을 하나요?
빈 화면, 로딩, 오류, 긴 콘텐츠, 권한, 오프라인처럼 화면이 놓일 모든 상태를 현실적으로 지저분한 데이터로 나열하고, 각각 그린 뒤 이름을 붙입니다.

출처

바탕이 된 소식