Communitygithub.com

Xipher-Labs/walter-os

Astro + Tailwind + shadcn/ui 스타일 컴포넌트를 사용하여 4~8시간 안에 고품질 랜딩 페이지를 출시합니다. 신제품 출시, 해커톤 아이디어 검증, 제품 페이지 리뉴얼 등에 적합합니다. 결과물은 Vercel에 배포되며, 폼 캡처, 분석, 메타 태그가 포함됩니다.

walter-os란 무엇인가요?

이 스킬은 개발자가 Astro, Tailwind CSS, shadcn/ui 스타일 컴포넌트, Vercel을 사용하여 4~8시간 내에 고품질 랜딩 페이지를 제작하고 배포할 수 있도록 설계되었습니다. 특히 B2B/SaaS 제품, 해커톤 아이디어 검증, 기존 제품 페이지 리뉴얼에 최적화되어 있으며, 성능과 SEO가 기본적으로 내장되어 있습니다. 스킬은 구조화된 섹션 템플릿(히어로, 사회적 증명, 문제/해결, FAQ 등), 시간별 타임라인, 성능 예산(Lighthouse 95점 이상), 그리고 폼 캡처 및 분석(Plausible) 설정을 제공합니다. 또한 `frontend-quality` 규칙(접근성, Core Web Vitals, 모바일 우선)과 `web-security-baseline` 헤더를 자동으로 통합하여 개발자가 별도로 고민할 필요가 없도록 합니다. 결과물은 Vercel에 바로 배포되며, Resend(이메일) 또는 Supabase(대기자 DB)를 통한 폼 캡처, Plausible 분석이 포함됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Xipher-Labs/walter-os/tree/HEAD/skills/landing-page-fast

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

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

문서

빠른 랜딩 페이지 제작 (Landing Page Fast)

의견이 반영된 랜딩 페이지 제작 방법입니다. 결정은 이미 내려져 있습니다. 결과물: 4~8시간 내에 작동하고 배포되며 브랜드에 맞는 페이지를 제공합니다. 몇 주가 걸리지 않습니다.

이 스킬은 frontend-quality 규칙(a11y, Core Web Vitals, 모바일 우선)과 web-security-baseline 헤더를 내장하고 있으므로, 빌드하는 동안 따로 고민할 필요가 없습니다.

스택 (기본값 — 특별한 이유 없이 변경하지 마세요)

  • Astro + Tailwind + shadcn/ui 스타일 컴포넌트 + Vercel.
  • TypeScript strict 모드.
  • 이미지 최적화를 위한 astro:assets.
  • 멀티 페이지인 경우 astro:transitions (최소한으로 유지 — 단일 페이지가 출시 속도가 더 빠릅니다).

변경해야 하는 경우:

  • 인증 게이트 / 동적 사용자별 콘텐츠가 필요하고 전체 앱으로 발전하는 경우 → Astro 대신 Next.js 15 App Router를 사용하세요.
  • 운영자가 이미 프로젝트에 SvelteKit을 표준으로 사용하고 있는 경우 → 그것을 사용하세요.

사용하지 마세요: WordPress, Wix, 프레임워크 없는 원시 HTML+JS, Tailwind 없는 바닐라 CSS. 출시 속도가 느리고 유지보수가 어렵습니다.

섹션 구조 (B2B/SaaS 기술 사용자 대상으로 입증됨)

다음 순서를 따르세요. 명확한 이유 없이 건너뛰지 마세요:

  1. 히어로 — 헤드라인 + 부제목 + 주요 CTA + 시각적 요소
  2. 사회적 증명 — 로고, 통계 배너, 사용후기 (실제일 경우에만)
  3. 문제 — 현재 상태의 문제점 (여기서 신뢰도를 얻습니다)
  4. 해결책 — 어떻게 해결하는지 (최대 3가지 기능)
  5. 작동 방식 — 다이어그램 또는 스크린샷이 포함된 3~4단계
  6. 사용 사례 — 2~3개의 페르소나, 그 이상은 안 됨
  7. 가격 — 정말 불가능하지 않다면 가격을 표시하세요
  8. FAQ — 5~8개의 실제 질문, 실제 답변
  9. 최종 CTA — 가치 재강조, 행동 반복
  10. 푸터 — 법적 정보, 소셜, 연락처

"회사 소개 / 팀" 섹션은 창업자 신뢰도가 판매에 중요한 경우에만 포함하세요 (대부분의 B2B 인프라 제품: 건너뛰기; 창업자 주도 소비자 제품: 포함).

히어로 구성

[헤드라인: 6~10단어, 가치 약속]
[부제목: 15~25단어, 누가/무엇을/왜]
[주요 CTA] [보조 CTA — "작동 방식 보기"]
[시각적 요소: 스크린샷, 다이어그램 또는 30초 데모 루프]

헤드라인 규칙:

  • 기능이 아닌 결과를 약속하세요.
  • 추상적이기보다 구체적으로.
  • SEO 및 자격 확인을 위해 주요 키워드를 포함하세요.

예시:

  • ❌ "현대 앱을 위한 강력한 인프라"
  • ✅ "p99 50ms 미만의 Solana RPC 인프라"
  • ❌ "공개 입찰을 위한 투명한 플랫폼"
  • ✅ "10분 안에 공개 입찰에 참여하세요"

프로젝트별 기본값

[프로젝트 A] 랜딩 페이지

  • 주요 현지화 시장, 두 번째 로케일이 필요한 경우 /en에 영어 제공.
  • 히어로: 하나의 입찰 카드가 강조된 대시보드 스크린샷.
  • 신뢰 신호: 법적 참조(관련 규정 준수 배지), 감사 로고, 해당되는 경우 규제 인증.
  • 색상: 브랜드 기본 색상 + 중립 크림 + 절제된 악센트.
  • 모바일 우선 필수 요구 사항: 대부분의 사용자가 휴대폰을 사용합니다.
  • 폼 캡처: WhatsApp + 이메일 (중소기업 대상 아르헨티나에서는 WhatsApp이 매우 중요합니다).

[프로젝트 B] 랜딩 페이지

  • 주요 현지화 시장, 두 번째 로케일이 필요한 경우 /en에 영어 제공.
  • 신뢰, 신뢰, 신뢰. 규정 준수 배지, 암호화 시각화, 환자 통제 메시지.
  • 사진 스타일: 따뜻하고 인간적이며, 기술적/차갑지 않음.
  • 색상: [프로젝트 A]보다 따뜻한 팔레트 (테라코타, 세이지, 크림).
  • 폼은 최소한으로 — 이메일 + "저는 [환자 | 의사 | 클리닉]입니다" 선택기만.
  • 개인정보 보호 고지가 눈에 띄게 표시 (해당 지역 환자 권리 및 개인 데이터 보호법 참조).

[회사] 제품 페이지

  • 영어 우선, 현지화 없음.
  • 코드 중심. 복사-붙여넣기가 가능한 라이브 스니펫.
  • 성능 수치가 모든 곳에 표시 ("p99 < 50ms", "100k TPS"), 벤치마크 방법론 링크 포함.
  • 무료 티어 가입 CTA.
  • 색상: brand-creation 출력의 [회사] 브랜드 팔레트.

시간별 타임라인

1시간: 설정

pnpm create astro@latest <project> -- --template basics --typescript strict
cd <project>
pnpm add @astrojs/tailwind @astrojs/sitemap @astrojs/vercel
pnpm dlx astro add tailwind sitemap vercel
pnpm add -D @astrojs/check

Vercel 프로젝트 초기화 (CLI가 Astro를 자동 감지합니다):

pnpm dlx vercel link
pnpm dlx vercel deploy --prod  # 기본 빈 배포, 파이프라인 검증

2~3시간: 카피 + 구조

  • 먼저 마크다운으로 카피를 작성하세요 (docs/landing-copy.md).
  • 카피가 실제로 완성될 때까지 디자인하지 마세요.
  • 섹션별로 진행. 빌드하는 동안 모바일 우선 뷰포트를 유지하세요.

4시간: 시각적 다듬기

  • nanobanana 스킬 또는 실제 스크린샷을 사용한 히어로 시각적 요소.
  • 섹션 일러스트레이션 일관성 유지 (한 가지 스타일 — 혼합하지 마세요).
  • Tailwind 간격 척도를 엄격히 준수 (임의 값 사용 금지).

5시간: 폼 + 분석

  • 폼은 Vercel Edge 함수를 통해 Resend(트랜잭션 이메일) 또는 Supabase(대기자 DB)로 전송됩니다.
  • Plausible 스크립트 (Walter-VM 또는 클라우드 €9/월에 자체 호스팅).
  • 전체 흐름 테스트: 폼 → 이메일 확인 → DB 행.

6시간: SEO + 헤더

  • 페이지별 메타 태그 (title, description, og:, twitter:).
  • 표준 URL (Canonical URL).
  • JSON-LD 구조화된 데이터 (Organization 또는 Product).
  • Robots.txt + sitemap.xml (Astro 플러그인이 자동 생성).
  • 보안 헤더 (vercel.json 또는 미들웨어에):
    {
      "headers": [{
        "source": "/(.*)",
        "headers": [
          { "key": "Strict-Transport-Security",
            "value": "max-age=31536000; includeSubDomains; preload" },
          { "key": "X-Content-Type-Options", "value": "nosniff" },
          { "key": "Referrer-Policy", "value": "strict-origin-when-cross-origin" },
          { "key": "Permissions-Policy",
            "value": "camera=(), microphone=(), geolocation=()" },
          { "key": "Content-Security-Policy",
            "value": "default-src 'self'; img-src 'self' data: https:; style-src 'self' 'unsafe-inline'; script-src 'self' https://plausible.io" }
        ]
      }]
    }
    

7시간: 성능 통과

  • Lighthouse 실행. 모든 4개 점수 ≥ 95.
  • 이미지 크기 올바르게 설정 (차세대 형식, 뷰포트에 맞게 크기 조정).
  • 초기 번들 압축 후 < 150KB.
  • LCP 요소 사전 로드.

8시간: 배포 + 확인

  • Vercel을 통한 사용자 정의 도메인 (Cloudflare DNS가 Vercel을 가리킴).
  • 프로덕션 배포.
  • 실제 휴대폰에서 테스트.
  • Google Search Console에 제출.
  • 첫 번째 분석 이벤트가 기록됨.

성능 예산 (엄격)

지표예산도구
Lighthouse 성능≥ 95CI
Lighthouse 접근성≥ 95CI
Lighthouse 모범 사례≥ 95CI
Lighthouse SEO≥ 95CI
3G에서 LCP< 2.5초WebPageTest
INP p75< 200msRUM (Plausible 활성화 시 또는 web-vitals 라이브러리)
CLS< 0.1RUM
초기 JS 압축 후< 150KBbundlewatch
최초 바이트까지 시간< 200msVercel Edge

지표 중 하나라도 실패하면: 출시 전에 수정하세요. 성능이 나쁜 마케팅 페이지는 전환율을 즉시 떨어뜨립니다.

카피 규칙

기술 제품([회사])의 경우:

  • 고객이 검색하는 명사로 시작하세요 ("Solana RPC").
  • 초반에 통계를 제시하세요 — 처음 5초 안에 믿을 이유를 제공하세요.
  • 보여주는 것이 말하는 것보다 낫습니다: 코드 스니펫, 스크린샷, 실제 숫자.
  • 하나의 CTA를 반복하세요.

소비자 / 현지화된 시장([프로젝트 A], [프로젝트 B])의 경우:

  • 쉬운 단어, 짧은 문장.
  • 사용자가 스스로에게 묻는 질문으로 시작하세요.
  • 신뢰 신호(규정 준수, 보안 배지)를 더 눈에 띄게 배치하세요.
  • 여러 CTA 허용 (가입, 더 알아보기, 문의하기).

폼 캡처

// Vercel Edge 함수: /api/signup.ts
export const config = { runtime: 'edge' }

export default async function handler(req: Request) {
  if (req.method !== 'POST') return new Response('Method Not Allowed', { status: 405 })

  const { email, source } = await req.json()

  // Vercel KV / Upstash를 통한 IP 기반 속도 제한
  // zod로 이메일 유효성 검사
  // Supabase 대기자 테이블에 삽입 (RLS 보호)
  // Resend를 통해 확인 이메일 트리거
  // 200 또는 특정 오류 반환

  return Response.json({ ok: true })
}

절대 하지 마세요:

  • 클라이언트가 제출 상태를 "기억"하도록 신뢰하지 마세요.
  • 서버 측 유효성 검사를 건너뛰지 마세요.
  • 속도 제한을 잊지 마세요 (한 명의 사용자, 하나의 봇, 하나의 DDoS — 모두 동일한 버그).

분석 기본값

Plausible (Walter-VM 또는 클라우드에 자체 호스팅):

<script defer data-domain="[project-a].com.ar" src="https://plausible.<domain>/js/script.js"></script>

추적:

  • 페이지 뷰 (기본값)
  • 외부 링크 클릭 (data-domain="..." data-track-outbound="true")
  • 폼 제출 (사용자 정의 이벤트)
  • 긴 페이지의 스크롤 깊이 (사용자 정의 이벤트, 디바운스 처리)

하지 마세요:

  • Google Analytics를 추가하지 마세요. 무겁고, 프라이버시에 적대적이며, EU-AAR에서 모호합니다.
  • 세션 리플레이 도구를 추가하지 마세요. 특히 [프로젝트 B]의 경우 (PHI 위험).
  • 히트맵을 추가하지 마세요. 무겁고 소름 끼칩니다.

안티 패턴 (하지 마세요)

  • 캐러셀 히어로 — 아무도 1슬라이드 이후를 클릭하지 않습니다.
  • 너무 많은 CTA — 히어로에 "가입하기" + "더 알아보기" + "데모 보기" + "블로그 읽기" = 결정 장애.
  • 다양한 인종의 미소 짓는 사람들의 스톡 사진 — 즉시 "평범한 SaaS" 신호.
  • 50개의 작은 경쟁사 로고가 움직이는 마키 — 읽을 수 있는 4~6개를 선택하세요.
  • 기능의 벽 — 3개 또는 6개를 선택하고, 27개는 안 됩니다.
  • 소리가 포함된 자동 재생 비디오 — 즉시 이탈.
  • 페이지 로드 전 모달 팝업 — 즉시 이탈.
  • 페이지를 차단하는 쿠키 배너 — EU에서 불법이며, 모든 곳에서 짜증납니다. 최소한의 차단되지 않는 알림을 사용하세요.

A/B 테스트 시기

주당 방문자가 1,000명 이상이 될 때까지 하지 마세요. 그 이하에서는 노이즈가 지배적입니다.

준비가 되면:

  • 한 번에 하나의 요소만 테스트하세요 (헤드라인, 히어로 시각적 요소, CTA 카피).
  • Vercel A/B 테스트 또는 Plausible의 분할 테스트를 사용하세요.
  • 승자를 선언하기 전에 통계적 유의성을 확인하세요.

엄격한 규칙

  • 8시간 예산은 엄격합니다. 6시간째에 여전히 디자인 중이라면, 7시간 작업을 배송하고 8시간 다듬기는 건너뛰세요. 저장소에 완벽한 것보다 라이브에 불완전한 것이 낫습니다.
  • 모든 외부 스크립트는 감사합니다. "하는 김에 Hotjar / FullStory / Drift를 추가하자"는 안 됩니다. 각 스크립트는 페이지를 느리게 하고 프라이버시 위험을 추가합니다.
  • 프리뷰 배포 승인 없이 프로덕션 변경은 안 됩니다.
  • Lighthouse 실패 = 출시 차단.

통합

  • nanobanana — 히어로 / 일러스트레이션 생성.
  • brand-creation 출력 — 팔레트, 타이포그래피, 톤.
  • frontend-quality 규칙 내장 (a11y + 성능).
  • web-security-baseline 헤더 내장.
  • seo-keyword-research (연기된 백로그) — 카피와 메타에 정보 제공.
  • pr-review 스킬 — 병합 전 최종 검토.

이 스킬이 하지 않는 것

  • 인증, 대시보드 등이 있는 멀티 페이지 앱 → Next.js로 시작하세요.
  • 블로그 설정. Astro Starlight 또는 Mintlify 스타일 문서 프레임워크를 사용하세요.
  • 이메일 마케팅 자동화. ConvertKit / Beehiiv를 사용하세요.
  • 고객 지원 채팅. 꼭 필요하다면 Crisp를 사용하세요 (아르헨티나 옵션, 다국어 지원).

Individual skills in this repo

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

관련 스킬