Communitygithub.com

pikaOne1138/astro-personal-site-starter

지식/블로그 및 도움/전문 서비스 워크숍 아키타입을 위한 세련된 Astro 사이트를 설계, 구축, 개선 또는 감사합니다.

astro-personal-site-starter란 무엇인가요?

이 스킬은 두 가지 주요 콘텐츠 아키텍처(지식/블로그, 도움/전문 서비스)와 세 가지 시각적 개성(종이와 잉크, 아침 햇살, 조용한 작업실)을 결합하여 총 6개의 독립된 코드베이스가 아닌, 2개 아키텍처 × 3개 시각 방향으로 사이트를 구축하는 체계적인 접근 방식을 제공합니다. 주로 프런트엔드 Astro 사이트 제작에 초점을 맞추며, CRM, 인증, 회원 시스템, 맞춤형 예약 엔진, 결제, 데이터베이스, SaaS 관리 등으로 범위가 확장되지 않도록 명확한 가드레일을 설정합니다. 이 스킬은 증거 계층 구조를 통해 디자인 결정을 검증하고, 사용자 여정을 명확하게 정의하며, 정제된 UI 규칙(일관된 간격 척도, 약 60–72ch의 본문 너비, 제한된 컬러 팔레트 등)과 모션 가이드라인을 제공하여 의도적인 디자인이 느껴지는 사이트를 만듭니다. 반응형 디자인 원칙, 품질 게이트, CTA 계층 구조도 포함되어 있어 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 일관되고 높은 품질의 결과물을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/pikaOne1138/astro-personal-site-starter/tree/HEAD/.ai/astro-ui-craft

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

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

문서

Astro UI Craft

디자인된 듯한 느낌이 들고, 단순히 생성된 것이 아닌 웹사이트를 만듭니다.

핵심 모델

두 가지 콘텐츠 아키텍처:

  • 지식 / 블로그
  • 도움 / 전문 서비스

세 가지 시각적 개성:

  • 종이와 잉크 (Paper & Ink)
  • 아침 햇살 (Morning Light)
  • 조용한 작업실 (Quiet Studio)

이를 6개의 독립된 코드베이스가 아닌 2개 아키텍처 × 3개 시각 방향으로 취급합니다.

범위 가드레일

기본 범위는 세련된 프런트엔드 사이트입니다. 외부 폼, LINE, 예약 및 뉴스레터 서비스를 선호합니다. CRM, 인증, 회원 시스템, 맞춤형 예약 엔진, 결제, 데이터베이스 또는 SaaS 관리로 무분별하게 확장하지 마십시오.

증거 계층 구조

  1. 직접 열어본 / 스크린샷 / 계산된 CSS 관찰.
  2. 웹 검색 및 페이지 검증 관찰.
  3. 검증된 사례에서 파생된 교차 사례 패턴.
  4. 디자인 제안 및 합성된 토큰.
  5. 메모리 전용 또는 명시적으로 검증되지 않은 후보 목록.

지식 / 블로그 페이지의 임무

다음 질문에 답하세요:

  • 이 사람은 무엇에 대해 글을 쓰나요?
  • 새로운 독자는 어디서 시작해야 하나요?
  • 특정 주제에 대해 더 많은 정보를 어떻게 찾나요?
  • 왜 이 사람을 팔로우해야 하나요?
  • 다음으로 부담 없는 행동은 무엇인가요?

기본 흐름:

Hero → 여기서 시작/주제 → 추천/최신 → 짧은 소개 → 자료 → 뉴스레터 → Footer

도움 / 전문 서비스 페이지의 임무

다음 질문에 답하세요:

  • 제가 올바른 곳에 왔나요?
  • 이 사람이 제 상황을 이해하나요?
  • 그들은 무엇을 제공하나요?
  • 연락하면 어떻게 되나요?
  • 왜 신뢰할 수 있나요?
  • 다음으로 부담 없는 행동은 무엇인가요?

기본 흐름:

Hero → 공감 → 서비스 → 첫 방문/과정 → 소개/자격 → 신뢰 → FAQ → 예약/연락 → Footer

대략 7 ± 1개의 의미 있는 섹션을 선호합니다.

시각적 개성

종이와 잉크 (Paper & Ink)

따뜻한 종이, 진한 잉크, 세리프 디스플레이 서체, 가는 구분선, 낮은 채도의 이미지, 에디토리얼 목록.

아침 햇살 (Morning Light)

크림색, 클레이/로즈/세이지 강조색, 부드러운 세리프 + 가독성 좋은 산세리프, 넉넉한 모서리 반경, 자연광 이미지, 부드러운 안심감.

조용한 작업실 (Quiet Studio)

거의 흰색에 가까운 따뜻한 회색, 정확한 그리드, 산세리프 위주의 서체, 하나의 강한 강조색, 얇은 테두리, 구조화된 서비스/콘텐츠 메타데이터.

정제된 UI 규칙

  • 장식보다 구조를 먼저.
  • 일관된 간격 척도.
  • 긴 형식의 본문 너비 약 60–72ch.
  • 하나의 주요 강조색 + 중성색.
  • 일관된 이미지 비율과 톤 처리.
  • 눈에 띄는 hover/focus/active 피드백.
  • 네온 퍼플, 과도한 유리 효과, 무작위 벤토 그리드, 반복되는 아이콘-3열 섹션, 거대하고 모호한 그라데이션, 불필요한 카운터/캐러셀/타자기 효과를 피하세요.

내비게이션

데스크톱: [로고] 4–5개 링크 ... [단일 기본 CTA]

  • 지식: 아티클 / 주제 / 여기서 시작 / 소개 + 구독.
  • 도움: 서비스 / 과정 / 소개 / 아티클 / FAQ + 예약/연락.
  • 워크숍 기준에서는 메가 메뉴를 피하세요.

CTA

최대 세 가지 의미 수준:

  • 기본: 구독 또는 첫 상담 예약.
  • 보조: 적합성/과정/무료 자료 이해.
  • 부담 없음: 읽기/탐색/더 알아보기.

도움 페이지 언어: "預約初談", "了解合作方式", "第一次來?先看看流程", "開始聊聊".

모션

  • hover 150–220ms
  • UI 전환 180–350ms
  • 나타나기 400–650ms
  • 이동 4–16px
  • 크기 조정 ~0.98–1.03
  • 일관된 ease-out
  • transform + opacity 선호
  • prefers-reduced-motion 존중

의도된 효과: 사용자는 애니메이션을 의식적으로 인지하지 못할 수 있지만, 사이트가 정성스럽게 만들어졌다는 느낌을 받습니다.

반응형

단순히 데스크톱을 축소하지 마십시오.

  • 데스크톱: ~1080–1200px 컨테이너.
  • 태블릿: 분할 레이아웃/고정 사이드 콘텐츠 단순화.
  • 모바일: 단일 읽기 흐름, 넉넉한 측면 여백, 필요한 경우 전체 너비 컨트롤.
  • 도움 페이지는 콘텐츠를 가리지 않는 경우에만 지속적인 예약 CTA를 사용할 수 있습니다.

품질 게이트

인계 전 확인 사항:

  • 주요 페이지 임무가 명확할 것.
  • 계층 구조가 장식 없이도 올바르게 읽힐 것.
  • 모바일 구성이 작동할 것.
  • 대비/터치 대상/포커스 상태가 사용 가능할 것.
  • 모션이 미묘하고 선택적일 것.
  • 빌드가 성공할 것.
  • 우발적인 백엔드 범위 확장이 없을 것.

관련 스킬