UI 작업의 대상과 주요 작업(task), 콘텐츠, 제약 조건, 성공 기준을 명확히 한 후 디자인을 시작해야 할 때 사용합니다.
이 스킬은 UI 디자인 작업을 수행하기 전에 필요한 정보를 체계적으로 수집하고 정리하는 것을 돕습니다. 사용자는 제품 문서, 경로, 컴포넌트, 기존 토큰 및 콘텐츠를 먼저 검토한 후, `brief.md` 파일을 작성해야 합니다. 이 파일은 제품, 대상 사용자, 주요 작업(task), 관찰 가능한 성공 기준, 실제 콘텐츠, 제약 조건, 참고 자료 및 공개 결정 사항을 포함합니다. 관찰된 사실과 사용자 요구사항, 가정은 명확히 구분해야 하며, 샘플 콘텐츠는 '샘플'이라고 표시해야 합니다. 제품, 대상 또는 작업이 불분명할 경우 구체적인 해석을 제안하고 사용자 확인을 요청하되, 한 번에 하나의 질문만 합니다. 기존 제품의 경우 디자인 시스템과 유지해야 할 제약 조건을 기록합니다. 작은 조정 작업의 경우에는 전체적인 탐색을 강요하지 않고 `review.md`에 작업 내용과 기존 맥락만 기록합니다.
npx skills add https://github.com/alty-oss/dev-design/tree/HEAD/skills/design-brief질문하기 전에 제품 문서, 경로, 컴포넌트, 기존 토큰 및 콘텐츠를 검토하십시오.
artifact contract를 사용하여 brief.md를 작성하십시오:
관찰된 사실, 사용자 요구사항 및 가정을 구분하십시오. 발명된 샘플 콘텐츠는 '샘플'로 표시하고, 비즈니스 주장, 사용 후기 또는 연구 결과를 발명하지 마십시오.
제품, 대상 사용자 또는 작업이 불분명한 경우, 사용자가 해당 결정을 위임하지 않았다면 구체적인 해석을 제안하고 확인을 요청하십시오. 결과를 바꾸는 것에 대해서만 질문하고, 한 번에 하나의 질문만 하십시오.
기존 제품의 경우, 유지해야 할 디자인 시스템과 제약 조건을 기록하십시오.
작은 조정의 경우, review.md에 작업 내용과 기존 맥락만 기록하고, 전체적인 탐색을 강요하지 마십시오.
This repo contains 4 individual skills — each has its own dedicated page.
Use when reviewing UI keyboard access, focus, accessible names, structure, contrast and motion behavior.
Use when establishing a distinctive visual direction for a new UI or an intentional redesign.
Use when delivering a UI change with its decisions, verification evidence and remaining limitations.
Use when mapping existing UI tokens/components or defining a coherent token and component contract for implementation.
ElevenLabs text-to-speech with mac-style say UX.
Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.
Capture and automate macOS UI with the Peekaboo CLI.
Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".
Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".