Communitygithub.com

sandbox-safemode/365-castle-logos

차별화된 프로덕션 등급 웹사이트를 구축하세요. 모든 선택(타입, 색상, 모션, 레이아웃)은 의도적이어야 합니다. 정적 HTML/CSS/JS 번들로 S3에 배포합니다.

365-castle-logos란 무엇인가요?

이 스킬(sandbox-safemode/365-castle-logos)은 에이전트(Claude Code, Cursor, Codex 등)가 일반적인 'AI 슬롭' 미학을 피하고, 모든 디자인 요소가 의도적이며 프로덕션에 바로 사용할 수 있는 웹사이트를 구축할 수 있도록 설계되었습니다. 간단한 정보 제공 사이트부터 복잡한 웹 애플리케이션, 브라우저 게임까지 모든 웹 프로젝트 유형을 지원하며, 결과물은 정적 HTML/CSS/JS 번들로 S3에 자동 배포됩니다. 이 스킬의 핵심은 디자인 철학과 기술 구현의 완벽한 결합에 있습니다. 공유 디자인 토큰, 타이포그래피, 레이아웃, 모션 파일을 통해 일관된 넥서스 디자인 시스템을 제공하며, 프로젝트 유형별로 정보 제공 사이트, 웹 애플리케이션(하위 스킬), 브라우저 게임으로 라우팅됩니다. 작업 흐름은 설계 방향 결정, 버전 관리(git init), 페이지별 빌드와 Playwright를 통한 시각적 QA, 그리고 deploy_website() 함수를 통한 S3 배포로 구성됩니다. 모든 프로젝트는 맞춤형 인라인 SVG 로고를 생성하고, 대체 불가능한 실제 에셋(이미지, 일러스트레이션)을 생성하여 'AI 느낌'을 피합니다. 복잡한 사이트는 Playwright QA를 통해 데스크톱과 모바일에서 철저히 검증합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sandbox-safemode/365-castle-logos/tree/HEAD/skills/website-building

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

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

문서

웹사이트 구축

차별화된 프로덕션 등급 웹사이트를 구축하세요. 모든 선택(타입, 색상, 모션, 레이아웃)은 의도적이어야 합니다. 정적 HTML/CSS/JS 번들로 S3에 배포합니다.

이 스킬은 웹 프로젝트의 모든 것을 다룹니다. load_skill("website-building")을 통해 로드되면 모든 파일이 workspace/에 복사됩니다. 프로젝트 유형에 따라 필요에 따라 하위 파일을 읽으세요. 웹 애플리케이션의 경우 하위 스킬을 로드하세요: load_skill("website-building/webapp").

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

전체 경로와 함께 read를 사용하세요. 예: shared/01-design-tokens.md


프로젝트 유형 라우팅

1단계: 프로젝트 유형 식별 및 도메인별 지침 로드:

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

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

사용자가 그냥 "website" 또는 "site"라고만 말하고 자세한 내용이 없으면, 유형을 묻거나 정보 제공 사이트로 기본값을 설정하세요.


하위 파일 참조

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

파일포함 내용로드
shared/01-design-tokens.md타입 스케일, 간격, Nexus 팔레트, base.css항상
shared/02-typography.md글꼴 선택, 페어링, 로딩, 블랙리스트항상
shared/04-layout.md공간 구성, 반응형, 모바일 우선항상 †
shared/05-taste.md스켈레톤 로더, 빈/오류 상태, 다듬기항상
shared/08-standards.md접근성, 성능, 안티 패턴항상
shared/09-technical.md프로젝트 구조, 샌드박스, 배포, 체크리스트항상 †
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 채팅, 이미지/비디오/오디오 생성, 전사 — 모델, 자격 증명, SDK 헬퍼사이트가 AI/LLM API를 사용할 때

모든 경로는 ``에 상대적입니다.

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

도메인별 — 하나 로드

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

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


워크플로우

  1. 디자인 방향: 목적을 명확히 하고, 미적 방향을 선택합니다.
  2. 버전 관리: 스캐폴딩 후 프로젝트 디렉토리에서 git init을 실행합니다. 각 주요 이정표 후 짧은 메시지와 함께 커밋합니다.
  3. 빌드: 사이트를 페이지별로 빌드하고 Playwright를 통해 스크린샷을 찍어 시각적 QA를 수행합니다.
  4. 게시: 모든 변경 사항을 커밋한 후 deploy_website()로 공개 URL을 반환합니다.

모든 도구 사용

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

SVG 로고 생성

모든 프로젝트는 맞춤형 인라인 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를 참조하세요.


Visual QA 테스트 프로세스

Playwright QA 사용 시기

간단한 사이트는 Playwright를 건너뛰세요. 단일 페이지 정적 사이트는 Playwright 스크린샷이 필요하지 않습니다. 코드를 직접 검토한 다음 배포하세요. Playwright QA는 상당한 시간이 추가되며 간단한 정적 콘텐츠에는 가치가 없습니다.

복잡한 사이트에는 Playwright를 사용하세요. 여러 페이지 사이트, 웹 애플리케이션, 대시보드, 게임 및 인터랙티브 기능(양식, 장바구니, 필터, 차트, 드래그 앤 드롭)이 있는 모든 사이트는 Playwright QA를 사용해야 합니다. 지속적인 브라우저 자동화를 위해 skills/website-building/shared/12-playwright-interactive.md를 읽으세요.

Playwright QA 프로세스(복잡한 사이트만)

사이클: 빌드 → Playwright QA → 평가 → 수정 → 반복 → 준비되면 배포

1단계: 페이지별 QA

각 페이지를 빌드한 후:

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

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

  1. 모든 페이지의 데스크톱 및 모바일 스크린샷을 찍습니다.
  2. 페이지 간 일관성 확인(간격, 색상, 텍스트 처리)
  3. 다크 모드 확인(최소 홈페이지 두 테마 스크린샷)
  4. 인터랙티브 상태 확인: 호버, 포커스, 액티브, 로딩, 빈 상태, 오류
  5. 첫인상 테스트: 세련되고 의도적으로 느껴지는가?

QA 실패: 텍스트 오버플로, 일관성 없는 간격, 토큰 외 색상, 다크 모드 누락, 모바일에서 눌림, 일반적인 AI 느낌, 플레이스홀더 콘텐츠, 로고 누락.


1단계: 아트 디렉션 — 묻기 전에 추론하고, 기본값으로 가기 전에 물어보기

모든 사이트는 콘텐츠에서 파생된 시각적 정체성을 가져야 합니다. Nexus 대체 팔레트로 건너뛰지 마세요. Nexus 팔레트는 추론과 질문 모두 실패했을 때의 최후의 수단입니다. 편리한 기본값이 아닙니다.

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

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

추론이 명확한 방향을 제공하지 못했고 사용자에게 질문했지만 스타일 지침을 받지 못한 경우 shared/01-design-tokens.md의 기본값을 다음 설정과 함께 사용하세요:

  • 타이포그래피: Satoshi 또는 General Sans 본문(Fontshare — 선호) 또는 Inter/DM Sans. 글꼴 대비보다 두께 대비. 최대 3-4개 크기. 텍스트를 간결하게 유지 — --text-3xl/--text-hero는 정보 제공 사이트 히어로 전용입니다.
  • 색상: Nexus 팔레트. 중립 표면 + CTA 전용 틸 악센트 하나.
  • 레이아웃: 그리드 정렬. 넉넉한 여백. 흥미로운 곳에서 비대칭.
  • 모션: 미니멀하고 기능적. 부드러운 상태 전환만.
  • 이미지: 깔끔하고 관련성 높은 비주얼을 생성하세요. 스톡 사진 없음.

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

전체 안티 패턴 목록은 shared/08-standards.md를 참조하세요.


2단계: 게시

deploy_website()를 프로젝트 경로 및 사이트 이름과 함께 호출하세요. 공개 S3 URL을 반환합니다. 업데이트하려면 로컬 파일을 편집하고 동일한 경로로 재배포하세요. 정확한 호출 및 예제는 shared/09-technical.md를 참조하세요.

관련 스킬