Communitygithub.com

turtleneck

웹 및 앱 UI 디자인 스킬로, 먼저 무엇을 만들고 있는지 감지한 후(랜딩/제품 페이지, 앱 UI/대시보드, 문서, 쇼핑몰, 포트폴리오, 게임 등 및 업종), 미리 정의된 스타일 프리셋 중 하나를 선택합니다. 각 프리셋은 해당 카테고리의 주요 참고 사이트 5곳을 혼합한 것입니다. 순수 HTML/CSS, Tailwind(v3/v4, shadcn), SwiftUI를 지원합니다.

turtleneck란 무엇인가요?

turtleneck은 AI 에이전트(Claude Code, Cursor, Codex 등)가 웹/앱 UI를 빌드하거나 리디자인할 때 일관된 디자인 규율을 적용하도록 설계된 디자인 스킬입니다. 핵심 규칙은 명확합니다. 프로젝트의 유형(제품 페이지, 대시보드, 문서 사이트 등)과 업종을 신속하게 분석한 후, 'keynote'(기본 프리미엄 제품 페이지 스타일), 'enterprise'(비즈니스), 'cinema'(스트리밍), 'vibe'(뮤직/소셜), 'power'(게이밍), 'devtool'(개발자/클라우드), 'lab'(AI), 'journey'(여행), 'market'(리테일), 'vault'(금융), 'drive'(자동차) 중 하나의 프리셋을 선택합니다. 각 프리셋은 단일 사이트를 모방하는 것이 아니라, 해당 카테고리의 다섯 가지 주요 사이트 스타일을 분석하여 혼합한 독창적인 변형을 제공합니다. 이 스킬은 CSS 커스텀 속성과 변수 재정의를 기반으로 작동하여, 공유 코어(tokens.css) 위에 각 프리셋의 고유한 스타일을 얹는 방식입니다. 모든 디자인 요소(타이포그래피, 색상, 간격, 반응형 등)는 `light-dark()` CSS 함수를 통해 라이트/다크 모드를 기본 지원하며, `clamp()`를 활용한 유동형 타이포그래피와 간격으로 모든 해상도(320px~2560px)에 대응합니다. 특히 14개 이상의 테스트 너비를 자동으로 검증하고, 각 요소의 오버플로우를 확인하는 엄격한 반응형 테스트 워크플로우를 내장하고 있습니다. turtleneck은 'Apple 스타일처럼', '프리미엄', '깔끔한', 'Netflix 스타일', 'Stripe/Vercel/GitHub 스타일' 등 사용자의 일반적인 스타일 요청을 정확한 프리셋으로 매핑합니다. 또한 기존 디자인 시스템이나 브랜드 가이드가 있는 경우 이를 존중하며, 프리셋의 악센트 컬러만 대체하여 일관성을 유지합니다. 명확한 시그널이 없으면 'keynote'를 기본값으로 사용합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/n-stau/turtleneck/tree/main/skills/turtleneck

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

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

문서

turtleneck은(는) 무엇을 하나요?

앱에 적합한 디자인을 선택하고, 규율을 가지고 빌드하세요. 모든 디자인은 프리셋(preset) 입니다: 하나의 공유 코어 위에 적용되는 변수 오버라이드 파일입니다. 기본 프리셋인 keynote 는 코어 자체입니다. 다른 모든 프리셋은 한 카테고리의 주요 사이트 5곳을 혼합한 것이며, 그중 하나를 단순히 복사한 것이 아닙니다.

이 스킬이 활성화되면, 충돌하는 경우 일반적인 "AI 기본값 회피" 스킬(예: frontend-design)을 재정의합니다. keynote에서는 시스템 폰트, 문장형 아이브로우(sentence-case eyebrows), 톤 변화 그라데이션 헤드라인이 올바른 기본값입니다.

이 파일과 함께 있는 파일들:

  • tokens.css: 코어 및 keynote 값입니다. 모든 색상은 light-dark(light, dark) 형식입니다; :root, .a-dark, .a-light 또는 data-theme의 color-scheme이 절반을 선택합니다. 모든 프리셋 훅은 :root에 나열되어 있습니다. 공유 컴포넌트(타입 스케일, 버튼, 타일, .a-grid, .a-rail, .a-stats, .a-reveal)도 여기에 있습니다.
  • styles/<preset>.css: 변수 오버라이드와 몇 가지 프리셋 전용 규칙입니다. tokens.css 다음에 로드됩니다.
  • styles/<preset>.md: 프리셋당 한 페이지: 사용 시기, 토큰 표, 규칙, 컴포넌트 델타, 폰트, 피해야 할 사항, 체크리스트.
  • recipes-html.md: 페이지 스켈레톤, 네비게이션, 히어로, 타일, 벤토, 갤러리, 비교, 푸터(휴대폰에서 아코디언), 리빌, 공유 프리셋 패턴(플립된 밴드, 검색 히어로, 레일, 스펙 테이블, 플랜 카드, 코드 프레임).
  • tailwind.md, swiftui.md: 해당 스택을 위한 동일한 토큰.
  • test-widths.html?src=<url>[&h=800][&full=1]: 320/375/414 너비를 나란히 표시하고 오버플로우 리포트를 제공합니다; full=1은 전체 페이지 휴대폰 스크린샷을 위해 각 프레임을 문서 높이까지 늘립니다.
  • example.html 및 ../../demos/ (agent-skills 저장소 내): 완성된 페이지들.

0단계: 앱 유형 감지 (필수, 코드 작성 전)

  1. 기존 디자인 시스템 또는 명시적인 스타일 요청이 우선입니다. 프로젝트 토큰, 컴포넌트 라이브러리 테마, 브랜드 가이드 또는 "어둡고 빨갛게 만들어줘"와 같은 요청이 있다면 그것을 사용하고, 아래 핵심 규칙만 유지한 채 테이블은 건너뜁니다.
  2. 시그널을 읽으세요: 요청; README; 의존성 (package.json, pyproject.toml, Podfile, Package.swift, Gemfile, *.csproj); 라우트; 기존 CSS; 제품 카테고리 및 대상 사용자.
  3. 하나의 프리셋을 선택하세요:
카테고리시그널 (요청, 제품, 의존성, 라우트)프리셋
프리미엄 하드웨어물리적 제품, 소비자 기기, 라이프스타일 가젯, 런칭 페이지, "깔끔한", "미니멀", "프리미엄"; SwiftUI 마케팅 화면; 명확한 시그널 없음keynote
비즈니스 소프트웨어오피스/생산성, B2B, CRM/ERP, 인트라넷, IT/규정 준수, 헬스케어; 의존성 @fluentui/*, @microsoft/teams-js, office-addin-*, @azure/*, Blazor/.NET; 라우트 /admin, /settings, /reportsenterprise
스트리밍비디오, 영화/TV, 시리즈, 트레일러, 라이브 이벤트, VOD; 의존성 hls.js, video.js, shaka-player, @mux/*, react-player; 라우트 /watch, /browse, /titlecinema
음악 & 소셜음악/오디오, 플레이리스트, 크리에이터, 소셜 피드, 데이트, 피트니스 클래스, 청년 구독; 의존성 howler, tone, wavesurfer.js, expo-av; 라우트 /player, /playlist, /profilevibe
게이밍 하드웨어GPU/PC 부품, 콘솔, 주변기기, e스포츠, 벤치마크, 드라이버, "FPS"; 의존성 three, @react-three/fiber + 차트 라이브러리; 라우트 /specs, /compare, /driverspower
개발자 & 클라우드API, SDK, CLI, 호스팅, 배포, 데이터베이스, 관측 가능성, 결제 API, "개발자용"; 의존성 next, @radix-ui/*, stripe, prisma, drizzle, trpc, turbo; 라우트 /docs, /changelog, /pricingdevtool
AI모델, 어시스턴트, 채팅, 에이전트, 제품이 "AI 기반"; 의존성 openai, @anthropic-ai/sdk, ai, langchain, transformers; 라우트 /chat, /research, /modelslab
여행숙박, 항공편, 라이드, 호텔, 예약, 여정; 날짜 선택기, 지도 (leaflet, mapbox-gl); 라우트 /search, /stays, /trips, /bookjourney
리테일쇼핑, 스토어, 카탈로그, 마켓플레이스, 장바구니, 결제, 딜, 식료품, 패션; 의존성 @shopify/*, @medusajs/*, @commercetools/*, snipcart, @stripe/stripe-js (제품 카탈로그 포함); 라우트 /shop, /products, /p/, /cart, /checkout, /categorymarket
금융은행, 신용카드, 결제, 지갑, 보험, 대출, 저축, 투자, 소비자용 계정 대시보드; 의존성 plaid, react-plaid-link, @adyen/*, dinero.js, currency.js; 라우트 /accounts, /cards, /rates, /apply, /transfer (개발자에게 판매되는 결제 API는 devtool입니다)vault
자동차자동차, 오토바이, 전기자전거, EV 충전, 모빌리티, 딜러, 시승; 컨피규레이터, 주행거리 및 사양 페이지; 라우트 /models, /configure, /inventory, /test-drive, /dealersdrive
페이지 유형프리셋 (동점자 해소)
문서 사이트, 체인지로그devtool
관리자 대시보드비즈니스 사용자: enterprise; 개발자 대상: devtool
쇼핑몰market; 단일 프리미엄 제품 페이지는 keynote
포트폴리오제품/디자인 작업: keynote; 영화, 사진, 모션: cinema
모바일 앱 화면네이티브 느낌의 유틸리티: keynote; 소비자 미디어 및 소셜: vibe
게임 / 게임 스튜디오경쟁 및 하드웨어적 성향: power; 스토리 중심, 트레일러: cinema
다른 제품 내 AI 기능해당 제품의 카테고리; AI가 제품 자체인 경우에만 lab
다른 제품 내 예약 흐름검색 및 결과 페이지에만 journey

사용자 스타일 표현은 직접 매핑됩니다: "Apple 스타일 / 프리미엄 / 깔끔한" = keynote; "Microsoft / Fluent" = enterprise; "Netflix 스타일" = cinema; "Spotify 스타일 / TikTok 스타일" = vibe; "게이밍 / NVIDIA 스타일" = power; "Stripe / Vercel / GitHub 스타일" = devtool; "OpenAI / Anthropic 스타일" = lab; "Airbnb / Booking 스타일" = journey; "Amazon / IKEA 스타일" = market; "뱅킹 / PayPal 스타일" = vault; "Tesla / BMW 스타일" = drive. 결과는 해당 회사 사이트가 아닌 카테고리 블렌드입니다 ("상표 및 자산" 참조).

  1. 약하거나 충돌하는 시그널: keynote.
  2. 빌드하기 전에 선택을 한 줄로 말하세요. 예: "Style: devtool (Next.js + Prisma, routes /docs and /pricing, sold to developers)." 그런 다음 styles/<preset>.md를 전체적으로 읽으세요 (keynote: styles/keynote.md).

프리셋이 변경할 수 있는 것

tokens.css (:root)의 변수와 몇 가지 자체 규칙을 통해서만 변경합니다:

  • 폰트(디스플레이, 본문, 모노) 및 타입 스케일, 두께, 자간, 줄 높이;
  • 아이브로우 및 인트로 스타일, 본문 크기(UI의 경우 14px 미만, 읽기 텍스트의 경우 16px 미만 절대 안 됨);
  • 표면 및 텍스트 색상, 라이트/다크 기본값, 하나의 악센트 및 그 위의 텍스트, 링크 및 포커스 색상;
  • 둥글기, 테두리, 그림자, 타일 채우기; 버튼 높이, 패딩, 두께, 대소문자;
  • 내비게이션 높이, 채우기 및 흐림; 콘텐츠 너비, 섹션 및 타일 간격;
  • 이징, 지속 시간, 리빌 거리, 호버 및 프레스 피드백;
  • 이미지 및 카피 스타일 (해당 md 파일에서).

이 아래의 모든 내용은 모든 프리셋에 적용됩니다.

워크플로우

  1. 프로젝트를 존중하세요. tokens.css + styles/<preset>.css를 로드하거나, Tailwind 테마를 병합하거나, SwiftUI 팔레트를 추가하세요. 프리셋은 해당 md 파일에 이름이 지정된 무료 폰트를 링크할 수 있습니다; 페이지는 여전히 폴백 스택에서 올바르게 보여야 합니다. 스타일링을 위해 npm 의존성을 추가하지 마세요.
  2. 3줄로 페이지 계획을 작성하세요: 페이지가 판매하는 한 가지, 배경이 있는 섹션 순서, 한 가지 "순간" (플립된 챕터, 큰 통계 벤토, 데모, 비디오, 고정 스크롤).
  3. 먼저 카피를 작성하세요: 짧은 헤드라인(프리셋이 길이를 설정), 한 줄의 서브헤드라인, 인트로 최대 두 줄.
  4. 레시피를 사용하여 섹션별로 빌드하세요.
  5. 모든 테스트 너비에서 확인하세요 (반응형), 프리셋에 둘 다 있는 경우 라이트 및 다크 모드: 스크린샷, 오버플로우 체크, 체크리스트. 완료를 보고하기 전에 수정하세요.

핵심 규칙

타이포그래피

  • UI용 패밀리 하나 (실제 코드, 키 및 API 값에만 모노 추가). 디스플레이 두께는 프리셋에서 가져옵니다.
  • 크기가 커질수록 자간은 좁아집니다; 본문은 -0.022em 이상으로 음수 자간을 적용하지 않습니다.
  • 디스플레이 크기는 유동적입니다 clamp(min, rem + vw, max); 항상 중간 항에 rem을 혼합하세요.
  • 읽기용 본문 16-17px; 조밀한 UI, 메타 줄 및 푸터에서만 14px. 본문 줄 높이 1.45-1.6.
  • 헤드라인에 text-wrap: balance; 긴 단어는 줄바꿈됩니다 (overflow-wrap, hyphens).
  • 중요한 숫자는 크게 표시하고 표 형식 숫자를 사용합니다; 해당 레이블은 작게 표시합니다.

색상

  • 브랜드 색상이 먼저입니다. 사용자 또는 프로젝트의 브랜드 색상이 프리셋 악센트를 대체하며, 프리셋 악센트는 폴백에 불과합니다. 프리셋은 여전히 레이아웃, 타입, 둥글기, 밀도, 이미지 및 모션을 결정합니다.
  • 악센트 레시피 (브랜드 색상 또는 모든 악센트 변경), :root에 한 번 설정:
    • --a-blue: 채우기, 즉 주어진 브랜드 색상 (이전 이름 유지; "악센트"를 의미).
    • --a-on-accent: 잉크 또는 흰색 중 채우기에서 4.5:1에 도달하는 쪽.
    • --a-blue-hover: 한 단계 더 어둡게 (어두운 기본값에서는 더 밝게) 레이블이 여전히 통과하는 색상.
    • --a-accent-text: light-dark(a, b), 각 테마에서 --a-bg 및 --a-bg-alt에 대해 4.5:1에 도달할 때까지 밝기가 이동된 브랜드 색조. 링크, 악센트 아이브로우 및 포커스 링(>= 3:1)이 이를 읽습니다. 잉크 기본 버튼이 있는 프리셋(lab, journey)은 --a-button-*에 잉크를 유지합니다; 브랜드는 여전히 여기에 위치합니다.
  • 하나의 악센트, 작은 범위: 기본 CTA, 포커스, 링크, 로고 마크, 작은 배지 및 "추천" 마커. 프리셋이 명시하지 않는 한 큰 표면이나 본문 텍스트는 사용하지 않습니다. 상태 색상은 상태에만 사용합니다.
  • 2-4단계의 중립 표면; 프리셋이 지정하는 대로 톤, 가는 선 또는 하나의 부드러운 그림자 수준으로 구분합니다.
  • 텍스트는 흰색 위에 순수한 검정색이 아닙니다; 본문 회색은 AA 대비를 가진 실제 회색입니다.
  • 모든 곳에서 AA: 텍스트와 해당 채우기의 버튼 레이블은 4.5:1, 큰 텍스트, 아이콘 및 의미를 전달하는 테두리는 3:1.
  • 다크 모드는 반전된 팔레트가 아닌 다른 팔레트입니다: 올려진 표면은 한 톤 더 밝게, 깊이를 위한 그림자는 없습니다.

레이아웃 및 리듬

  • 콘텐츠에는 너비 제한이 있습니다: 넓은 그리드(--a-content-wide) 내부의 텍스트 열(--a-content), 유동적인 거터.
  • 섹션은 페이지 색상과 대체 색상을 번갈아 사용합니다; 타일은 해당 섹션의 반대 채우기를 사용합니다.
  • 프리셋이 지정하는 경우 센터 히어로 및 섹션 오프너; 타일 내부의 텍스트와 긴 카피는 왼쪽 정렬됩니다.
  • 페이지당 한 가지 순간; 프리셋이 밴드 위에 구축되지 않은 경우 최대 한 개의 플립된(어둡거나 밝은) 챕터.

반응형 (엄격한 규칙: 모든 해상도, 모든 프리셋)

  • clamp 토큰의 유동적인 타입 및 간격; 375px에서 작은 값, 1440px에서 큰 값.
  • 깨질 수 있는 고정 너비 또는 높이 없음: max-width + 거터, min(), minmax(0, 1fr), aspect-ratio, min-height. 절대 100vh (svh/dvh 사용). 텍스트를 포함하는 Flex/그리드 자식은 min-width: 0을 받습니다.
  • 그리드는 공간에 따라 재배치됩니다: 기기 중단점이 아닌 repeat(auto-fit, minmax(min(100%, 20rem), 1fr)).
  • 미디어 스케일: max-width: 100%; height: auto; SVG는 viewBox를 유지합니다.
  • 내비게이션: 834px 미만(또는 6개 이상의 링크가 맞지 않는 즉시: 컨테이너 쿼리)에서 텍스트 링크는 전체 화면 메뉴(네이티브 popover, JS 없음)로 이동합니다; 기본 링크 스타일보다 우선하는 규칙으로 <li>를 숨깁니다(레시피: 글로벌 내비). 마크, 검색 및 하나의 액션을 보이게 유지합니다. 텍스트 링크 없음(검색, 계정, 장바구니만): 햄버거 메뉴 없음.
  • 모든 너비에서 가로 스크롤바 없음; 의도적인 스크롤러(갤러리, 레일, 코드)만 자체 상자 내에서 오버플로우됩니다.
  • 터치 대상 >= 44x44px: 작은 알약, 견본, 패들, 내비게이션 링크는 보이지 않는 히트 영역(.a-hit)을 얻습니다.
  • 안전 영역: viewport-fit=cover; 거터 및 하단 패딩은 env(safe-area-inset-*)를 사용합니다.
  • 매우 큰 화면: 유형과 콘텐츠는 제한에서 멈춥니다; 배경은 전체 너비로 유지됩니다.
  • 휴대폰 가로 모드: 히어로는 뷰포트 높이가 필요하지 않아야 합니다; 고정된 요소는 1/3 이상을 덮지 않습니다.
  • 줌 200%: 절반 너비의 뷰포트와 동일; 모든 것이 재배치되고 잘리는 부분이 없습니다.

완료라고 말하기 전에 테스트 너비를 확인하세요 (브라우저 창: 각각 resize_window, 스크린샷, 추가로 document.documentElement.scrollWidth === innerWidth 및 뷰포트보다 넓은 요소 목록):

너비의미
320작은 휴대폰, 640의 200% 줌
375 / 414표준 / 대형 휴대폰
768 / 1024태블릿 세로 / 가로, 작은 노트북
1280 / 1440노트북 / 데스크탑 (참조 너비)
1920 / 2560풀 HD / QHD, 울트라와이드
812x375휴대폰 가로 모드
640200% 줌에서 1280px

너비당 보고: 스크린샷 촬영, 오버플로우 예/아니오, 수정 사항. Headless Chrome은 500px 미만의 창을 제한합니다; 브라우저 창에서 또는 test-widths.html?src=<page url>(동일한 http 루트)로 휴대폰 너비를 테스트하세요. Headless 캡처: <html>에 data-theme="light|dark"로 테마를 강제 적용합니다; 리빌 콘텐츠는 정적 캡처에서 보이지 않으므로 --virtual-time-budget=5000을 전달하거나 <html>에 data-reveal="off"를 설정합니다; 100svh 히어로는 긴 전체 페이지 창에서 늘어나므로 캡처를 위해 고정(min-height: 800px)합니다 (&full=1이 둘 다 수행합니다).

컴포넌트

  • 버튼: 최소 높이 44px (더 작은 시각적 요소는 히트 영역을 얻음), 프리셋이 대문자를 지정하지 않는 한 문장형, 뒤에 오는 쉐브론 또는 화살표를 제외한 아이콘 없음, 그라데이션 없음. 기본 채우기, 보조는 프리셋에 따름.
  • 링크: 시각적으로 링크(색상 또는 밑줄); 프리셋이 사용하는 경우 "Learn more ›" 스타일 쉐브론.
  • 타일/카드: 전체 타일이 링크될 때 하나의 탭 정지점(내부 버튼은 span). 둥글기, 채우기, 테두리 및 그림자는 프리셋에서 가져옴; 채우기 + 테두리 + 그림자를 동시에 사용하지 않음.
  • 포커스 링: 모든 상호작용 요소에 2px 실선 --a-focus, 오프셋 1px.
  • 내비게이션: 프리셋에 따라 솔리드 또는 글라스, 최대 하나의 막대 고정, 현재 페이지 표시.
  • 푸터: 조용함: 열에 작은 회색 링크, 법적 행; 열은 휴대폰에서 <details> 아코디언이 됨.

이미지

  • 실제 주제: 제품, 해당 UI, 사용자 자신의 사진 및 미디어. 크고 의도적으로 자릅니다.
  • 노트북을 사용하는 스톡 인물, 3D 블롭, 이모지, 마스코트, 모든 헤딩 앞의 아이콘 없음.
  • 자산 없음: 주제를 CSS 변수로 색상이 변경된 SVG <symbol>로 한 번 그리거나, 올바른 비율의 정직한 회색 플레이스홀더를 사용합니다.

모션

  • Transition named pr

…

[번역을 위해 잘림]

관련 스킬