Communitygithub.com

Omar-Obando/qwen-orchestrator

전문적인 디자인 시스템 - 색상 팔레트 규칙, 타이포그래피, 간격, 다중 페이지 아키텍처, 서비스/제품 상세 페이지, 탐색 제한, 이모지 금지 정책, 섹션 간격, 배포 가이드(Astro + Cloudflare)를 포함합니다. 개별 서비스/제품 페이지가 포함된 다중 페이지 웹사이트 구조를 적용합니다.

qwen-orchestrator란 무엇인가요?

이 스킬은 에이전트(예: Claude Code, Cursor, Codex)가 전문적인 수준의 UI/UX 디자인 시스템을 적용한 다중 페이지 웹사이트를 생성하도록 지시합니다. 색상 팔레트, 타이포그래피, 섹션 간격, 탐색 제한, 이모지 금지 등 엄격한 디자인 규칙을 강제하며, 개별 서비스/제품 상세 페이지를 포함한 완전한 다중 페이지 구조를 요구합니다. 정적/콘텐츠 중심 사이트에는 Astro 프레임워크를, 호스팅에는 Cloudflare Pages를 권장하며, 단일 랜딩 페이지 생성은 금지됩니다. 이 스킬은 개발자와 AI 에이전트가 일관된 디자인 시스템을 준수하는 고품질의 전문 웹사이트를 빠르고 정확하게 구축하는 데 유용하며, 디자인 결정에 대한 반복적인 질문을 줄여줍니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Omar-Obando/qwen-orchestrator/tree/HEAD/skills/design-system

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

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

문서

디자인 시스템 스킬 — 전문 UI/UX, 간격 및 다중 페이지 아키텍처

이 스킬은 전문적인 디자인 표준을 강제합니다: 적절한 색상 팔레트, 타이포그래피, 섹션 간격, 탐색 제한, 상세 서비스/제품 페이지, 이모지 금지, 다중 페이지 웹사이트 아키텍처. 권장 스택: 정적/콘텐츠 사이트를 위한 Astro, Cloudflare Pages에 배포.

⚠️ 필수: 다중 페이지 웹사이트 규칙

사용자가 웹사이트를 요청할 때 절대 단일 랜딩 페이지를 생성하지 마십시오.

사용자가 웹사이트(예: "마케팅 대행사 사이트", "레스토랑 웹사이트", "회사 사이트")를 요청할 때, 최소한 다음 페이지를 포함하는 완전한 다중 페이지 웹사이트를 반드시 생성해야 합니다:

표준 웹사이트 페이지 (필수)

페이지목적우선 순위
홈히어로, 가치 제안, 주요 섹션 CTA필수
회사 소개회사 이야기, 팀, 사명, 가치필수
서비스상세 페이지 링크가 포함된 서비스 목록 페이지필수
서비스 상세서비스별 개별 페이지 (예: /services/web-design)필수
연락처문의 양식, 지도, 전화, 이메일, 영업 시간필수
제품/포트폴리오상세 페이지 링크가 포함된 제품 목록 페이지필수

서비스 페이지 — 상세 (일반적이지 않음)

모든 서비스는 자체 전용 페이지가 있어야 합니다. 서비스 목록 페이지는 개별 상세 페이지로 연결되는 카드/요약을 표시합니다.

❌ 금지됨:
- 개별 페이지 없이 모든 서비스가 나열된 /services 페이지 하나
- 짧은 설명만 있는 하나의 일반 /services 페이지
- 2-3줄의 텍스트로만 설명된 서비스
- 서비스별 가격, 프로세스, 결과물 없음

✅ 필수 구조:
/services              → 목록 페이지 (이미지 + 제목 + 발췌 + CTA가 있는 카드)
/services/web-design   → 상세 페이지 (설명, 프로세스, 결과물, 가격, FAQ, CTA)
/services/seo          → 상세 페이지 (설명, 프로세스, 결과물, 가격, FAQ, CTA)
/services/social-media → 상세 페이지 (설명, 프로세스, 결과물, 가격, FAQ, CTA)

각 서비스 상세 페이지에는 다음이 포함되어야 합니다:

  • 설명: 서비스를 설명하는 3-5개의 단락
  • 프로세스: 단계별 (1. 발견 → 2. 디자인 → 3. 개발 → 4. 출시)
  • 결과물: 클라이언트가 받는 것
  • 가격 티어 또는 "시작 가격 $X" (또는 맞춤 견적을 위한 CTA)
  • FAQ 섹션: 3-5개의 일반적인 질문
  • CTA: "견적 받기", "상담 예약", "프로젝트 시작"
  • 사용 후기 또는 사례 연구 (가능한 경우)

제품 페이지 — 상세 (일반적이지 않음)

모든 제품은 자체 전용 페이지가 있어야 합니다. 제품 목록 페이지는 개별 상세 페이지로 연결되는 카드를 표시합니다.

❌ 금지됨:
- 상세 페이지 없이 단순 목록이나 그리드만 있는 /products 페이지
- 사양 없이 단일 카드로 설명된 제품
- 제품별 가격, 기능 또는 이미지 없음

✅ 필수 구조:
/products              → 목록 페이지 (이미지 + 이름 + 가격 발췌 + CTA가 있는 카드)
/products/product-a    → 상세 페이지 (갤러리, 전체 설명, 사양, 가격, 리뷰, 관련 제품)
/products/product-b    → 상세 페이지 (갤러리, 전체 설명, 사양, 가격, 리뷰, 관련 제품)

각 제품 상세 페이지에는 다음이 포함되어야 합니다:

  • 이미지 갤러리: 3-5개의 제품 이미지
  • 전체 설명: 기능, 사양, 재료
  • 가격: 명확한 가격 표시
  • CTA: "장바구니에 추가", "견적 요청", "지금 구매"
  • 관련 제품 섹션
  • 리뷰/사용 후기 (가능한 경우)

추가 페이지 (비즈니스 유형 기반)

비즈니스 유형추가 페이지
에이전시포트폴리오, 사례 연구, 팀, 프로세스, 가격
레스토랑메뉴, 예약, 갤러리, 셰프/스토리, 프라이빗 이벤트
이커머스쇼핑몰, 제품 상세, 장바구니, 체크아웃, 계정, 위시리스트
SaaS기능, 가격, 문서, 블로그, 변경 로그, 상태
포트폴리오프로젝트, 자기 소개, 이력서/경력 기술서, 사용 후기, 연락처
부동산매물 목록, 매물 상세, 에이전트, 지역 정보, 모기지 계산기
의료서비스, 의사/팀, 예약, 환자 포털, 위치
교육프로그램, 과정, 교수진, 입학, 캠퍼스 라이프, 캘린더
법률전문 분야, 변호사, 사용 후기, 자료, 무료 상담
비영리사명, 프로그램, 영향, 참여하기, 기부하기, 이벤트

페이지 구조 확인 시기

AskUserQuestion을 사용하여 페이지 구조를 확인하세요:

AskUserQuestion({
  questions: [
    {
      question: "웹사이트에 포함할 페이지를 선택하세요.",
      header: "페이지",
      options: [
        { label: "전체 사이트", description: "홈 + 회사 소개 + 서비스 + 제품 + 연락처 (권장)" },
        { label: "표준", description: "홈 + 회사 소개 + 서비스 + 연락처" },
        { label: "확장", description: "전체 사이트 + 블로그 + FAQ + 포트폴리오 + 가격" }
      ]
    }
  ]
})

안티 패턴: 단일 랜딩 페이지

❌ 금지됨 (사용자가 "웹사이트"를 요청했을 때):
- 유일한 페이지로 index.html을 생성
- 모든 콘텐츠를 하나의 스크롤 가능한 페이지에 넣기
- 단일 HTML 파일임에도 "웹사이트"라고 부름
- 페이지인 척하는 섹션 (예: #about, #services, #contact)

✅ 필수:
- 각 섹션에 대한 별도 경로/페이지 (예: /about, /services, /contact)
- 각 페이지는 자체 레이아웃, 메타 태그 및 SEO 최적화를 가짐
- 모든 페이지를 연결하는 탐색 메뉴
- 공유 헤더/푸터 컴포넌트
- 모든 페이지에 걸쳐 일관된 디자인 시스템
- 각 서비스 및 제품에 대한 개별 상세 페이지

유일한 예외: 사용자가 명시적으로 "랜딩 페이지" 또는 "원페이지 사이트"라고 말하는 경우.


⚠️ 필수: 이모지 금지 정책

전문 웹사이트는 이모지를 사용하지 않습니다. 절대.

❌ 금지됨:
- 웹사이트 어디에서든 🚀 🎯 💡 ✨ 🏆 📱 💻 🛒 📧 📞 ✅ ❌ 🔥 ⭐ 💪 🎨 📊 🔒 🌍 이모지
- 섹션 아이콘으로 이모지 사용
- 제목, 버튼 또는 CTA에서 이모지 사용
- 탐색 레이블에서 이모지 사용
- 메타 제목 또는 설명에서 이모지 사용

✅ 필수:
- 아이콘 라이브러리(Lucide, Heroicons, Phosphor, Tabler)의 SVG 아이콘 사용
- 시각적 흥미를 위해 CSS 모양 또는 장식 요소 사용
- 적절한 아이콘 컴포넌트 사용 (<svg> 또는 아이콘 폰트)
- 모든 제목, 버튼 및 레이블에 일반 텍스트 사용

아이콘 라이브러리 (하나를 선택하고 일관성 유지):

라이브러리설치스타일가장 적합한 용도
Lucidenpm install lucide-react깔끔하고 현대적대부분의 웹사이트
Heroiconsnpm install @heroicons/react대담하고 명확대시보드, SaaS
Phosphornpm install @phosphor-icons/react유연함, 6가지 두께다양한 프로젝트
Tablernpm install @tabler/icons-react외곽선관리자 패널

⚠️ 필수: 섹션 간격

섹션은 절대 서로 닿아서는 안 됩니다. 모든 섹션에는 여유 공간이 필요합니다.

최소 간격 규칙

요소최소 패딩 (상단/하단)CSS 변수
페이지 섹션var(--space-20) (80px)--section-padding
히어로 섹션var(--space-32) (128px)--hero-padding
푸터 상단 패딩var(--space-32) (128px)--footer-padding
헤더 높이var(--space-16) (64px)--header-height
콘텐츠 블록 사이var(--space-12) (48px)--block-gap
CTA 섹션var(--space-20) (80px)--cta-padding

섹션 간격 CSS

:root {
  --section-padding: clamp(4rem, 8vw, 6rem); /* 64-96px */
  --hero-padding: clamp(6rem, 12vw, 10rem); /* 96-160px */
  --footer-padding: clamp(5rem, 10vw, 8rem); /* 80-128px */
  --header-height: 4rem; /* 64px */
  --block-gap: clamp(2rem, 4vw, 3rem); /* 32-48px */
}

section {
  padding-top: var(--section-padding);
  padding-bottom: var(--section-padding);
}

.hero {
  padding-top: var(--hero-padding);
  padding-bottom: var(--hero-padding);
  min-height: 70vh;
}

footer {
  padding-top: var(--footer-padding);
  padding-bottom: var(--space-12);
  margin-top: 0; /* 절대 푸터 간격을 축소하지 마십시오 */
}

/* 교차 섹션은 다른 배경을 얻습니다 */
section:nth-of-type(even) {
  background-color: var(--color-surface);
}
section:nth-of-type(odd) {
  background-color: var(--color-bg);
}

간격 안티 패턴

❌ 금지됨:
- 푸터가 위 섹션에 직접 닿음 (간격 없음)
- 패딩이 64px 미만인 섹션 (비좁아 보임)
- 96px 미만의 패딩이 있는 히어로 섹션 (시각적 영향 약함)
- 주요 섹션에서 margin: 0 사용
- 모든 섹션이 동일한 배경색 (시각적 분리 없음)
- 모바일에서 좁은 간격 (< 48px 섹션 패딩)

✅ 필수:
- 푸터에는 항상 넉넉한 상단 패딩이 있음 (128px+)
- 모든 섹션은 명확한 시각적 분리가 있음 (간격 + 교대 배경)
- 히어로는 넉넉한 패딩으로 최소 70vh를 차지
- 모바일 섹션은 적응형 간격을 위해 clamp() 사용
- 푸터 앞의 CTA 섹션은 자체 고유한 배경을 가짐

⚠️ 필수: 탐색 제한

탐색 메뉴는 포화 상태여서는 안 됩니다. 최대 7개의 최상위 항목.

탐색 규칙

  1. 기본 탐색 모음에 최대 7개 항목
  2. 관련 페이지를 드롭다운 메뉴 아래에 그룹화
  3. 보조 링크(개인정보 보호정책, 이용약관, 사이트맵)에는 푸터 탐색 사용
  4. 모바일: 접을 수 있는 섹션이 있는 햄버거 메뉴
  5. 절대 모든 페이지를 기본 탐색에 넣지 마십시오

권장 탐색 구조

메인 탐색 (최대 5-7개 항목):
  홈 | 회사 소개 | 서비스 ▼ | 제품 | 포트폴리오 | 연락처 | CTA 버튼

서비스 드롭다운:
  서비스 개요
  ─────────────────
  웹 디자인
  SEO 최적화
  소셜 미디어
  브랜드 전략

푸터 탐색 (보조 링크):
  개인정보 보호정책 | 이용약관 | 사이트맵 | FAQ | 채용 정보

탐색 안티 패턴

❌ 금지됨:
- 메인 탐색 모음에 7개 이상의 항목 (복잡하고 압도적)
- 모든 단일 페이지를 상단 탐색에 배치
- 그룹화된 콘텐츠에 대한 드롭다운/메가 메뉴 없음
- 모든 링크를 평면적으로 나열하는 햄버거 메뉴
- 이모지가 있는 탐색 항목 (예: "🏠 홈" "📧 연락처")
- 시각적 계층 구조가 없는 텍스트 전용 탐색

✅ 필수:
- 최대 7개의 최상위 항목, 드롭다운 아래에 추가 항목 그룹화
- 기본 CTA 버튼 (탐색 링크와 다른 색상/스타일)
- 푸터에는 보조 링크 포함 (법률, 추가 정보)
- 모바일: 그룹화된 섹션이 있는 햄버거 메뉴
- 현재 페이지 링크에 활성 상태
- 모든 탐색 항목에 마우스 오버 상태

⚠️ 필수: 권장 프레임워크 — Astro

정적 웹사이트, 마케팅 사이트 및 콘텐츠 중심 사이트의 경우 Astro를 권장합니다.

마케팅 사이트에서 Astro가 Next.js보다 나은 이유

요소AstroNext.js
기본 출력제로 JS (HTML만)React 런타임 필요
성능거의 완벽한 Lighthouse 점수좋지만 최적화 필요
콘텐츠 중심콘텐츠 사이트에 내장됨웹 앱에 내장됨
번들 크기기본적으로 0KB JS~80KB+ React 런타임
학습 곡선쉬움 (HTML + 컴포넌트)보통 (React + SSR 개념)
다중 프레임워크아일랜드에서 React/Vue/Svelte 사용 가능React만 가능
SEO완벽 (정적 HTML)좋음 (구성 필요)
호스팅Cloudflare Pages, Vercel, NetlifyVercel (최적화), 기타

무엇을 권장해야 하는 경우

프로젝트 유형권장 프레임워크
마케팅/에이전시 사이트Astro + Tailwind
레스토랑/지역 비즈니스Astro + Tailwind
포트폴리오/이력서Astro + Tailwind
블로그/콘텐츠 사이트Astro + Tailwind
랜딩 페이지Astro 또는 HTML/Tailwind
SaaS 웹 앱Next.js + React
이커머스Next.js + React
대시보드/관리자React + Vite
모바일 앱Flutter 또는 React Native

Astro 프로젝트 설정

npm create astro@latest my-site
cd my-site
npx astro add tailwind

Astro 페이지 구조

src/
├── pages/
│   ├── index.astro          # 홈
│   ├── about.astro          # 회사 소개
│   ├── services/
│   │   ├── index.astro      # 서비스 목록
│   │   ├── web-design.astro # 서비스 상세
│   │   ├── seo.astro        # 서비스 상세
│   │   └── social-media.astro
│   ├── products/
│   │   ├── index.astro      # 제품 목록
│   │   └── [slug].astro     # 동적 제품 상세
│   ├── contact.astro
│   ├── blog/
│   │   ├── index.astro      # 블로그 목록
│   │   └── [slug].astro     # 블로그 글
│   └── 404.astro
├── layouts/
│   └── BaseLayout.astro     # 공유 HTML 셸
├── components/
│   ├── Header.astro
│   ├── Footer.astro
│   ├── ServiceCard.astro
│   ├── ProductCard.astro
│   └── SEO.astro            # 재사용 가능한 메타/JSON-LD
└── styles/
    └── global.css           # 디자인 토큰

⚠️ 필수: Cloudflare Pages 배포

정적/Astro 사이트의 경우 Cloudflare Pages에 배포합니다 (무료, 빠름, 글로벌 CDN).

배포 설정

# Wrangler CLI 설치
npm install -g wrangler

# Cloudflare에 로그인
wrangler login

# 프로젝트 빌드
npm run build

# Cloudflare Pages에 배포
npx wrangler pages deploy dist/

Cloudflare Pages를 선택해야 하는 이유

기능이점
무료 요금제무료: 무제한 사이트, 무제한 요청, 500MB 스토리지
글로벌 CDN330개 이상의 도시에서 엣지 제공
자동 HTTPS무료 SSL/TLS, 자동 갱신
사용자 정의 도메인무료 사용자 정의 도메인 설정
Git 통합Git 푸시 시 자동 배포
분석기본 제공 분석 (무료)
양식 처리내장 양식 처리 (서버 없음)
리디렉션

[원문이 잘렸으나 번역이 완료되었습니다]

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬