Communitygithub.com

Website Studio

완전한 웹사이트 스튜디오. 세 가지 모드(💡 구상, 🛠️ 제작, 🩺 진단)를 제공하며 사용자와 협력하여 아이디어 도출, 사이트 구축, 문제 진단 및 수정을 수행합니다.

Website Studio란 무엇인가요?

이 스킬은 AI 에이전트가 웹사이트 기획, 제작, 진단을 하나의 워크플로우로 처리할 수 있도록 설계된 종합 스튜디오입니다. Claude Code, Cursor, Codex 등 AI 코딩 도구와 함께 사용할 수 있으며, 3가지 모드를 지원합니다. 💡 **구상 모드**에서는 사용자의 비즈니스 목표에 맞춰 2~3가지 구체적인 웹사이트 아이디어를 제시하고, 🛠️ **제작 모드**에서는 7단계(브리핑, 계획, 비주얼 아이덴티티, 홈페이지, 나머지 페이지, 검증, 배포)를 통해 실제 사이트를 구축합니다. 🩺 **진단 모드**에서는 150개 이상의 체크리스트로 사이트의 보안, 성능, 접근성, SEO, 개인정보보호 등을 종합적으로 검사하고 건강 보고서를 제공합니다. 사용자의 요청을 기다리며, 각 단계마다 승인을 받고 진행하며 항상 정직한 의견을 제시합니다. 정적 HTML 사이트부터 Astro, Next.js 기반 프로젝트까지 지원하며, 모바일 우선, 성능 최적화, 접근성, 개인정보 보호를 핵심 원칙으로 삼습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mozuraa/claude-skill-website-studio/tree/HEAD

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

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

문서

Website Studio은(는) 무엇을 하나요?

세 가지 모드가 연계되는 웹사이트 스튜디오입니다: 💡 구상 → 🛠️ 제작 → 🩺 진단. 모든 모드에서 사용자와 함께 작업합니다: 질문하고, 발견하거나 제안한 내용을 보여주고, 솔직한 의견을 제시하며 사용자의 승인을 받은 후에만 진행합니다.

항상 사용자가 작성한 언어로 응답하세요 (이 지침은 한국어로 작성되었지만 응답도 한국어여야 합니다). 사용자가 프로그래밍에 능숙하지 않다면 비유를 사용하고 전문 용어 없이 간단한 언어로 모든 것을 설명하세요.

모드 선택

사용자가...모드
아이디어를 원할 때: "어떤 사이트를 만들어야 할까요?", "쇼핑몰 사이트 아이디어", "내 사이트에 무엇을 추가할 수 있을까?", "사이트로 더 많은 고객을 유치하려면?"💡 구상
새 사이트를 원하거나 처음부터 다시 만들 때: "사이트 만들어줘", "랜딩 페이지가 필요해"🛠️ 제작
사이트에 문제가 있거나 상태를 확인하려 할 때: "작동 안 해", "검토해 줘", "느려", "안전해?"🩺 진단

명확하지 않다면 한 줄로 물어보세요 ("새 사이트를 만들까요, 기존 사이트를 검토할까요, 아니면 먼저 아이디어를 드릴까요?"). 각 모드는 자연스럽게 연결됩니다. 구상 모드에서 승인된 아이디어는 제작 모드의 시작점이 됩니다. 제작 모드는 진단 모드의 검사로 끝납니다. 진단 결과 사이트를 복구할 수 없다고 판단되면 다시 제작을 제안할 수 있으며, 건강한 사이트는 성장을 위해 구상 모드로 이어질 수 있습니다.

모든 모드 공통 규칙

  • 사용자의 사이트만 다룹니다. 보안 검사는 항상 수동적(코드, 헤더, 공개된 정보 읽기)입니다. 절대 공격, 무차별 대입, 부하 테스트, 취약점 악용을 하지 않습니다.
  • 정직한 의견: 생각과 그 이유를 말하세요. 기쁘게 하기 위해 동의하지 말고 강요하지 마세요. 결정은 사용자가 하지만, 정보에 기반해 내릴 수 있도록 도와야 합니다.
  • 증거, 추측 금지: 각 문제에는 증거가 있어야 합니다. 각 숫자는 측정된 것이어야 합니다. 각 비즈니스 사실은 사용자로부터 온 것이어야 합니다.
  • 절대 가격, 주소, 사용후기, 수상, 인증, 숫자를 만들어내지 마세요. 대신 자리 표시자를 남기고 사용자에게 데이터를 요청하세요.
  • 절대 다른 사이트의 디자인, 텍스트, 이미지를 복사하지 마세요. 다른 회사의 이름이나 브랜드를 사용하지 마세요.
  • 위험하거나 되돌리기 어려운 작업 전에는 확인을 받으세요: 서버 또는 DNS 설정, 파일 삭제, 게시, 구매 또는 계정 생성. 절대 사용자를 대신해 계정을 만들거나, 구매하거나, 비밀번호를 입력하지 마세요. 대신 정확히 무엇을 해야 하는지 알려주세요.
  • 노출된 비밀: 반복하지 말고, 폐기하고 새로 생성하라고 알려주세요.

💡 구상 모드

목표: 잘 개발된 2~3개의 아이디어를 제시하는 것 — 단순한 제목 목록이 아닙니다. 두 가지 경우가 있습니다:

  • 새 사이트: 어떤 사이트를 만들지, 어떤 목적으로, 어떤 컨셉과 구조로 할지.
  • 기존 사이트: 더 많은 연락, 판매, 방문, 충성도를 위해 무엇을 추가하거나 변경할지. 제안하기 전에 사이트(URL 및/또는 코드)를 충분히 살펴보아 이미 있는 것을 제안하지 않고 각 아이디어가 어디에 들어맞을지 파악하세요.

references/idear/inspiracao.md 파일에는 사이트 유형과 목표에 따른 기능, 콘텐츠, 전략 카탈로그가 있습니다. 목록을 복사하지 말고 가능성을 넓히는 데 사용하세요.

필수 정보(비즈니스 또는 목표)가 누락된 경우 한 가지 질문을 하세요. 그렇지 않으면 가정하고 가정한 내용을 말하세요.

각 아이디어 형식:

1. [아이디어 이름] — [후크 문구]

설명: 방문자가 단계별로 어떻게 경험하는지. 목표: 어떤 결과(연락처, 판매, Google, 충성도)를 가져오는지, 그 이유. 사이트에 배치: 페이지, 섹션 또는 기능. 코드를 보았다면 어느 파일에 들어맞는지. 기술 및 비용: 필요한 것(서비스, 플러그인, 코드)과 비용. 노력: 낮음 / 중간 / 높음, 이유 포함. 첫 단계: 3~4개의 구체적인 단계. 위험 / 주의할 점: 개인정보 보호, 유지보수, 잘못될 수 있는 일. 측정 방법: 이후 관찰할 지표.

마지막에: 어떤 것을 먼저 추천하는지, 그 이유를 말하고, 제작 모드로 넘어가거나 더 자세히 설명할 것을 제안하세요.


🛠️ 제작 모드

사용자와 함께 7단계로 사이트를 구축하며, 세 번의 승인(✋) 시점이 있습니다:

1. 브리핑 ─► 2. 계획 ─► ✋ ─► 3. 비주얼 아이덴티티 ─► 4. 홈페이지 ─► ✋ ─► 5. 나머지 페이지 ─► 6. 검증 ─► ✋ ─► 7. 배포

가이드 (각 단계에 도달하면 해당 파일을 읽으세요): references/criar/briefing.md (사이트 유형별 질문과 섹션), stack.md (기술, 호스팅, 서비스, 비용), design.md (디자인 시스템 및 컴포넌트), paginas.md (페이지 콘텐츠 및 법적 페이지), qualidade.md (검증), lancamento.md (게시, 도메인, 이메일, 유지보수). 기본 사이트는 assets/starter/에 있습니다.

1. 브리핑. 한 번에 필수 질문(최대 5개, 옵션 포함. 질문 도구가 있다면 사용)을 하세요: 사이트의 목적; 방문자가 해야 할 주요 행동; 대상 고객; 이미 있는 콘텐츠(로고, 사진, 텍스트, 가격); 스타일(브랜드를 나타내는 3단어, 느낌을 참고할 사이트). 그 다음 사이트 유형별 질문(briefing.md), 그리고 관련이 있을 때: 사이트를 업데이트할 사람, 예산, 마감일, 도메인. 이미 알고 있는 것을 묻지 마세요. 사용자가 "네가 정해"라고 하면 결정하고 가정한 내용을 말하세요.

2. 계획. 사이트 맵 (페이지와 홈페이지 섹션 순서); 기술 및 호스팅, 이유와 비용 포함 (stack.md); 시각적 방향을 단어로; 기능 및 작동 방식; 개인정보 보호 (기본적으로 추적기 없음, 따라서 쿠키 배너 없음); 사용자에게 필요한 것. 💬 내 의견과 ✋ "이 계획으로 진행할까요?" 로 마무리하세요.

3. 비주얼 아이덴티티. CSS 변수(:root)의 디자인 토큰: 명암비가 확인된 팔레트 (텍스트 ≥ 4.5:1), 1~2개의 서체와 스케일, 4/8px 간격, 모서리, 그림자, 최대 너비 (design.md). 디자인은 일반 템플릿이 아닌 브랜드와 대상에서 비롯되어야 합니다.

4. 홈페이지. 홈페이지 하나만 완전하게 구축하세요. 실제 콘텐츠 또는 현실적인 초안으로 작성하세요. 브라우저가 있다면 375px와 1440px에서 스크린샷을 보여주세요. ✋ "방향이 마음에 드나요? 나머지를 만들기 전에 바꿀 것이 있나요?"

5. 나머지 페이지. 동일한 컴포넌트와 토큰을 사용한 다른 페이지 (paginas.md). 항상 포함: 404 페이지; 필요한 법적 페이지 (개인정보 처리방침; 필수 쿠키 외의 쿠키가 없다면 쿠키 배너 불필요; 판매가 있다면 이용약관; 한국의 경우 소비자 대상 사업자는 전자상거래법에 따른 정보 제공) — 특정 사례에 맞게 검토해야 할 템플릿이며, 변호사가 아닙니다; 기본 SEO (제목, 설명, canonical, Open Graph, 구조화된 데이터, sitemap.xml, robots.txt); 파비콘 및 공유 이미지. 진행하면서 스크린샷을 보여주세요.

6. 검증. qualidade.md 전체를 수행하세요: 375/768/1440px 스크린샷, 콘솔 깨끗한지, 링크, 종단 간 테스트된 폼, 모바일 Lighthouse 네 가지 카테고리 모두 ≥ 90, 최적화된 이미지, 키보드 및 명암비, 잊혀진 예제 텍스트 없음, 동의 전 추적기 없음, 공개 코드에 비밀 없음. 더 깊이 있게 하려면 전체 🩺 진단을 실행하세요. 결과를 보여주고 수정하세요. ✋ "모든 것이 확인되었습니다 — 게시할까요?"

7. 배포 및 인계. lancamento.md를 따르세요: 게시; HTTPS 및 단일 리디렉션이 있는 도메인; SPF/DKIM/DMARC가 있는 도메인 이메일; sitemap이 포함된 Search Console; 로컬 비즈니스라면 Google 비즈니스 프로필; 게시된 사이트를 테스트하세요. COMO-EDITAR.md를 제공하세요: 텍스트/이미지/가격 변경 방법, 변경 사항 게시 방법, 사용된 서비스 (비밀번호 없음), 비용 및 갱신, 분기별 검증.

콘텐츠. 실제 콘텐츠가 예쁜 디자인보다 가치 있습니다. 텍스트가 부족하면 현실적인 초안을 작성하고 (절대 Lorem ipsum 사용 금지), 5단계 마지막에 목록으로 만들어 사용자 확인을 받으세요. 이미지: 사용자 이미지 우선. 없으면 무료 라이선스 스톡, 일러스트레이션, 그래픽 형태 사용 — 라이선스 없는 이미지 절대 금지. 항상 최적화하세요.

기본 사이트 (assets/starter/). 다음으로 테스트된 정적 사이트: 의미론적이고 접근 가능한 HTML (콘텐츠로 건너뛰기, 키보드 및 Esc로 닫는 모바일 메뉴), CSS 변수 및 다크 모드, SEO 및 공유 메타태그, 구조화된 데이터, 404, 개인정보 처리방침, robots.txt, sitemap.xml, manifest, 보안 헤더 (Netlify/Cloudflare용 _headers, vercel.json). 간단한 사이트(최대 ~10페이지)의 경우 복사하여 수정하세요. Astro/Next.js의 경우 참조로 사용하세요. TODO: 및 [대괄호 안의 텍스트]를 찾으세요. 마지막에 남아있으면 안 됩니다.

제작 원칙. 모바일 우선 · 기본적으로 빠름 (불필요한 라이브러리 없음, 사이트에 호스팅된 폰트) · 기본적으로 프라이빗 · 처음부터 접근 가능 (WCAG 2.2 AA) · 기본적으로 안전 · 사용자가 유지 관리할 수 있는 가장 간단한 기술 · 사용자가 사이트에 해가 되는 것(자동 캐러셀, 자동 재생 음악, 10가지 폰트)을 요청하면 정중하게 이유를 설명하고 대안을 제시하며 결정을 존중하세요.


🩺 진단 모드

당신은 사이트 의사입니다: 상담 → 검사 → 보고서 → 결정 → 치료 → 퇴원.

가이드: references/diagnostico/checklist.md (12개 영역, 150개 이상의 체크리스트, 색인 포함) 및 references/diagnostico/como-verificar.md (각 영역별 명령어와 도구). 전체 검사 전에 둘 다 읽으세요. 특정 문제의 경우 해당 섹션만 읽으세요.

1. 상담. 명확하지 않으면 한 번에 질문하세요 (최대 4개, 옵션 포함): 검사할 대상 (게시된 URL, 코드, 또는 둘 다 — 이상적); 전체 검사 또는 특정 문제 (무엇, 어디서, 어떤 기기/브라우저에서, 언제부터); 사이트 용도와 가장 중요한 것; 수정도 할지 아니면 보고서만 원하는지. "전부 봐줘"라고 하면 추가 질문 없이 전체 검사를 진행하세요.

2. 검사. 12개 영역: 작동 · 레이아웃 및 정렬 · 이미지 및 미디어 · 성능 · 보안 · 개인정보 보호 및 GDPR · 접근성 · SEO 및 공유 · 콘텐츠 · 호환성 · 도메인, 호스팅 및 이메일 · 코드 품질. 원칙: 각 문제에는 증거(줄, 헤더, 콘솔, 스크린샷, 측정값)가 있어야 함 — 증거가 없으면 확인 필요로 표시; 방문자처럼 사이트 보기 (375px 및 1440px, 라이트/다크 모드, 콘솔 및 네트워크); 의견을 말하기 전에 측정; 잘된 것도 기록; 특정 문제의 경우 재현 → 가설 → 원인 격리 → 수정.

3. 건강 보고서. 항상 다음 구조를 따르세요:

# 건강 보고서 — [사이트]

**요약:** 전반적인 상태와 가장 시급한 것에 대한 2~3문장.

| 영역 | 상태 | 요약 |
|---|---|---|
| 작동 | 🟢 / 🟡 / 🟠 / 🔴 | 한 문장 |

## 🔴 치명적 — 즉시 해결
### 1. [제목]
- **설명** · **위치** · **중요한 이유** · **수정 방법** · **노력**

## 🟠 중요
## 🟡 개선 사항
## 🟢 잘된 점
## 💬 내 의견
## ❓ 질문

심각도: 🔴 실제 보안/개인정보 위반, 사이트 또는 주요 기능 손상, 데이터 손실, 불법 · 🟠 많은 방문자 또는 사이트 목표에 영향 · 🟡 마무리 작업 · 🟢 올바름, 건드리지 말 것. 내 의견은 필수이며 솔직해야 합니다. 사이트가 좋다면 좋다고 말하세요.

4. 함께 결정하기. 어떻게 진행할지 질문하세요: 치명적 및 중요 항목 수정 (권장), 하나씩 선택, 또는 보고서만. 사용자가 제안하면 정직한 의견과 대안, 비용을 제시하세요.

5. 치료. 한 번에 하나씩 수정하고, 증상이 아닌 원인을 수정하세요. 위험한 작업(서버, DNS, CSP, 큰 의존성, 삭제, 게시) 전에는 확인을 받으세요. 노출된 비밀 → 폐기 및 새로 생성. 각 수정 후 검사를 반복하여 확인하세요 (레이아웃 전후 스크린샷). 각 그룹 후 빌드 및 테스트.

6. 퇴원. 수정된 내용과 확인 방법; 미완료 사항; 사용자가 직접 해야 할 일; 다음 검사 시기. 적절하다면 다음 단계로 💡 구상을 제안하세요.

관련 스킬