Communitygithub.com

디자인 디테일

디자인 스킬. 디자이너와 함께, Design Details MCP의 실제 참고 섹션을 사용하여 독창적이고 야심찬 웹사이트 페이지를 디자인하고 구축합니다. 디자이너가 새로운 랜딩 페이지, 홈페이지, 마케팅 페이지 또는 이에 상당하는 리디자인을 요청할 때 사용하세요. 작은 스타일 수정, 앱 플로우 또는 웹사이트 복사에는 사용하지 마세요.

디자인 디테일란 무엇인가요?

디자인 디테일(Design Details) 스킬은 디자이너가 갤러리에 등재될 만한 수준의 독창적인 웹사이트 페이지를 제작할 수 있도록 안내하는 종합적인 프레임워크입니다. 이 스킬은 실제 수상 경력에 빛나는 웹사이트의 섹션을 제공하는 Design Details MCP(모델 컨텍스트 프로토콜)에 의존하여 참고 자료 없이 추측하는 대신 실제 예시를 기반으로 작업하도록 합니다. 사용자는 '대담함(Bold is not big)'과 같은 다양한 표현 방식 중에서 선택하고, 참고 자료를 수집하며, 두 가지 방향성을 제시하고, 모든 섹션을 계획하고, 최종 결과물을 확인하는 단계를 따릅니다. 이 스킬은 Claude Code, Cursor, Codex 등 MCP와 파일 시스템에 접근할 수 있는 모든 AI 에이전트 플랫폼에서 사용할 수 있습니다. 각 단계는 디자이너의 승인을 기다리도록 설계되어, 디자이너가 창의적인 방향을 설정하고 최종 결정을 내리는 '인-더-루프(in-the-loop)' 워크플로우를 보장합니다.

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

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

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

문서

디자인 디테일은(는) 무엇을 하나요?

목표는 깔끔한 템플릿이 아닌 디자인 갤러리에 소개될 만한 페이지를 만드는 것입니다. 다음 세 가지가 함께 이루어져야 합니다:

  1. 실제 참고 자료. Design Details MCP는 실제 수상 경력에 빛나는 웹사이트의 섹션을 보유하고 있으며, 각각 스크린샷, 측정된 사실 및 빌더 노트가 포함되어 있습니다. 상상하지 말고 실제로 살펴보세요.
  2. 장인 정신을 담은 야망. 참고 자료가 제공하는 가장 대담한 아이디어를 가져와 읽기 쉽고, 접근성이 뛰어나며, 빠르게 제대로 작동하도록 만드세요.
  3. 디자이너. 디자이너가 야망을 설정하고, 방향을 선택하며, 결과를 승인합니다. 방향 제시 후, 페이지 작성 후, 그리고 디자이너가 섹션을 "기본"이라고 표시할 때마다 멈추고 기다리세요.

깔끔하고, 정확하며, 잊혀지는 페이지는 안전한 결과가 아니라 실패입니다.

대담함은 큼이 아니다

거대한 글자는 대담함의 한 방법이지만, 가장 과하게 사용되는 방법이기도 합니다. 모두 거대한 단어, 몇 줄의 작은 글씨, 하나의 버튼으로 끝나는 페이지는 비즈니스 종류와 상관없이 비슷해 보입니다. 대담함의 종류:

  • 타이포그래피 주도: 단어의 크기와 배치가 아이디어입니다.
  • 이미지 주도: 하나의 사진이나 영상이 화면을 장악합니다. 글자는 절제되고 세심하게 배치됩니다.
  • 제품 주도: 실제 제품이 크게 작동하는 히어로입니다.
  • 오브제 주도: 하나의 사물이나 일러스트레이션이 아이디어를 전달합니다.
  • 구조 주도: 특이한 그리드, 목록, 시퀀스 또는 인터랙션이 아이디어입니다.
  • 조용함: 작은 글씨, 넓은 공간, 하나의 정확한 디테일; 절제가 핵심입니다.

무엇이 가장 크게 보일지가 아니라, 브리프와 자료에 따라 선택하세요. 글자는 아이디어가 필요한 만큼 커야 하지, 공간에 맞추기 위해 큰 것이 아닙니다.

1단계 — 브리프

먼저 프로젝트를 읽으세요: 브랜드, 글꼴, 색상, 토큰, DESIGN.md, 컴포넌트, 스택. 기존에 있는 것은 유지하세요.

한 번에 하나의 메시지로, 최대 다섯 가지 질문을 하고, 각 질문에는 디자이너가 "계속 진행"이라고 답할 수 있도록 제안된 답변을 함께 제시하세요:

  • 대상과 내용: 대상 고객, 제공 사항, 방문자가 취해야 할 하나의 행동.
  • 자료: 실제로 있는 것(사진, 제품, 로고, 카피), 무료 라이선스 대체물을 사용할 수 있는 것, 아직 존재하지 않는 것.
  • 느낌: 날카로움이 있는 한두 단어. "깔끔하고 현대적인"은 느낌이 아닙니다.
  • 야망: 안전함(익숙하고 조용함), 독창적(화면당 하나의 기억에 남는 움직임, 기본값) 또는 극단적(갤러리 수준: 일반 사이트에서는 시도하지 않을 구성).
  • 범위: 어떤 섹션인지, 그리고 먼저 방향성을 볼 것인지 여부(기본값: 예).

무언가 생략된 경우, 가정을 한 줄로 명시하고 계속 진행하세요. 사실, 숫자, 고객, 사용 후기, 수상 경력 또는 연락처 정보를 절대 만들어내지 마세요.

2단계 — 가장 대담한 참고 자료 찾기

MCP가 연결되어 있지 않으면, 그 사실을 말하고, https://designdetails.io/api/mcp를 추가하는 방법을 설명한 후, 참고 자료 없이 계속할지 물어보세요. MCP 없이는 참고 자료에 기반한 선택이라고 주장하지 마세요.

MCP가 연결되어 있으면, MCP 가이드를 따르세요. 두 가지 방법으로 검색하세요:

  1. 움직임을 위해. 모든 업종에서 구성(composition)을 검색하세요. 독창적이고 극단적인 야망 수준에서는 이 검색이 먼저 이루어집니다. 은행도 패션 브랜드에서 아이디어를 빌릴 수 있습니다. 이 브리프에서 직접 검색어를 작성하세요: 이 비즈니스만이 가진 것(오브제, 순간, 재료, 고객의 습관)에서 시작하여, 화면에서 보게 될 것을 설명하는 방식으로 그 주변에 구축된 레이아웃을 설명하세요. 이 스킬이나 이전 프로젝트에서 복사한 문구를 절대 보내지 마세요. 같은 단어는 같은 참고 자료를 반환하고 모든 페이지가 결국 비슷해 보이게 됩니다.
  2. 작업을 위해. create_page_recipe를 브리프 및 slots와 함께 사용하여 구조적 적합성이 필요한 섹션(가격, 예약, 팀)을 다루세요.

네트를 넓게 치세요. 검색당 20개의 결과(limit: 20)를 요청하고, 선택하기 전에 상위 세 개 이상을 살펴보세요. 페이지당 각 웹사이트를 최대 한 번만 사용하세요. 몇몇 인기 있는 히어로는 많은 검색어와 일치합니다. 다른 모든 참고 자료보다 이 브리프에 더 적합한 경우에만 하나를 사용하고, 다른 어떤 것을 고려했는지도 말하세요.

실제 이미지를 보세요. 텍스트, 링크, 점수는 보는 것이 아닙니다. 각 강력한 후보에 대해, 일반적인 사이트가 하지 않을 가장 대담한 움직임을 한 줄로 이름을 지정하세요. 실제로 구축할 참고 자료에 대해 get_section_build_blueprint를 가져오세요. 측정된 글자 크기, 간격 및 배치가 움직임을 작동하게 만듭니다.

구축할 각 참고 자료에 대해, 이미지와 청사진(레이아웃, 구조, 측정값, 미디어 위치)에서 **구성 연구(composition study)**를 작성하세요. 빌더 노트는 배치보다는 재료를 설명하는 경우가 많기 때문입니다:

  • 헤드라인이 어디에 있는지(상단, 중간 또는 하단, 왼쪽, 중앙 또는 오른쪽), 몇 줄이고 너비는 얼마인지;
  • 설명과 버튼이 어디에 있는지, 얼마나 짧은지;
  • 이미지가 화면의 얼마나 많은 부분을 차지하고, 어디에서 커질 여지가 있는지;
  • 비어 있는 부분이 어디인지.

지정된 공백을 채우기 위해서만 다시 검색하세요. 결정을 내리기 전에 움직임을 위해 적어도 여러 번의 검색을 사용하세요.

3단계 — 두 가지 방향, 그리고 멈춤

종류가 다른 두 가지 방향을 만드세요: 위 목록에서 서로 다른 두 가지 대담함 유형으로, 다른 모양을 가집니다. 최대 하나만 타이포그래피 주도일 수 있습니다. 독창적이거나 극단적인 야망 수준에서는, 각 방향은 하나의 참고 자료에서 가장 대담한 움직임을 중심으로 구축되며, 그 움직임은 그대로 유지됩니다. 해당 움직임을 한 줄로 이름을 지정하세요.

각 방향은 **룩(look)**과 **레이아웃(layout)**을 가지며, 별도로 선택됩니다:

  • 룩: 하나의 참고 웹사이트 전체 디자인에서 get_website_design으로 가져온 표면 시스템(타입 페어링, 팔레트, 종이 또는 배경, 사진 처리 방식, 모서리 및 규칙).
  • 레이아웃: 움직임을 유지하는 섹션 참고 자료에서 가져온 구성. 둘은 다른 웹사이트에서 올 수 있습니다.

각 방향에 대해 먼저 짧은 계획을 작성하세요: 참고 자료(ID 및 링크), 대담함의 종류, 한 문장으로 된 아이디어, 유지하는 움직임, 룩과 그 출처, 이 비즈니스를 위해 변경되는 사항, 타입 및 팔레트(4~6가지 색상), 히어로 이미지 사용 방식, 방문자가 처음, 두 번째, 세 번째로 읽는 내용.

그런 다음 세 가지 확인:

  • 템플릿 확인: 이 카테고리의 일반적인 사이트가 이렇게 보일까요? 그렇다면 특정 부분을 더 밀어붙이세요.
  • 갤러리 확인: Design Details가 이 오프닝 화면을 자체 라이브러리에 넣을까요? 그렇지 않다면 보여줄 준비가 되지 않은 것입니다.
  • 동일성 확인: 두 연구를 나란히 놓고, 이전에 이 스킬로 만든 마지막 페이지(있는 경우)와 함께 놓으세요. 그중 두 개가 형태(거대한 단어, 몇 줄의 작은 글씨, 하나의 버튼)를 공유한다면, 하나를 변경하세요.

각 방향의 오프닝 화면에 대한 빠른 시각적 연구를 만들고 참고 이미지 옆에 움직임 이름과 함께 보여주세요. 제안: A, B 또는 둘 다 아님.

멈추고 디자이너를 기다리세요. 디자이너가 선택하기 전에 전체 페이지를 구축하지 마세요.

4단계 — 모든 섹션 계획

히어로뿐만 아니라 모든 섹션이 디자인될 때 페이지는 좋아집니다. 구축하기 전에 섹션 계획을 작성하세요. 각 섹션에 대해:

  • 임무: 전달해야 할 한 가지.
  • 레이아웃 아이디어: 검사된 MCP 참고 자료에서 가져온(이 섹션의 콘텐츠에서 작성된 움직임 검색, 2단계 참조), 구성 연구와 함께 제공되는 고유한 아이디어 하나. 의미하는 아이디어의 종류: 핵심 단어가 빛나는 문장 하나, 또는 선으로 나뉘고 주장이 적힌 한 장의 사진. 이러한 종류를 보여줍니다. 작성된 대로 검색하지 마세요.
  • 무게: 조용함 또는 풍부함.
  • 스크롤: 스크롤을 고정(고정, 단계별 진행)하거나 그렇지 않음.

그런 다음 계획을 확인하세요:

  • 기본 섹션 없음. 동일한 카드 위에 헤딩, 텍스트 옆에 사진, 버튼이 있는 헤딩, 숫자 행, 로고 스트립: 각각은 "기본" 버전입니다. 레이아웃 아이디어로 교체하세요.
  • 리듬. 인접한 두 섹션은 형태를 공유하지 않습니다. 조용한 섹션 뒤에는 풍부한 섹션이 옵니다.
  • 차분한 표면. 하나의 배경 패밀리, 하나의 강조색, 두 개의 서체, 섹션 간 동일한 간격. 구조는 대담하고 표면은 그렇지 않습니다.
  • 모션 상한선. 최대 세 개의 섹션만 스크롤을 고정합니다.
  • 실제 제품 우선. 비즈니스에 제품이 있는 경우, 실제 화면과 실제 데이터가 가장 강력한 이미지이며, 사진은 보조적입니다. 작동하는 앱(URL 또는 폴더)이 있으면 실행하고 실제 화면을 스크린샷하세요. 아무것도 없을 때만 인터페이스를 그리고 샘플로 표시하세요.

디자이너가 섹션을 "기본"이라고 표시하면, 해당 섹션만 리디자인하세요: 세 가지 옵션을 제공하고, 그중 어느 것도 안전하지 않으며, 페이지의 나머지 부분은 유지하세요.

5단계 — 구축

프로젝트 스택에서 선택한 방향을 구축하세요. 구축하기 전에 장인 정신과 AI 특성을 읽고, 페이지가 움직일 때 모션을 읽으세요.

  • 먼저 히어로를 구축하고 렌더링한 다음, 참고 자료 옆에 놓으세요. 구성 연구를 하나씩 확인하세요: 헤드라인 위치, 줄 수, 이미지 비율, 빈 공간. 가장 대담한 움직임은 유지되어야 합니다. 익숙한 레이아웃으로 약화되었다면 다시 구축하세요. 카피가 배치에 비해 너무 길면 배치를 줄이지 말고 카피를 줄이세요.
  • 야망은 접근성을 희생하지 않습니다. 대담한 움직임이 문제를 만드는 경우(복잡한 사진 위의 텍스트, 매우 큰 글자, 빡빡한 크롭), 기술로 해결하세요: 스크림, 더 차분한 크롭, 더 크거나 두꺼운 글자, 텍스트 뒤의 단색 띠. 표준 레이아웃으로 후퇴하지 마세요.
  • 페이지 전반에 걸친 하나의 디자인 언어: 동일한 글꼴, 크기, 간격, 표면. 각 섹션은 자체 룩이 아닌 참고 자료에서 레이아웃을 빌립니다.
  • 텍스트 예산(엄격), 방향의 종류에 따라 설정됨:
    • 타이포그래피 주도 또는 오브제 주도: 최대 6단어의 헤드라인 하나, 최대 12단어의 한 줄, 버튼 하나.
    • 이미지, 제품, 구조 주도 또는 조용함: 최대 10단어의 헤드라인 하나, 최대 두 개의 짧은 문장(약 30단어), 채워진 버튼 하나와 최대 하나의 텍스트 링크.
    • 항상: 헤드라인 위에 태그라인이나 레이블 없음, 두 번째 진술 없음. 섹션 헤딩은 최대 6단어; 항목은 이름이며, 필수적인 경우에만 최대 한 줄의 짧은 줄. 의심스러우면 삭제하세요.
  • 타입 예산(엄격): 거의 모든 것에 하나의 패밀리; 명확한 역할을 위한 두 번째 패밀리만; 절대 두 개를 넘지 않음. 화면당 최대 세 가지 크기. 가장 큰 크기는 아이디어에 의해 설정됩니다: 조용하거나 이미지 주도 페이지에는 포스터 헤드라인이 필요하지 않습니다.
  • 실제적이고 구체적인 카피: 짧고 자신감 있게. 실제 또는 크레딧이 있는 대체 자료; 아무것도 없는 곳에서만 정직한 플레이스홀더.
  • 브리프가 참고 자료를 이기고, 참고 자료가 습관을 이깁니다.

6단계 — 확인, 그리고 보여주기

  1. 1440 및 390 너비로 렌더링하세요. 스크린샷을 살펴보세요.
  2. 이 스킬의 폴더에서 페이지 체커를 실행하세요: node scripts/check-page.mjs <page file or URL>. 모든 **실패(fail)**를 수정하고, 모든 **경고(warn)**를 수정하거나 설명하세요. 스크립트가 볼 수 있는 것(헤딩 위의 레이블, 강조 단어, 타입 및 텍스트 예산, 대비, 오버플로, 나란히 있는 채워진 버튼)을 확인합니다. 디자인을 판단하지는 않습니다.
  3. 리뷰를 살펴보세요: 가장 대담한 움직임, 갤러리 확인, 장인 정신 및 특성.
  4. 디자이너 라운드. 디자이너 리뷰를 실행하세요. 이상적으로는 빌드에 대한 기억이 없는 새로운 헬퍼가: 승인된 섹션, 절반 완료, 약함, 기본 각 섹션에 대한 평결, 승인되지 않은 각 섹션에 대한 하나의 문제점과 하나의 움직임, 그런 다음 전체 페이지(이웃, 리듬, 특성, 작은 텍스트, 겹침). 수정, 재렌더링, 재검토. 승인된 섹션은 보호하세요. 최대 3라운드.
  5. 하나의 평결로 마무리하세요: 배송(ship), 수정(fix) 또는 재구축(rebuild).

참고 자료 옆에 있는 스크린샷과 각 섹션이 유지한 움직임과 출처, 확인된 사항과 확인되지 않은 사항, 플레이스홀더가 포함된 라운드 기록(이전 및 이후 프레임 포함)을 디자이너에게 보여주세요. 멈추고 디자이너의 승인을 기다리세요. 디자이너의 "아니오"는 진정한 답변입니다.

정직함

  • 어떤 선택이 참고 자료에서 비롯되었고 어떤 것이 자신의 것인지 말하세요.
  • 빌더 노트는 편집적 해석이며, 종종 AI로 작성됩니다. 이미지를 노트보다 신뢰하세요.
  • 정지 이미지는 움직임이나 모바일 동작을 보여주지 않습니다. 그렇다고 주장하지 마세요.
  • 렌더링된 것을 보지 않고 확인된 것으로 보고하지 마세요.
  • 페이지가 더 잘 전환되거나 다른 워크플로우를 능가한다고 주장하지 마세요.

이 스킬은 여러 오픈 소스 디자인 스킬에서 아이디어를 빌렸습니다. 크레딧을 참조하세요.

관련 스킬