Communitygithub.com

웹사이트 구축

모든 사이트가 독특한 디자인을 가지는, 프로덕션 등급의 웹사이트, 랜딩 페이지 및 대화형 웹 경험을 구축하는 스킬입니다. 강력한 디자인과 QA 규율을 갖춥니다.

웹사이트 구축란 무엇인가요?

이 스킬은 독창적이고 고품질의 웹사이트를 구축하는 방법을 제공합니다. 모든 사이트가 완전히 다른 디자인을 갖도록 강제하며, 각 프로젝트 주제에서 도출된 색상, 타이포그래피, 모션 및 레이아웃을 사용합니다. `bun run shared/generate-palette.ts "keywords"` 명령어로 고유한 색상 팔레트를 생성하고, 프로젝트 유형(정보 제공 사이트, 웹 애플리케이션, 브라우저 게임)에 따라 도메인별 가이드라인을 로드합니다. Playwright를 사용한 시각적 QA를 필수로 수행하며, SVG 로고 생성, 접근성, 성능 등에 대한 상세한 지침이 포함되어 있습니다. Cursor, Claude Code, Codex와 같은 AI 에이전트와 함께 사용하도록 설계되었습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rizkydarm/ClusteringAIAgentsSkills-Python/tree/HEAD/_skill/website-building

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

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

문서

웹사이트 구축 (Website Building)

독창적이고 프로덕션 등급의 웹사이트를 구축하세요. 모든 사이트가 완전히 다르게 보여야 합니다. 타입, 색상, 모션, 레이아웃 등 모든 선택은 주제에서 파생되어야 합니다. 팔레트 생성기(bun run shared/generate-palette.ts "keywords")를 실행하여 각 프로젝트의 고유한 색상 구성표를 만드세요. 절대 동일한 팔레트를 여러 사이트에 재사용하지 마세요.

이 스킬은 웹 프로젝트의 모든 것을 다룹니다. 필요에 따라 이 디렉토리의 하위 파일을 읽으세요. 웹 애플리케이션의 경우 skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.md도 읽으세요.

범용 디자인 원칙 (색상 철학, 기본 팔레트, 글꼴 선택)은 design-foundations를 통해 다른 스킬과 공유됩니다. 이 스킬의 공유 파일은 웹 특화 구현(CSS 변수, 반응형 토큰, 기본 스타일시트)으로 해당 기반을 확장합니다. design-foundations를 별도로 로드할 필요는 없습니다. shared/의 웹 특화 버전이 포괄적이기 때문입니다.

read는 전체 경로와 함께 사용하세요. 예: skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md


프로젝트 유형 라우팅 (Project Type Routing)

1단계: 프로젝트 유형을 식별하고 도메인별 가이드라인 로드:

프로젝트 유형작업예시
정보 제공 사이트read skills/GENERAL-KNOWLEDGE-WORKER/website-building/informational/informational.md개인 사이트, 포트폴리오, 에디토리얼/블로그, 소규모 비즈니스, 랜딩 페이지
웹 애플리케이션read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.mdSaaS 제품, 대시보드, 관리자 패널, 전자상거래, 브랜드 경험
브라우저 게임read skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game.md + skills/GENERAL-KNOWLEDGE-WORKER/website-building/game/game-testing.md2D Canvas 게임, Three.js/WebGL, HTML5 게임, 인터랙티브 3D 경험

2단계: 공유 파일 읽기 — 먼저 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md와 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md를 읽으세요 (웹앱을 포함한 모든 프로젝트 유형에 필수). 이 파일들은 모든 상황에 적용되는 Kortix 디자인 시스템 기본값과 타이포그래피 규칙을 설정합니다. 웹 애플리케이션 및 대시보드의 경우 아래에 † 표시된 파일은 건너뛰세요. 해당 파일에는 풀스택 템플릿에 미리 구성된 구현 세부 정보가 포함되어 있습니다.

사용자가 "웹사이트" 또는 "사이트"라고만 말하고 세부 정보가 없으면 유형을 묻거나 정보 제공 사이트를 기본값으로 사용하세요.


하위 파일 참조 (Sub-File Reference)

공유 파일 (shared/) — 모든 프로젝트

파일다루는 내용로드
shared/01-design-tokens.md타입 스케일, 간격, Kortix 팔레트, base.css항상
shared/02-typography.md글꼴 선택, 페어링, 로딩, 블랙리스트항상
shared/04-layout.md공간 구성, 반응형, 모바일 우선항상 †
shared/05-taste.md스켈레톤 로더, 빈/오류 상태, 마감 처리항상
shared/08-standards.md접근성, 성능, 안티 패턴항상
shared/09-technical.md프로젝트 구조, 샌드박스, 배포, 체크리스트항상 †
shared/head-defaults.html<head>용 속성 블록항상 †
shared/03-motion.md스크롤 애니메이션, Motion 라이브러리, GSAP SVG 플러그인, 호버/커서애니메이션이 필요할 때
shared/06-css-and-tailwind.mdTailwind CSS v3, shadcn/ui, 모던 CSSTailwind 사용 시
shared/07-toolkit.mdCDN 라이브러리, React, Three.js, 아이콘, 지도, SVG 패턴/필터, esm.sh라이브러리 선택 시
shared/10-charts-and-dataviz.mdChart.js, Recharts, D3, KPI, 스파크라인데이터 시각화 필요 시
shared/11-web-technologies.md프레임워크 버전, 브라우저 호환성호환성 확인 시
shared/12-playwright-interactive.md지속적인 Playwright 브라우저 QA, 스크린샷, 시각적 테스팅테스트 시
shared/19-backend.mdFastAPI/Express/Flask 서버, WebSocket, SSE, 포트 포워딩백엔드 필요 시
shared/20-llm-api.mdLLM/AI API 통합 참조사이트가 AI API 사용 시

모든 경로는 skills/GENERAL-KNOWLEDGE-WORKER/website-building/ 기준입니다.

† 웹앱 및 대시보드의 경우 건너뛰기 — 구현 세부 정보가 풀스택 템플릿에 미리 구성되어 있습니다. Design-tokens 및 typography는 건너뛰지 않습니다. 모든 프로젝트 유형에 대해 권위 있는 디자인 시스템 기본값과 글꼴 선택 지침을 제공합니다.

도메인별 — 하나 로드

파일로드 시점
read skills/GENERAL-KNOWLEDGE-WORKER/website-building/webapp/SKILL.mdSaaS, 대시보드, 관리자, 전자상거래, 브랜드 경험 (풀스택 템플릿이 있는 하위 스킬)
webapp/dashboards.md대시보드 또는 데이터 밀집 인터페이스 (webapp과 함께 사용)
informational/informational.md개인 사이트, 포트폴리오, 에디토리얼, 소규모 비즈니스, 랜딩
game/game.md브라우저 게임, Three.js, WebGL, 인터랙티브 3D
game/2d-canvas.md2D Canvas 게임 (game.md와 함께 사용)
game/game-testing.md모든 브라우저 게임 — game.md와 함께 로드

인터랙티브 QA: 지속적인 브라우저 자동화(스크린샷, 기능 테스트, 시각적 QA)를 위해 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md를 읽으세요. 게임 테스트에 필요하며 복잡한 사이트에 유용합니다.


워크플로 (Workflow)

0단계: 모든 필수 파일 로드 (먼저, 병렬로 수행)

다음 모든 파일을 한 번에 읽으세요. 모든 프로젝트에 필수입니다:

read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/02-typography.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/04-layout.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/05-taste.md")
read("skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md")

그런 다음 아래 1단계에서 도메인별 파일(informational, webapp, game)을 로드하세요.

1단계: 고유 팔레트 생성

주제를 설명하는 키워드와 함께 팔레트 생성기를 실행하세요:

bun run skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/generate-palette.ts "subject keywords here"

가장 좋은 하모니를 선택하고 필요에 따라 사용자 정의하세요.

2단계: 디자인 및 구축 (Design & Build)

생성된 팔레트와 로드된 모든 디자인 가이드라인에 따라 사이트를 구축하세요.

3단계: 미리보기 (Preview)

정적 서버를 통해 표시: show(type: "url", url: "http://localhost:3211/open?path=/workspace/project/index.html")


모든 도구 사용 (Use Every Tool)

  • 먼저 리서치. 디자인하기 전에 웹에서 참고 사이트, 트렌드, 경쟁사 예제를 검색하세요. 특정 사이트 유형의 수상 경력에 빛나는 예제를 찾아보세요. 사용자가 제공하는 URL을 가져오세요.
  • 실제 에셋을 아낌없이 생성. 히어로, 섹션 일러스트레이션, 에디토리얼 피처 비주얼, 분위기 배경 등을 위한 이미지를 생성하세요. 단순히 히어로 이미지 하나만 생성하지 마세요. 모든 긴 페이지는 사이트의 아트 디렉션과 일치하는 생성된 이미지로 시각적 리듬을 가져야 합니다. 플레이스홀더는 사용하지 마세요. 모든 프로젝트에 대해 사용자 정의 SVG 로고를 생성하세요 (아래 참조). SVG는 로고에만 사용하며, 사용자가 특별히 SVG 출력을 요청하지 않는 한 그렇습니다. 방향에 영향을 주는 웹 참조 이미지를 저장하세요.
  • Playwright로 스크린샷. 데스크톱(1280px+) 및 모바일(375px) 스크린샷을 위해 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md를 읽으세요. 참조 이미지와 비교하세요. 이는 선택이 아닌 필수입니다. 아래 시각적 QA를 참조하세요.
  • 프로덕션 코드를 직접 작성. HTML, CSS, JS, SVG. 빌드 도구 및 파일 처리를 위해 bash를 사용하세요.

SVG 로고 생성 (SVG Logo Generation)

모든 프로젝트는 사용자 정의 인라인 SVG 로고를 받습니다. 스타일이 적용된 텍스트 제목을 대체하지 마세요.

  1. 브랜드 이해 — 목적, 톤, 한 단어로 정의
  2. SVG 직접 작성 — 기하학적 모양, 글자체 또는 추상적 마크. 기억에 남는 하나의 형태.
  3. 원칙: 기하학적/미니멀 (Paul Rand, Vignelli). 24px와 200px에서 모두 작동. 먼저 모노크롬 — 색상은 개선 요소로 추가. 다크/라이트 모드를 위해 currentColor 사용.
  4. 인라인으로 구현 aria-label, viewBox, fill="none", currentColor 스트로크와 함께.
  5. 파비콘 생성 — 필요한 경우 단순화된 32x32 버전

SVG 애니메이션(DrawSVG, MorphSVG)의 경우 shared/03-motion.md를 참조하세요. SVG 패턴/필터의 경우 shared/07-toolkit.md를 참조하세요.


시각적 QA 테스트 프로세스 (Visual QA Testing Process)

모든 배포는 시각적 QA를 통과해야 합니다. 스크린샷은 품질 관문입니다.

모든 시각적 QA에 대해 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/12-playwright-interactive.md를 읽으세요. Playwright는 스크린샷, 상호 작용 테스트 및 뷰포트 확인을 위한 지속적인 브라우저 세션을 제공합니다.

사이클: Build → Playwright QA → Evaluate → Fix → Repeat → Deploy when ready

1단계: 페이지별 QA

각 페이지를 구축한 후:

  1. 데스크톱(1280px+) 및 모바일(375px) 스크린샷 Playwright를 통해
  2. 비판적으로 평가: 전문적으로 디자인되었는가(AI 생성처럼 보이지 않는가)? 타이포그래피가 독특한가? 여백이 충분한가? 명확한 시각적 계층 구조가 있는가?
  3. 다음으로 넘어가기 전에 모든 문제 수정. 시각적 부채를 남기지 마세요.

2단계: 최종 QA (게시 전)

  1. 모든 페이지의 데스크톱 및 모바일 스크린샷
  2. 페이지 간 일관성 확인 (간격, 색상, 타입 처리)
  3. 다크 모드 확인 (최소 홈페이지는 두 테마 모두 스크린샷)
  4. 상호 작용 상태 확인: hover, focus, active, loading, empty, error
  5. 콜드 오픈 첫인상 테스트: 정제되고 의도적으로 느껴지는가?

QA 실패: 텍스트 넘침, 일관성 없는 간격, 토큰에서 벗어난 색상, 다크 모드 누락, 모바일에서 찌그러짐, 일반적인 AI 느낌, 플레이스홀더 콘텐츠, 로고 누락.


1단계: 아트 디렉션 (Art Direction) — 묻기 전에 추론하고, 기본값으로 가기 전에 묻기

모든 사이트는 콘텐츠에서 파생된 시각적 아이덴티티를 가져야 합니다. Kortix 대체 팔레트로 바로 넘어가지 마세요. Kortix 팔레트는 추론과 질문이 모두 실패했을 때의 최후의 수단이지, 편리한 기본값이 아닙니다.

  1. 주제에서 추론. 커피 로스터 사이트 → earthy browns, warm cream, 손으로 그린 느낌. 핀테크 대시보드 → cool slate, 날카로운 산세리프, 데이터 밀집. 어린이 학습 앱 → 밝은 원색, 둥근 타입, 장난기 있는 모션. 콘텐츠 자체가 사용자가 말을 하기 전에 팔레트, 타이포그래피, 간격을 알려줍니다.
  2. 아트 디렉션 테이블 확인. 각 도메인 파일(informational.md, webapp/SKILL.md, game/game.md)에는 사이트/제품 유형을 컨셉 기반 방향 및 토큰 시작점에 매핑하는 아트 디렉션 테이블이 있습니다. 이를 출발점으로 사용하세요.
  3. 다섯 가지 기둥 도출: 색상(따뜻함/차가움, 주제에서 강조색), 타이포그래피(세리프/산세리프, 디스플레이 개성), 간격(빽빽함/넉넉함), 모션(최소한/표현적), 이미지(사진/일러스트레이션/타입만).
  4. 주제가 모호한 경우 물어보세요 — "어떤 분위기를 원하시나요?" 및 "참고 사이트가 있나요?" 한 가지 질문이면 충분합니다.
  5. Kortix 대체 — 추론과 질문 모두 실패한 경우에만. 사용자에게 질문했지만 방향을 제시하지 않았고, 주제에서 명확한 신호를 얻지 못한 경우에만 Kortix/Swiss 기본값으로 대체하세요.

대체: 깔끔하고 스위스 스타일 (최후의 수단)

추론이 명확한 방향을 제시하지 못하고, 사용자에게 질문했지만 스타일 지침을 받지 못한 경우 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/01-design-tokens.md의 기본값을 사용하고 다음을 따르세요:

  • 타이포그래피: Satoshi 또는 General Sans 본문(Fontshare — 선호됨), 또는 Inter/DM Sans. 글꼴 대비보다는 무게 대비. 최대 3-4 크기. 텍스트를 간결하게 유지 — --text-3xl/--text-hero는 정보 제공 사이트 히어로에만 사용.
  • 색상: Kortix 팔레트. 중립적인 표면 + CTA에만 사용되는 하나의 청록색 강조.
  • 레이아웃: 그리드 정렬. 넉넉한 여백. 흥미로운 곳에 비대칭.
  • 모션: 최소한, 기능적. 부드러운 상태 전환만.
  • 이미지: 깔끔하고 관련성 높은 시각 자료 생성. 스톡 사진 사용 안 함.

아트 디렉션 — AI 미학 피하기

전체 안티 패턴 목록은 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/08-standards.md를 참조하세요.


2단계: 게시 (Publish)

먼저 실제 로컬 미리보기 명령을 사용하고, 대상 프로젝트의 실제 배포 워크플로를 통해서만 게시하세요. 권장 미리보기 및 전달 흐름은 skills/GENERAL-KNOWLEDGE-WORKER/website-building/shared/09-technical.md를 참조하세요.


전달 (Delivery)

  • 항상 먼저 사이트를 로컬에서 확인하세요.
  • 미리보기 또는 개발 서버에 pty_spawn을 사용하세요.
  • 대상 리포지토리에 이미 배포 워크플로가 있으면 해당 워크플로를 그대로 사용하세요.
  • 설정된 배포 대상이 없으면 플랫폼별 배포 스토리를 임의로 만들지 말고 파일과 함께 확인된 로컬 미리보기를 전달하세요.

관련 스킬