Communitygithub.com

YuukiMarine/websiteskills

대화만으로 웹사이트를 구축하고 배포합니다. 요구사항을 수집하고, 검증된 site.json을 생성하며, Sitesmith 템플릿으로 렌더링한 후 Nginx로 게시합니다. '웹사이트 만들어 줘', 랜딩 페이지, 개인/비즈니스 사이트, 포트폴리오에 사용하세요.

websiteskills란 무엇인가요?

이 스킬은 사용자와의 대화(3~5턴)만으로 완전한 웹사이트를 구축하고 배포하는 대화형 웹사이트 빌더입니다. 핵심 철학은 '데이터(코드 아님)'를 출력하는 것으로, 사용자 요구사항을 수집하여 하나의 `site.json` 파일을 생성하고, 미리 정의된 잘 설계된 템플릿(Sitesmith)이 이를 렌더링합니다. 이를 통해 출력 결과가 안정적이고 추후 스타일 변경(리스킨)이 용이합니다. 단일 페이지, 다국어(예: 한국어+영어), 다중 페이지(블로그 포함) 사이트를 지원하며, Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 실행 가능합니다. 절차는 요구사항 수집 → site.json 초안 작성 → 검증(validate.mjs) → 렌더링(render.mjs) → 배포(deploy.sh, Nginx/HTTPS)로 이어지며, 사용자는 언제든지 대화로 사이트를 수정할 수 있습니다. 주요 레퍼런스 파일(schema, sections, theme, assets, 예제)을 제공하여 정확성과 일관성을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skill

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

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

문서

Sitesmith — 대화형 웹사이트 빌더

몇 번의 대화만으로 완성된, 선택적으로 이중 언어를 지원하는 웹사이트를 만들어 게시합니다. 코드가 아닌 데이터, 즉 단일 site.json 파일을 생성하며, 고정적이고 잘 설계된 템플릿이 이를 렌더링합니다. 이렇게 하면 출력 결과가 안정적이고 추후 리스킨이 가능합니다.

사용 시기

사용자가 웹사이트, 랜딩 페이지, 개인/비즈니스 사이트 또는 포트폴리오를 만들거나 업데이트하려 할 때 사용합니다. 예: "내 사이트 만들어 줘", "我想做个网站", "내 홈페이지 업데이트", "내 빵집 랜딩 페이지 만들어 줘".

빠른 참조

참조 파일 — skill_view("sitesmith", "<path>")로 필요할 때만 로드하세요.

  • references/site.schema.json — 모든 site.json이 반드시 충족해야 하는 계약(스키마).
  • references/sections.md — 14가지 섹션 유형 (posts 포함): 사용 시기, 필드, 복사 제한.
  • references/theme.md — 테마 토큰 (템플릿, 색상, 글꼴, 둥글기, 밀도).
  • references/assets.md — 이미지 전략 (placeholder / unsplash; 자산을 임의로 생성하지 마세요).
  • references/examples/innoe.site.json — 완전한 단일 페이지 예제 (few-shot).
  • references/examples/multipage.site.json — 다중 페이지 + 블로그 예제 (few-shot).

스크립트 — 터미널 도구를 통해 실행:

작업명령어
검증node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json>
렌더링node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir>
배포bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <domain>

절차

  1. 요구사항 수집 (3~5턴, 그룹 질문 — 심문하지 마세요).

    • 비즈니스 이름 + 한 줄 설명; 업종 + 고객층.
    • 주요 목표 (전화 / 예약 / 가입 / 판매 / 전시).
    • 언어 — 기본적으로 채팅 언어를 사용; 이중 언어(예: en + ko) 제안.
    • 범위: 단일 페이지 또는 다중 페이지? 기본값은 단일 페이지. 더 많은 페이지를 원하거나 블로그를 언급하면 표준 세트(홈 / 소개 / 서비스 / 블로그 / 연락처)를 제공하고 사용자가 조정할 수 있도록 함 — 구축 전에 페이지 목록을 확인.
    • 상위 3~5개 서비스/제품; 차별점; 실제 숫자; 연락처 정보 + 주요 클릭 유도 문구.
    • 한두 단어로 표현하는 분위기 (→ theme); 자산 (로고? 브랜드 색상? 실제 사진?).
    • 사용자가 간결하거나 "그냥 예쁘게 만들어 줘"라고 하면 합리적인 기본값으로 진행 (단일 페이지가 안전한 기본값).
  2. site.json 초안 작성 — references/site.schema.json을 준수해야 합니다. 먼저 해당 예제를 연구하세요 (단일 페이지는 innoe.site.json, 다중 페이지는 multipage.site.json). 실제 콘텐츠에 맞는 페이지당 5~8개 섹션을 선택하세요 (references/sections.md에서 목표→섹션 구성표 참조).

    • 단일 페이지: 모든 내용은 최상위 sections에 들어갑니다.
    • 다중 페이지: 홈은 최상위 sections에 유지; pages[]를 추가 (각 하위 페이지마다 하나의 항목, 각각 자체 sections 포함). 내비게이션은 페이지에서 자동 파생됩니다. 블로그는 posts 섹션이 있는 페이지입니다 (가벼움: 헤드라인 카드, 기사 페이지 없음).
    • 디자인 선택 (references/theme.md 참조): 브랜드가 강하고 명확한 미적 감각을 가질 때만 스타일 템플릿(newchinese/cyber/portfolio)을 사용하거나, 기본값으로 template:"pro"를 사용하고 비즈니스 느낌에 맞게 직접 맞춤형 팔레트 (primary/accent/neutral/font/radius/density)를 디자인하여 각 사이트가 고유하도록 하세요. 모든 이미지는 references/assets.md에 따라 처리합니다.
  3. 검증. validate.mjs를 실행합니다. 실패 시 오류를 읽고 JSON을 수정한 후 다시 실행하세요. 유효하지 않은 파일로 절대 진행하지 마세요.

  4. 렌더링. render.mjs <site.json> <out-dir> 실행 → <out-dir>/dist에 정적 사이트 생성. UNSPLASH_ACCESS_KEY가 설정되어 있으면 렌더링 시 unsplash 플레이스홀더를 실제 사진(크레딧 포함)으로 자동 교체; 키가 없으면 테마 플레이스홀더가 렌더링됩니다. 둘 다 배포해도 괜찮습니다.

  5. 미리보기 및 반복. 구축한 내용을 일반 언어로 요약하세요 ("5페이지 이중 언어 사이트: 홈, 소개, 서비스, 저널, 연락처" 또는 "6개 섹션 단일 페이지"). 사용자에게 사이트가 완전히 편집 가능하다고 알리세요 — 언제든지 페이지나 섹션을 추가/제거하고, 카피를 다시 작성하고, 색상을 변경하거나 블로그 게시물을 추가하도록 요청할 수 있습니다. 전체 site.json을 다시 내보내고 다시 검증 + 다시 렌더링하여 수정 사항을 적용합니다.

  6. 배포 (사용자가 미리보기를 승인한 후에만). deploy.sh <out-dir> <domain> 실행 → HTTPS와 함께 Nginx로 라이브 배포. 라이브 URL을 보고합니다.

주의 사항

  • 출력은 데이터이지 코드가 아닙니다. site.json만 생성하세요. 직접 HTML/CSS를 작성하지 마세요.
  • 스키마는 법입니다. 필드 이름과 열거형 값은 정확히 일치해야 하며, 알 수 없는 필드는 생략합니다.
  • 자산을 임의로 만들지 마세요. 미디어 type:"placeholder"(장식용) 또는 query가 있는 "unsplash"(콘텐츠 사진)를 사용하세요. "image"는 사용자가 제공한 실제 URL이 있는 경우에만 사용합니다. 로고는 실제 로고 파일이 없으면 기본적으로 type:"text"입니다.
  • 기능/서비스에는 이미지보다 아이콘을 선호 — Lucide 이름은 항상 렌더링되고 색상이 변경됩니다.
  • 모든 LocalizedText는 사이트의 모든 언어를 포함합니다. 관용적으로 번역하고, 절대 하나를 비워두지 마세요.
  • 과도하게 구축하지 마세요. 5~8개 섹션. 섹션 배경을 번갈아 사용하고, dark 또는 primary가 연속으로 두 번 오지 않도록 하세요. 항상 hero로 시작하고 cta 또는 contact로 끝냅니다.
  • 규정 위험 주장 금지 — 사용자가 언급하지 않은 인증, 보증, 정부 보조금/지원금, 수상 내역 또는 통계는 절대 포함하지 마세요.
  • 단일 페이지가 기본값입니다. 사용자가 더 풍부한/다중 페이지 사이트나 블로그를 원할 때만 pages[]를 추가하고, 먼저 페이지 목록을 확인하세요. 블로그(posts)는 헤드라인 목록이지 전체 기사가 아닙니다. 그렇게 말하고, 기사는 나중에 추가할 수 있다고 알리세요.

검증

  • validate.mjs가 0으로 종료됩니다 (해결된 섹션 순서를 출력합니다).
  • render.mjs가 <out-dir>/dist/index.html을 생성합니다.
  • 배포 후 curl -I https://<domain>이 200을 반환합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬