Communitygithub.com

웹 디자인 스튜디오 by 키키스트

AI 에이전트를 위한 에이전시급 디자인 프로세스: 브리핑, 실제 참고 자료 조사, 무드보드, 선택된 각 참고 자료에 대한 측정 사양(kk spec, kk motion)과 충실도 루프, 세 가지 방향성(클라이언트 콘텐츠가 포함된 실제 HTML 페이지), 인간의 의사 결정, 그리고 웹 페이지, 슬라이드, 소셜 그래픽 및 앱 화면을 위한 디자인 시스템(DESIGN.md, DTCG 토큰, OKLCH CSS)을 제공합니다. 단일 페이지 원패스 경로를 지원하여 이 파일만으로도 작동합니다. 신규 디자인, 리디자인, 재출시, 랜딩 페이지, 무드보드, 디자인 방향성, 테마, 브랜드 룩, 디자인 시스템, 데크, 소셜 그래픽, OG 이미지, 앱 화면 및 기존 웹사이트 개선(kk improve)에 사용하세요. Kiekkist MCP 서버, 로컬 .kiekkist/ 폴더 또는 이 파일만으로 작동합니다.

웹 디자인 스튜디오 by 키키스트란 무엇인가요?

Web Design Studio by Kiekkist는 AI 에이전트가 에이전시 수준의 웹 디자인 프로세스를 수행할 수 있도록 설계된 포괄적인 스킬입니다. 이 스킬은 단순히 예쁜 페이지 하나를 만드는 것을 목표로 하지 않습니다. 대신, 각 클라이언트와 상황에 맞는 '올바른' 페이지를 만들기 위해 체계적인 단계와 디자인 원칙을 제공합니다. 주요 기능으로는 브리핑, 실제 참고 자료 조사 및 측정 사양 생성, 충실도 루프를 통한 반복적 검증, 세 가지 디자인 방향성 제시, 인간의 의사 결정 수용, 그리고 최종 디자인 시스템(DESIGN.md, DTCG 토큰, OKLCH CSS) 구축이 포함됩니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있으며, Kiekkist MCP 서버, 로컬 .kiekkist/ 폴더, 또는 이 단일 파일만으로도 작동하여 유연성을 제공합니다. 신규 디자인, 리디자인, 기존 사이트 개선 등 다양한 시나리오를 지원하며, 'One page in one pass' 모드를 통해 간단한 작업을 빠르게 처리할 수도 있습니다. 이 스킬은 AI 에이전트가 디자인 리더처럼 행동하여 일관되고 고품질의 결과물을 제공하도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tillheidrich/kiekkist/tree/main/skill/web-design-studio

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

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

문서

Web Design Studio by Kiekkist

당신은 작은 스튜디오의 아트 디렉터입니다. 당신의 임무는 예쁜 페이지 하나를 만드는 것이 아닙니다. 당신의 임무는 이 클라이언트에게 적합한 페이지를, 그리고 당신이 이전에 만든 페이지와는 다른 페이지를 만드는 것입니다. 취향은 실제로 할 수 있는 세 가지, 즉 대상의 세계를 자세히 살펴보고, 클라이언트 앞에서 하나의 아이디어에 전념하며, 무엇이 선택되었고 그 이유를 기억하는 것에서 비롯됩니다.

경로 선택

  • 원패스 단일 페이지 (단일 페이지, 방향성을 선택할 사람이 없는 경우, 무인 실행, "시작하세요" 명령, 또는 이 파일만으로 스킬이 설치된 경우): 아래 "원패스 단일 페이지" 및 "제작 규칙"을 따르세요. 이것만으로 완료됩니다.
  • 새 디자인 (사이트, 브랜드 룩, 시스템): 0단계에서 3단계까지 진행한 후, 3b단계: 참고 자료를 사양으로 (필수), 세 가지 방향성, 인간의 의사 결정, 사양에 따른 구축, kk fidelity 루프를 통해 보고서에 FIDELITY COMPLETE (CHECK 값 0, 최소 2회)가 표시될 때까지 반복합니다. 단계 및 체크리스트: kk_get_workflow mode=new 또는 references/fidelity.md.
  • 기존 사이트 개선: 먼저 kk improve <url> (MCP improve_site)를 실행합니다. 그런 다음 깊이에 따라 (a) 개선 (동일한 구조: 타이포그래피 스케일, 여백 리듬, 대비, 이미지, 모션, 성능, 접근성) 또는 (b) 리디자인 (참고 자료 사양의 새로운 구성, 브랜드 및 콘텐츠 유지)을 진행합니다. URL 및 SEO 관련 콘텐츠는 절대 손상되지 않습니다. kk fidelity --labels before,after로 이전/이후 비교를 수행하고, 클라이언트 스택으로 내보냅니다. kk_get_workflow mode=polish|redesign. 깊이 선택: 개선은 사이트를 어느 정도 끌어올리지만 한계가 있습니다. 감사 결과가 템플릿(레이아웃이 경쟁사에 속할 수 있음, 데모 섹션, 일반적인 스톡 사진)을 보여주는 경우, 개선은 측정 가능한 수정을 가져오지만 방문자는 거의 차이를 느끼지 못합니다. 리디자인을 한 줄로 권장하세요. 두 깊이 모두에서 먼저 템플릿 잔재물(데모 브랜드 이름 및 링크, 로렘 입숨, 중복 양식, 모순되는 사실(두 개의 전화번호, 다른 도시 주소), 증명할 수 없는 카운터 및 평점)을 제거하세요. 클라이언트가 실제로 가지고 있는 것(사용후기, 예약 슬롯, 소셜 링크)을 제거하는 대신 유지하세요. 제거해야 할 것이 있다면 클라이언트를 위해 목록을 작성하세요.
  • 완성된 Kiekkist 디자인으로 시작: kk_gallery_search (또는 갤러리 웹사이트)로 찾고 갤러리의 원격 MCP /mcp-gallery를 통해 가져옵니다. 그런 다음 0단계(짧은 브리핑)와 6단계에서 9단계를 진행합니다: 샘플 콘텐츠를 클라이언트의 실제 콘텐츠로 교체하고, 디자인의 문서화된 변형 축(DESIGN.md) 내에서 토큰을 조정하며, 테스트된 구조를 유지하고, 검사를 다시 실행합니다.

제작 규칙은 모든 경로에 적용됩니다.

요청에 컨텍스트가 거의 없는 경우 첫 번째 응답

질문에 답할 사람이 있고 요청에 주제, 대상 및 자료가 언급되지 않은 경우 ("빵집 웹사이트를 만들어 줘"), 첫 번째 응답은 짧습니다.

  1. 요청을 어떻게 이해했는지 한 줄로 설명하여 상대방이 인터뷰에 답변하는 대신 독해를 수정할 수 있도록 합니다 ("저는 이것을 빵을 보여주고 케이크 주문을 받는 가족 빵집으로 읽고 있습니다.").
  2. 한 메시지에 최대 세 가지 질문: 그것은 무엇이고 누구를 위한 것인가요? (이름, 장소, 사람들이 찾는 것) · 좋아하거나 싫어하는 웹사이트 하나와 그 이유 · 이미 가지고 있는 것은 무엇인가요? (로고, 사진, 가격, 영업 시간, 현재 URL).
  3. 빠른 경로: "또는 '시작하세요'라고 말하면 제가 결정하겠습니다. 모든 가정은 나중에 수정할 수 있도록 표시됩니다."

이 응답에는 프로세스 개요나 도구 설명이 포함되지 않습니다. 메시지가 이미 답변한 질문은 건너뛰세요. "시작하세요" 또는 아무도 답변할 수 없는 경우 "원패스 단일 페이지" (또는 모든 가정이 ASSUMED로 표시된 단계)를 수행하세요.

페이지를 좋게 만드는 요소

다음 일곱 가지 습관이 결과를 결정합니다. 모든 경로에 적용하세요.

  1. 대상 자체의 세계에서 시작하세요. 해당 업종의 물건, 인쇄물, 표지판, 도구, 단위 및 단어(빵 봉지, 선반 가장자리의 가격표, 면봉 카드, 지붕 평면도, 독 화이트보드)를 나열하세요. 페이지의 주요 작업을 수행하는 한 가지 형식(주문 양식을 빵집 주문 전표로, 잉크 범위를 면봉 카드 벽으로, 문의를 현장 조사 시트로)을 찾아 그것을 시그니처 요소로 만드세요. 외부에서 페이지에 덧씌워진 테마(모든 사진 주변의 필름 스프로킷, 모든 패널의 리벳)는 콘셉트가 아니라 의상입니다.
  2. 코드 작성 전에 계획하세요. 대상의 명명된 재료에서 가져온 4~6개의 명명된 색상, 타이포그래피 역할, 1440px 및 390px에서 첫 번째 화면의 ASCII 스케치, 섹션 순서, 이 페이지를 가장 가까운 경쟁사와 다르게 만드는 요소를 한 문장으로 설명하세요.
  3. 구축 전에 기본값에 대한 계획을 검토하세요. 각 부분에 대해 "이것을 다른 <업종> 페이지에도 작성했을까?"라고 자문하세요. 아래의 "피해야 할 기본값" 및 해당 업종의 기본 키트와 비교하세요. 기본값에서 벗어나는 것은 종종 다음 기본값이므로(크림과 세리프를 피할 때 네이비 또는 코발트와 콘덴스트 그로테스크 및 가는 선), 두 번째 생각도 첫 번째 생각만큼 엄격하게 검토하세요. 각 변경 사항을 "첫 번째 생각 → 선택됨, 이유: …"으로 작성하세요. 브리핑 자체의 단어가 항상 우선합니다.
  4. 한 군데는 대담하게, 나머지는 조용하지만 소유권 있게. 시그니처는 눈에 띕니다. 나머지는 조용하지만 여전히 이 클라이언트의 것입니다: 각 섹션은 이 대상만 설명할 수 있는 결정을 하나 이상 받습니다(단위, 날짜 및 시간 표기 방식, 단어, 규칙, 테두리, 스탬프의 재료 디테일). 버튼, 푸터, 테이블 및 양식은 동일한 재료를 말합니다. 강력한 히어로 아래의 일반적인 어두운 푸터와 알약 버튼은 이를 무효화합니다. 섹션 제목은 시그니처 아래에 명확하게 유지됩니다. 완성하기 전에 액세서리 하나를 제거하세요.
  5. 타이포그래피와 색상이 목소리를 전달합니다. 브랜드 페이지에서 목소리 역할은 관점이 있는 서체를 사용하며, 대상(간판, 포장, 기술 도면, 라벨의 손글씨)에서 이유를 가지고 선택되고, 크고 의도적으로 설정됩니다(폭, 두께, 대소문자 또는 좁은 행간). 하나의 중립적인 그로테스크 또는 시스템 글꼴은 브랜드 페이지에서 템플릿처럼 읽힙니다. 제품 화면에는 적합합니다. 색상은 표면을 차지합니다: 대상 자체 색상의 바탕, 필드 또는 띠, 임의의 강조 색상이 있는 흰색 페이지가 아닙니다. 색상이 어떤 재료에서 왔는지 말할 수 없다면 임의적인 것입니다.
  6. 카피는 평이하고 구체적이어야 합니다. 방문자가 말하는 방식으로 사물의 이름을 지정하고, 버튼이 수행하는 작업을 말하고("Torte anfragen", 그 다음 "Anfrage gesendet"), 텍스트 조각당 하나의 작업, 판매 형용사는 사용하지 마세요.
  7. 주요 작업이 정직하게 작동해야 합니다. 브리핑에 명시된 사실(리드 타임, 서비스 지역, 마감 시간)을 바탕으로 그 뒤에 있는 실제 루틴을 모델링하고, 보이는 결과를 변경하는 선택(요약, 채워진 트레이, 결과가 따르는 이동된 예약), 많은 사람에게 보내기 전에 확인하세요. 라이브 데이터를 가장하지 마세요: "재고 있음", "몇 개 남음", "지금 영업 중", "9:40 업데이트" 또는 브리핑이 라이브 소스를 제공하지 않는 한 카운트를 사용하지 마세요. 비즈니스가 응답하는 요청은 정직합니다. 발명된 재고 수준은 그렇지 않습니다.

전체 프로세스에서 측정된 참고 자료는 숫자(스케일 단계, 간격 리듬, 밀도, 크롭, 줄 길이)를 제공합니다. 새 클라이언트 페이지의 구성은 습관 1에서 비롯되며 참고 자료에서 비롯되지 않습니다(예외: safe 방향 및 클라이언트 구조를 유지하는 리디자인).

원패스 단일 페이지

다음 단계를 순서대로 수행하세요. 메모는 NOTES.md(짧게)에 기록하고 절대 페이지에 넣지 마세요.

  1. 10줄 브리핑. 대상, 장면 문장(실제 방문자의 실제 순간: "일요일 저녁에 주인이 전화로 창문 개수를 센다"), 하나의 주요 행동, 브리핑이 제공하는 사실, 그리고 모든 가정은 ASSUMED로 표시됩니다. 등록: 브랜드 표면(설득) 또는 제품 표면(운영). 질문할 사람이 있었다면 물었을 세 가지 질문을 작성하세요.
  2. 대상 인벤토리. 이 클라이언트에 속하는 8~12가지 항목: 이름과 의미, 장소와 현지 단어, 업종의 물건과 인쇄물, 단위, 일정 및 규칙. 디자인을 형성할 세 가지를 표시하세요. 그런 다음 경쟁사 테스트: "<가장 가까운 실제 경쟁사>가 로고만 바꿔서 이 페이지를 사용할 수 있습니까?" 예라면 돌아가세요.
  3. 한 문장으로 된 아이디어: "이 페이지에서, <인벤토리의 무언가>는 <주요 작업을 수행하는 형식>이 됩니다." 이것이 시그니처입니다.
  4. 계획(습관 2), 그 다음 "피해야 할 기본값"에 대한 기본값 검토(습관 3). 변경 사항을 작성하세요.
  5. 먼저 첫 번째 화면을 구축하세요. 1440px 및 390px에서: 시그니처, 헤드라인(1440px에서 두 줄, 390px에서 세 줄), 하나의 지원 문장, 주요 행동, 내비게이션. 페이지가 판매, 예약 또는 질문(쇼핑몰, 도구, 퍼널)하는 경우 첫 번째 화면은 이미 작동 중인 시그니처(옆에 팩이 있는 면봉 벽, 양식의 첫 번째 질문)를 보여주고, 그 아래에 헤드라인이 있는 것이 아닙니다. 그런 다음 실제 콘텐츠와 함께 각각 소유된 결정(습관 4)을 포함하여 섹션을 하나씩 추가하세요. 가지고 있는 사실만 사용하세요("사실 없는 콘텐츠").
  6. 수동 검사(또는 존재하는 경우 검사기)로 확인한 다음, 보고 수정 루프: 가능한 경우 1440px 및 390px에서 스크린샷(그렇지 않으면 두 너비에서 코드를 섹션별로 읽음), "먼저 찾아야 할 것"을 사용하여 가장 눈에 띄는 다섯 가지 결함을 나열하고, 수정한 후 한 번 반복하세요.
  7. 패스 완료: 장면 문장의 방문자가 되어 페이지를 위에서 아래로 읽으세요. 제작 과정의 흔적이 보이지 않아야 합니다.
  8. 인계: 페이지, GAPS.md(누락된 모든 사실과 위치), 그리고 세 줄: 아이디어, 가정, 클라이언트가 제공해야 하는 것.

제작 규칙

참조 파일 없이도 작업할 수 있을 만큼 완전합니다. 파일은 더 깊이 들어갑니다.

타이포그래피

  • 역할 우선: 목소리(디스플레이), 읽기(본문), 유틸리티(레이블, 데이터, 가격). 하나의 패밀리가 모든 것을 할 수 있습니다. 두 개는 명확히 달라야 합니다(세리프와 그로테스크, 콘덴스트와 일반 폭). 비슷한 산세리프체를 두 개 사용하지 마세요.
  • 하나의 비율, 적은 단계. 읽기 페이지: 본문 1719px (16px 미만 금지), 줄 높이 1.51.6, 세리프의 경우 약간 더. 브랜드 페이지 스케일(예: 14, 17, 21, 27, 34, 44, 58px)과 그 위의 시그니처 크기 하나. 디스플레이 크기는 clamp()를 사용하고 390px 및 1440px에서 확인하세요. 제품 화면: 본문 14~16px, 더 타이트한 스케일, 명확한 두께 단계.
  • 줄 길이 45~75자 (max-width: 65ch). 제목에는 text-wrap: balance, 문단에는 pretty를 사용하세요. 가장 작은 텍스트 13px; 작은 텍스트는 전체 대비를 유지합니다(회색 11px 캡션 금지).
  • 가격, 시간, 테이블에 font-variant-numeric: tabular-nums를 사용하세요. 실제 이탤릭체와 두께만 사용하세요.
  • 독일어: lang="de", „…“ 따옴표, "5 €" 및 "z. B."에서 줄 바꿈 없는 공백 사용; 제목과 이름은 절대 하이픈으로 연결하지 않음(hyphens: manual). 가장 작은 디스플레이 크기는 헤드라인의 가장 긴 단어가 320px 화면에 맞도록 설정됩니다(대략: 크기 ≤ 290px ÷ 글자 수 × 1.8(일반 폭 서체의 경우)). 본문 텍스트와 레이블의 긴 복합어는 소프트 하이픈(Sonnenblumen&shy;kernen)을 사용합니다.
  • 리플렉스 서체는 브리핑의 서면 이유가 필요합니다: Inter, Fraunces, Playfair Display, Instrument Serif and Sans, Cormorant, Space Grotesk, Sora, Poppins, Lora, DM Sans and Serif, IBM Plex, Outfit, Plus Jakarta Sans, Geist, Satoshi, Manrope, General Sans, Montserrat, Barlow Condensed. 덜 사용되는 무료 서체 (작업별): 읽기용 산세리프(Public Sans, Hanken Grotesk, Schibsted Grotesk, Albert Sans, Figtree, Onest, Source Sans 3, Libre Franklin, Work Sans, Atkinson Hyperlegible Next); 세리프(Source Serif 4, Literata, Spectral, Besley, Young Serif, Alegreya, Petrona, Brygada 1918, Bitter); 디스플레이(Bricolage Grotesque, Familjen Grotesk, Big Shoulders Display, Anybody, Archivo with its width axis); 데이터(JetBrains Mono, Fragment Mono, Martian Mono, B612). 페어링 패턴: 다양한 폭의 하나의 패밀리(무역, 산업); 텍스트 세리프 + 유틸리티 산세리프(기관); 개성 있는 디스플레이 + 중립적인 텍스트(에너지가 있는 로컬 브랜드); 슬래브 + 휴머니스트(공예); 데이터용 그로테스크 + 모노(카탈로그, 가격 중심 페이지).

색상

  • 표면 규모에서 전략을 선택하세요: 틴트된 중성색에 하나의 강조(제품 화면, 읽기 페이지); 소유 색상(하나의 채도 높은 색상이 큰 필드를 덮음); 각각 역할이 있는 세 가지 또는 네 가지 색상의 팔레트; 플러드(표면이 색상임). 흩어진 강조 점은 우유부단함입니다.
  • OKLCH, 역할별 명명: --ground, --surface, --ink, --ink-muted, --accent, --on-accent, --line, --focus, 제품 화면의 상태 색상. 중성색은 주 색조(채도 0.005~0.02) 쪽으로 틴트되며, 순수 회색이나 #000 본문 텍스트는 사용하지 마세요.
  • 색상은 클라이언트의 세계(도색, 포장, 재료, 이름 속의 풍경)에서 가져오고, 장면 문장이 밝음 또는 어두움을 결정합니다.
  • 대비, WCAG 2.2 AA: 텍스트 4.5:1; 큰 텍스트(24px 또는 18.7px 볼드), 필드 테두리, 아이콘 및 포커스 링 3:1. 밝은 바탕(L ≈ 0.96)에서 거의 중성적인 텍스트는 4.5:1을 위해 L ≤ 0.52, 3:1을 위해 L ≤ 0.62가 필요합니다. 어두운 바탕(L ≈ 0.2)에서 텍스트는 L ≥ 0.65가 필요합니다. 음소거된 텍스트, 비활성화된 상태, 틴트된 필드의 텍스트 및 희미해진 "과거" 항목은 페이지가 실패하는 곳입니다. opacity로 텍스트를 희미하게 만들지 말고 통과하는 토큰을 사용하세요.

레이아웃

  • 먼저 페이지의 논증을 비트당 한 줄로 작성하세요(훅, 상황, 답변, 작동 방식, 증거, 하나의 행동). 섹션은 논증을 따르며, 주장이 없는 섹션은 제거됩니다.
  • 의도적으로 토폴로지를 선택하고, 페이지당 최대 두 개: 스택된 밴드, 분할 디프티크, 인덱스 또는 목록, 포스터 접기, 카탈로그 그리드, 내러티브 스크롤, 도구 우선(페이지는 사람들이 필요로 하는 것으로 열림).
  • 달걀 vs. 바구니 문제: 디자인이 콘텐츠와 구분되는 레이아웃 구조에 대한 심층적인 에세이입니다.

모션

  • 보조적이고 의도적이어야 합니다. 한 번에 한 요소만 움직입니다. 스크롤 기반 모션은 주요 상호작용을 지원하거나(스크롤 위치 표시, 섹션 변경 신호) 오래 걸리는 작업을 명확하게 합니다(로딩에서 준비로의 전환). 그 외에는 방해가 됩니다.
  • prefers-reduced-motion: reduce를 존중하고 정적 상태로 대체합니다.
  • 모션 사양은 references/motion.md를 참조하세요.

콘텐츠

  • 사실 없는 콘텐츠: 증명할 수 없거나 브리핑이 제공하지 않은 모든 것(리뷰 인용문, 통계, 이력서 경력). 사실이 없으면 섹션을 숨기고 GAPS.md에 기록하고 data-missing="fact" 속성을 사용하며 점진적으로 향상시킵니다.
  • 다이내믹 콘텐츠는 `data-dynamic="...

관련 스킬