Communitygithub.com

kelgirechandrakant-cpu/statsarthi

최소한의 사전 출시 랜딩 페이지로, 이메일 수집, 브랜드 로고 및 선택적 장식 레이어를 제공합니다. DESIGN.md 파일에서 색상, 타이포그래피 및 레이아웃 규칙을 읽습니다. 제품 출시, 베타 가입, 얼리 액세스 프로그램, 인디 프로젝트에 적합합니다.

statsarthi란 무엇인가요?

이 스킬은 제품 출시 전에 '웨이트리스트(Waitlist)' 페이지를 구축하는 AI 에이전트 전용 도구입니다. 브랜드 아이덴티티, 제품 설명, 이메일 수집 폼 등 필수 요소만 포함된 깔끔하고 모바일 우선의 랜딩 페이지를 생성합니다. 사용자는 `DESIGN.md` 파일을 통해 색상, 폰트 등 시각적 규칙을 정의하고, 템플릿에 포함된 토큰(예: `{{PRODUCT_NAME}}`, `{{BG_EXPRESSION}}`)을 채워 넣기만 하면 됩니다. 본 스킬은 HTML, CSS, SVG 등 모든 입력값을 철저히 검증하여 보안 취약점(CSS/HTML 인젝션 등)을 방지하며, 특히 가짜 카운트다운이나 인위적인 긴급성 조작 없이 진정한 초기 관심을 포착하는 윤리적인 디자인 철학을 따릅니다. Claude Code, Cursor, Codex 등 주요 AI 에이전트 플랫폼과 호환되며, 템플릿 기반의 체계적인 워크플로우를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kelgirechandrakant-cpu/statsarthi/tree/HEAD/.agents/skills/waitlist-page

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

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

문서

대기자 명단 페이지 스킬

출시 전 페이지는 미래 사용자와의 첫 악수입니다. 이 스킬은 집중적이고 정직한 입구를 구축합니다: 브랜드 아이덴티티, 제작 중인 제품, 얼리 리스트에 참여할 수 있는 명확한 경로 하나. 인위적인 희소성, 가짜 카운트다운, 부풀리기 전술은 없습니다. 진정한 관심을 위한 깔끔하고 모바일 우선의 그릇일 뿐입니다.

워크플로우

사전 준비: 강화된 템플릿 및 브랜드 기반 로드

  1. 브랜드 아이덴티티 로드 — DESIGN.md를 읽어 색상 시스템, 글꼴 쌍, 공간 규칙을 확인하세요. 이것이 기본입니다. 대기자 명단 페이지는 그것이 나타내는 브랜드와의 일관성에 따라 성패가 갈립니다. DESIGN.md가 없으면 진행하기 전에 사용자에게 제공을 요청하세요.
  2. 재사용 가능한 템플릿 읽기 및 복사 — assets/template.html을 읽으세요. 이 템플릿은 모든 출력물을 위한 강화된 시드입니다. 기본으로 삼아 index.html로 복사하세요. 처음부터 HTML을 작성하거나 이 구조에서 벗어나지 마세요. 템플릿에는 필요한 모든 레이아웃, 양식 구조, 장식, 포커스 스타일, 접근성 스캐폴딩이 내장되어 있습니다.

단계: 유효성 검사 및 이스케이프를 사용한 토큰 대체

  1. 입력에서 토큰 매핑 — 템플릿의 각 플레이스홀더(예: {{PRODUCT_NAME}}, {{BG_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{LOGO_MARK}})에 대해 아래 대체 규칙을 따르세요:
    • 텍스트 토큰 ({{PRODUCT_NAME}}, {{TAGLINE}}): HTML 텍스트 노드 또는 속성 값에 삽입하기 전에 <, >, &, ", '를 HTML 이스케이프하세요.
    • HTML 토큰 ({{LOGO_MARK}}): 텍스트 이니셜을 사용하는 경우 기본적으로 HTML 이스케이프하세요. 인라인 SVG를 사용하는 경우 허용 목록을 사용하여 엄격하게 삭제해야 합니다: <script> 태그, 이벤트 핸들러(on*), <foreignObject>, 외부 참조(href, xlink:href, url()) 및 허용되지 않는 속성/요소를 삽입 전에 제거하세요. SVG를 안전하게 삭제할 수 없는 경우 이스케이프된 텍스트 이니셜로 대체하세요. 원시적이고 삭제되지 않은 임의의 HTML을 절대 내보내지 마세요. SVG가 컨테이너 내에서 깔끔하게 확장되는지 확인하세요.
    • 색상 표현 토큰 ({{BG_EXPRESSION}}, {{FG_EXPRESSION}}, {{ACCENT_EXPRESSION}}, {{DECO_EXPRESSION}}, {{STRIPE_EXPRESSION}}, {{SUCCESS_EXPRESSION}}, {{BORDER_EXPRESSION}}, {{BTN_LABEL_EXPRESSION}}, {{TICKER_BG_EXPRESSION}}, {{TICKER_FG_EXPRESSION}}, {{DECO_STROKE_EXPRESSION}}, {{LOGO_SHADOW_EXPRESSION}}, {{LOGO_FG_EXPRESSION}}): 명시적 색상 문법(#hex, rgb/rgba, hsl/hsla, oklch 또는 로컬 변수만 사용하는 color-mix())을 엄격히 준수해야 합니다. CSS 주입을 방지하기 위해 ;, {}, <, >, 주석(/*), @, url( 또는 외부 참조가 포함된 입력은 엄격히 거부하세요. #으로 묶거나 추가 따옴표를 추가하지 마세요. 예: rgba(196, 169, 154, 0.38), color-mix(in srgb, var(--fg) 38%, transparent), #FDE8DF. :root CSS 변수에 그대로 삽입하세요. DESIGN.md에 있으면 --success를 파생시키고, 그렇지 않으면 허용된 대체값 #2D6A4F만 사용하세요.
    • 글꼴 이름 토큰 ({{DISPLAY_FONT_CSS}}, {{BODY_FONT_CSS}}): CSS font-family 값이며, 공백이 포함된 경우 이미 따옴표로 묶여 있습니다(예: 'DM Sans', Syne). --font-display 및 --font-body 선언에 그대로 삽입하고 추가 따옴표를 추가하지 마세요.
    • 글꼴 URL 토큰 ({{DISPLAY_FONT_URL}}, {{BODY_FONT_URL}}): Google Fonts URL의 경우 공백을 +로 인코딩해야 합니다(예: DM+Sans, IBM+Plex+Serif). 삽입하기 전에 URL 형식이 올바른지 확인하세요.
  2. 토큰 매핑 규칙 확인 — 모든 색상 토큰은 이제 CSS 변수에 있습니다:
    • --bg = {{BG_EXPRESSION}} (예: #FDE8DF)
    • --fg = {{FG_EXPRESSION}} (예: #1A1410)
    • --accent = {{ACCENT_EXPRESSION}} (브랜드 배지)
    • --deco = {{DECO_EXPRESSION}} (장식 기본)
    • --deco-stripe = {{STRIPE_EXPRESSION}} (강조 줄무늬)
    • --input-border = {{BORDER_EXPRESSION}} (불투명도가 있는 전체 CSS 표현식)
    • --success = {{SUCCESS_EXPRESSION}} 또는 #2D6A4F 대체
    • --btn-label = {{BTN_LABEL_EXPRESSION}} (대비를 위한 버튼 텍스트 색상)
    • --ticker-bg = {{TICKER_BG_EXPRESSION}} (애니메이션 티커 배경)
    • --ticker-fg = {{TICKER_FG_EXPRESSION}} (애니메이션 티커 텍스트)
    • --deco-stroke = {{DECO_STROKE_EXPRESSION}} (SVG 획, 일반적으로 12–15% 불투명도로 음소거)
    • --logo-shadow = {{LOGO_SHADOW_EXPRESSION}} (로고 컨테이너 그림자, 미묘한 전경 음영)
    • --logo-fg = {{LOGO_FG_EXPRESSION}} (로고 이니셜에 대한 대비 텍스트 색상)
  3. 반응형 레이아웃 — 템플릿에는 모바일 우선 스케일링이 포함되어 있습니다:
    • 375px: 양식이 단일 열로 쌓이고, 로고가 40px로 축소되고, 장식이 압축되며, 가로 스크롤이 없습니다.
    • 768px: 편안한 2열 숨쉴 공간.
    • 1440px+: 넉넉한 여백이 있는 중앙 정렬 레이아웃.
    • 모든 텍스트를 읽을 수 있고 이메일 입력 및 버튼이 375×667 및 390×844에서 완전히 표시되는지(잘리지 않음) 확인하세요.

검증: 내보내기 전 강화된 품질 게이트 실행

  1. 품질 체크리스트 실행 — references/checklist.md를 읽으세요. 내보내기 전에 모든 P0 게이트의 유효성을 검사하세요:
    • 정확히 하나의 CTA(이메일 양식)
    • 카운트다운 타이머, 가짜 소셜 프루프, 이모지 없음
    • 375px에서 가로 스크롤 없음
    • 이메일 입력에 type="email" 및 required가 있고, 이름(선택 사항)에는 required가 없음
    • 양식이 novalidate를 사용하지 않음, JS는 checkValidity() 가드를 사용
    • 성공 메시지에 role="status" 또는 aria-live="polite"가 있음
    • 모든 색상은 DESIGN.md 또는 허용된 대체값에서 가져옴, 발명된 16진수 값 없음
    • 모든 사용자 텍스트는 HTML 이스케이프 처리됨, 색상 토큰은 엄격한 문법 준수, 글꼴은 URL 인코딩됨
    • P0 통과 또는 내보내지 않음. P0 게이트가 실패하면 사용자에게 문의하거나 토큰 매핑을 수정하고 다시 시도하세요.
  2. P1 게이트 확인 (품질 제출 권장):
    • 제출 버튼에 호버 및 활성 상태
    • 명확한 피드백이 있는 양식 유효성 검사
    • 티커 애니메이션이 prefers-reduced-motion: reduce를 존중
    • 모든 대화형 요소에 가시적 포커스 스타일(input:focus에 outline 포함)
    • Tab/Enter 키보드 지원
    • 본문 텍스트(≥4.5:1) 및 버튼 레이블(≥4.5:1)에 대한 WCAG AA 대비
    • 로고 alt/aria-label 있음, 티커에 aria-hidden="true"
    • <html lang=""> 설정됨

출력

  1. 깔끔한 HTML 내보내기 — 단일 파일, CSS 인라인, 그래픽용 SVG. 대화형 요소를 data-od-id(헤드라인, 양식, 로고, 티커, 그리드 등)로 표시하여 에이전트가 구문 분석 없이 사용자 정의할 수 있도록 합니다.

품질 게이트

이 스킬은 규정 준수를 보장하기 위해 강화된 템플릿 기반 워크플로우를 적용합니다. 이 실행 경로를 따라야 하며, 템플릿에서 벗어나면 출력물이 무효화됩니다.

필수 템플릿 기반 실행:

  • 기본으로 assets/template.html을 읽으세요. 처음부터 HTML을 작성하지 마세요.
  • index.html에 복사하고 {{PLACEHOLDER}} 토큰만 유효성 검사/이스케이프된 값으로 바꾸세요.
  • 내보내기 전에 references/checklist.md의 모든 P0 게이트를 실행하세요. 실패하면 수정하고 재검증하세요.

P0 게이트(통과 필수):

  • 단일 CTA: 이메일 양식이 유일한 대화형 요소입니다. 탐색, 보조 버튼, 소셜 링크가 없습니다.
  • 로고 배치: 왼쪽 상단 고정, DESIGN.md 강조 색상 일치, 모바일에서 축소(50px → 40px).
  • 색상 일관성: 모든 색상은 DESIGN.md 팔레트에서 가져옵니다. 허용된 하드코딩 예외: --success용 #2D6A4F만 가능.
  • 안티 패턴 없음: 카운트다운 타이머, 가짜 소셜 프루프, 이모지 아이콘, 로렘 입숨이 없습니다.
  • 콘텐츠 무결성: 헤드라인과 카피는 product_name 및 tagline 입력에 직접 연결됩니다. 채우기 카피가 없습니다.
  • 모바일 적합: 375px에서 가로 스크롤이 없습니다. 이메일 입력 및 제출 버튼이 375×667 및 390×844에서 완전히 표시됩니다(잘리지 않음). 세로 오버플로는 스크롤 가능하며 숨겨지지 않습니다.
  • 타이포그래피 규율: 표시 + 본문 글꼴만 사용(2글꼴 규칙). 섹션 전체에서 일관된 크기.
  • 양식 구조: 두 개의 필드(이름(선택 사항), 이메일(필수)), checkValidity() 가드, role="status"가 있는 성공 메시지.
  • 토큰 이스케이프: 사용자 제공 텍스트는 HTML 이스케이프 처리됨. 색상 토큰은 엄격한 문법을 준수하고 안전하지 않은 문자(;, {}, <, >, /*, @, url()를 포함하지 않음. 글꼴 이름은 URL 인코딩됨. {{LOGO_MARK}}는 이스케이프된 텍스트 이니셜이거나 엄격히 삭제된 인라인 SVG여야 함(스크립트, 이벤트 핸들러, foreignObject, 외부 href 없음).

P1 게이트(품질 제출을 위해 통과 권장):

  • 히어로 섹션이 시각적으로 구별되고 접힌 부분 위에 표시됨.
  • 이메일 제출 버튼에 호버 및 활성 상태가 있음.
  • 양식 유효성 검사가 명확한 피드백을 제공함.
  • 모든 모바일 뷰포트에서 페이지를 스크롤할 수 있음(잘리지 않음). CTA가 스크롤 없이 표시됨.
  • 티커 애니메이션이 prefers-reduced-motion: reduce에서 일시 중지/제거됨.
  • 모든 대화형 요소에 가시적 포커스 스타일(outline, outline:none만 있는 경우 제외)이 있음.
  • 키보드: Tab이 각 양식 필드에 도달함. Enter가 제출함.
  • WCAG AA 대비: 본문 텍스트 ≥4.5:1, 버튼 레이블 ≥4.5:1.
  • 로고 alt/aria-label 있음. 티커에 aria-hidden="true".
  • <html lang="">이 올바른 언어 코드로 설정됨.

장식 절제:

  • 하단 영역은 산만함 없이 향상시킵니다. 불투명도, 미묘한 획, 음소거된 애니메이션.
  • 뷰포트 높이의 20% 이상을 차지하는 그라데이션이 없습니다.
  • 코일, 줄무늬, 그리드 또는 티커는 모두 DESIGN.md의 색상만 사용합니다.

출력

references/checklist.md의 모든 P0 게이트를 통과한 후에만 내보냅니다.

아티팩트를 다음 태그 사이에 내보냅니다:

<artifact identifier="waitlist-id" type="text/html" title="Coming Soon — {{PRODUCT_NAME}}">
<!doctype html>
<html lang="en">
...
</html>
</artifact>

아티팩트 위에 한 줄 설명, 아래에는 아무것도 없음.

내보내기 후: 사용자가 변경을 요청하면 index.html을 제자리에서 업데이트하고 다음 버전을 내보내기 전에 P0 체크리스트 게이트를 다시 실행하세요. 반복 시 검증을 건너뛰지 마세요.

Individual skills in this repo

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

관련 스킬