Communitygithub.com

do-design

UI 및 시각 디자인 스킬. 바인딩된 DESIGN.md을 기준으로 삼고, 측정 가능한 모든 항목에 스크립트를 사용합니다. 페이지 및 컴포넌트를 디자인하거나 스타일을 변경하고, UI 변경 사항을 검토하고, UI를 감사 및 평가하고, 사이트를 재설계하고, 디자인 전 시장을 조사하고, 대담한 방향을 제시하거나, 저장소에 디자인 가드레일을 설치하는 데 사용합니다. 명령어: do-audit, do-design-new, do-design-review, do-design-renew, do-crazy.

do-design란 무엇인가요?

do-design은 AI 에이전트(Claude Code, Cursor 등)를 위한 포괄적인 UI/시각 디자인 스킬입니다. 바인딩된 DESIGN.md 문서를 최우선 기준으로 삼아 모든 디자인 결정을 이 문서에 기반하도록 합니다. 디자인 감사(do-audit), 새 디자인 생성(do-design-new), 디자인 리뷰(do-design-review), 디자인 갱신(do-design-renew), 파격적인 방향 제시(do-crazy) 등 5가지 주요 명령어를 제공하며, 각 명령어는 특정 디자인 작업에 맞춰져 있습니다. 모든 측정 가능한 요소(계층 구조, 가독성, 시스템 일관성, 공예, 콘텐츠 진실성, 사용성, 차별성)에 대해 스크립트를 실행하여 객관적인 점수와 작업 목록을 생성합니다. 이 스킬은 증거 기반 디자인, 가드레일 설치, 교체 테스트(Swap test)와 같은 방법론을 통해 디자인의 일관성과 품질을 유지하는 데 중점을 둡니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diononline-un/design-skill/tree/HEAD

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

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

문서

do-design은(는) 무엇을 하나요?

경로는 이 스킬 폴더 기준이며; P는 프로젝트 루트입니다. 스크립트는 표준 라이브러리 Python 3.8+입니다. 스크립트가 측정하는 모든 것에 대해 추론하기 전에 먼저 스크립트를 실행하고, 그 결과를 인용하며, 스크립트가 보고한 내용을 재추론하거나 추정하지 마십시오.

모델

  1. 프로젝트의 DESIGN.md (종이)가 바인딩되며 이 스킬보다 우선합니다. 충돌 시 종이가 승리합니다. 그렇게 말하십시오.
  2. 모든 규칙은 이유를 함께 제시합니다. 이유 없는 규칙은 처음 불편해질 때 삭제됩니다.
  3. 기본값보다 증거가 먼저입니다. 얇은 브리프("새롭게 만들어라" + 로고)는 조사해야 할 이유이지, 일반적인 모양으로 돌아가거나 사실을 지어낼 이유가 아닙니다. 출처가 없으면 주장도 없습니다: 그 차이(gap)를 표시하거나 질문하십시오.
  4. 느리게 로드하십시오. 명령어 테이블이 명명한 파일만 로드합니다. "완전함"을 위한 추가 레이어는 방법론적 실패입니다.
  5. 관례는 기본값이지 실패가 아닙니다. 모드는 얼마나 벗어날지를 결정합니다.

모드: 모든 명령어 시작 시 한 줄로 상태를 명시하십시오

모드방문자는추진력
설득(Persuade)결정하고 행동하고 있음강하게: 템플릿은 실패입니다
작동(Operate)작업을 완료하고 있음자제: 관례는 기능입니다
읽기(Read)무언가를 이해하고 있음중간: 읽기 편안함이 승리합니다
경험(Experience)작업 자체 내부에 있음강하게: 결과물이 주도합니다

표면(화면 유형)으로 선택하고 제품으로 선택하지 마십시오: 개발 도구의 랜딩 페이지는 설득(Persuade)이고, 설정 화면은 작동(Operate)입니다.

명령어: 명령 파일 하나와 해당 행이 명명하는 파일들을 로드하십시오

명령어사용 시기추가 로드위험
do-design-review"이게 종이와 일치하나요?" 가장 저렴함, 가장 자주 실행프로젝트의 DESIGN.md-
do-audit"이게 얼마나 좋은가요?" 점수 + 순위별 발견 사항references/critique-rubric.md, references/slop-catalog.md, 범위가 닿는 레이어 00-05-
do-design-new"X를 구축하라": 관례적이고, 유능하며, 종이에 기반layers/00, 작업이 닿는 1-3 레이어; 브리프가 얇거나 고객 대상일 때 layers/06낮음
do-design-renew"이 모양을 재구성하라": 새로운 세계, 동일한 제품 진실layers/00, layers/06중간
do-crazy"이 업계에서는 아무도 하지 않을 것"layers/00, layers/06높음, 설계된 대로

레이어: 00-craft-floor (모든 모드) · 01-color · 02-typography · 03-space-layout · 04-motion-states · 05-voice · 06-research. 종이 작성: templates/DESIGN.md, examples/01-two-papers.md, references/interview.md.

스크립트 (모두 --json 인수 사용)

실행결과
scripts/check-design.py --root P종이의 토큰 블록과의 차이(drift). 종료 코드 0: 일치, 1: 차이, 2: 종이/토큰 없음. --init는 코드에서 토큰 초안을 생성합니다
scripts/audit.py scan P소스 텔(tells) (slop 카탈로그의 ID), a11y 및 브라우저 표면 차이, 가치 인벤토리
scripts/audit.py copy P산문 및 마이크로카피 텔, 문장 리듬, 채워지지 않은 차이 마커
scripts/audit.py contrast FG BG / --paper P/DESIGN.mdWCAG 비율
scripts/audit.py score H L S C T U D가중 점수, 밴드, 작업 목록
scripts/render-audit.py URL-or-file [--shots DIR] [--inject-css FILE]1280/768/390에서 그려진 페이지: 겹침, 가로 스크롤, 클리핑, 그려진 대비, 탭 대상, 포커스 가시성. --inject-css는 배포 전에 배포된 페이지에 대해 CSS 수정을 측정합니다. Chrome/Chromium 필요
`scripts/research.py suggestprofile
bash scripts/install-guardrails.sh P템플릿의 DESIGN.md, AGENTS.md/CLAUDE.md 블록, 체커

스크린샷은 스크립트 출력보다 훨씬 많은 컨텍스트를 소비합니다: 눈으로 확인해야 하는 것(계층, 구별, 구성)에만, 뷰포트만, 390 우선으로 사용하십시오. 스크립트도 틀릴 수 있습니다: 터무니없어 보이는 P0를 보고하기 전에 한 번 확인(대상 스크린샷 또는 요소의 지오메트리)하고, 거짓 긍정이었다면 스크립트를 수정하십시오.

공유 정의

교체 테스트(Swap test). 제품 이름을 경쟁사 제품 이름으로 바꾸십시오. 아무것도 깨지지 않는다면, 페이지는 이 제품에 대해 아무 말도 하지 않는 것입니다: 선택되지 않음, 못생기지 않음. 장식을 추가하는 것이 아니라 카피, 시각적 요소 및 하나의 시그니처 세부 사항에서 수정하십시오.

방향(Direction), 다섯 줄. 빌드 전에 작성하고, 보여주고, 예스(YES)를 기다리십시오 ("그냥 해"라고 하면 한 줄로 가정을 명시하고 진행하십시오):

제품:    무엇을 하는지, 누구를 위한 것인지, 한 문장으로 평범하게
성격:   2-3개의 구체적인 단어 (깔끔한, 현대적인, 세련된, 미니멀한, 프리미엄 절대 안 됨)
세상:   그것이 속한 장소나 재료; 중립 색조, 강조 색상, 이미지 설정
순간:   화면이 풍부해지는 1-2곳
시그니처: 이 제품만이 가지고 있는, 일관되게 사용되는 하나의 세부 사항

차이 마커(Gap marker). [number needed], [source needed], [photo needed] 사실이나 에셋이 누락된 곳에 표시. audit.py copy는 아직 열려 있는 것들을 나열합니다; 아무 것도 출시되어서는 안 됩니다.

점수 매기기: 모든 평가 명령어는 이것으로 끝납니다

#필드질문가중치
1계층(Hierarchy)가장 중요한 것을 2초 안에 이름 지을 수 있습니까?3
2가독성(Legibility)모든 너비에서 대비, 크기, 행 길이, 실제 카피3
3시스템(System)하나의 팔레트, 하나의 스케일, 하나의 반경 로직, 하나의 모션 언어2
4공예(Craft)정렬, 간격 리듬, 상태, 브라우저 표면2
5콘텐츠 진실성(Content truth)실제 데이터, 구체적인 카피, 지어낸 주장 없음3
6사용성(Usability)작업 완료; 어포던스 명확; 오류 복구 가능3
7차별성(Distinction)교체 테스트를 통과합니까?2

각각 0-4점 (4 = 진정으로 훌륭함, "괜찮음"이 아님)으로 점수를 매기고 audit.py score로 계산하십시오. 밴드: 85+ 강력함, 출시하고 P0만 수정 · 70-84 건실함, 명명된 P1 이후 출시 · 50-69 약함, 실제 패스 먼저 · <50 실패, 방향이 잘못됨: 재구축 (do-design-renew). 소스가 아닌 렌더링에 점수를 매기십시오. 확인할 수 없었던 필드는 u입니다: 0점으로 처리되고 unverified로 읽히며, 절대 추정하지 않습니다. 차별성은 이 제품의 것으로 만드는 것이 무엇인지 이름 지을 수 있을 때만 4점을 받습니다. 가장 낮은 세 개의 필드가 작업 목록이 되며, 각각 하나의 조치가 따릅니다.

심각도: P0 출시 차단 (깨짐, 읽을 수 없음, 하드 금지), 모두 보고 · P1 신뢰 손상, 상위 5개 · P2 공예, 상위 5개 · P3 다듬기, 목록만. 발견 형식: [Pn] 위치 - 무엇이 잘못되었는지 - 수정 방법; 스크립트 발견 사항은 ID를 유지합니다.

종이 없음

"DESIGN.md 없음: 가드레일이 강제할 것이 없습니다."라고 말하십시오. 종이를 작성(템플릿 + 인터뷰)하거나, 코드에서 리트로핏(check-design.py --init + 인터뷰 §Retrofit)을 제공하십시오: v1.0은 출시되는 것이며, 이전 값은 legacy:로 이동(계산되지만 실패로 간주되지 않음)하고, 차이는 종이의 델타 목록에 기록됩니다. 아카이브와 데모는 skip: (또는 --skip a,b)을 통해 폴더나 파일별로 모든 스캔에서 제외됩니다. 건너뛰기 전에 임포트를 grep하십시오: 아카이브 폴더는 종종 라이브 파트를 보유하고 있습니다. 체커가 통과하도록 종이를 절대 지어내지 마십시오.

비협상 사항

  1. 작동하는 코드를 절대 깨지 마십시오. Props, state, routing, handlers 및 a11y는 유지되고; 카피는 그 의미를 유지합니다.
  2. 브리프가 승리합니다. 명시된 브랜드, 글꼴 또는 색상은 거부 목록에 있더라도 취향보다 우선합니다. 그것을 종이에 기록하십시오 (allow:는 토큰 블록에서 체커 규칙 또는 감사 ID를 의도적으로 끕니다).
  3. 사실, 에셋 또는 출처를 절대 지어내지 마십시오. 모호한 주장을 자르십시오; 지어낸 구체적인 내용으로 대체하지 마십시오. 차이 마커를 사용하십시오.
  4. 저자의 목소리를 유지하십시오. 기계적인 습관을 자르고, 사람의 특성을 유지하십시오.
  5. 존재가 아닌 밀도. 하나의 그라데이션이나 하나의 em 대시가 아닌, 클러스터(3개 이상의 별개 P0/P1 텔)에 대해 행동하십시오. 깨끗한 결과는 유효합니다; 발견 사항을 절대 만들어 내지 마십시오.
  6. 고발하지 말고 수정하십시오. "이것은 AI가 생성한 것처럼 보입니다"라고 말하지 마십시오; 선택되지 않은 것이 무엇이고 대신 무엇을 해야 하는지 이름을 지으십시오.
  7. 리뷰 및 감사의 경우 요청이 없으면 읽기 전용으로 처리하십시오.

관련 스킬