Communitygithub.com

랜딩 페이지 생성기

저장소의 문서와 구조를 분석하여 완전하고 배포 가능한 랜딩 페이지를 생성합니다. 오픈소스 프로젝트 홈페이지, 프로젝트 웹사이트 구축, README를 마케팅 페이지로 변환하거나 여러 저장소의 랜딩 페이지를 표준화할 때 사용하세요.

랜딩 페이지 생성기란 무엇인가요?

이 스킬은 GitHub 저장소를 분석하여 완전한 정적 랜딩 페이지(HTML + CSS + JS)를 생성합니다. README.md, CHANGELOG.md, package.json 등에서 제목, 태그라인, 기능, 설치 방법, 스크린샷을 추출하여 Hero, Features, Install, FAQ, Footer 등의 섹션으로 자동 매핑합니다. --risk-banner, --pricing-table과 같은 옵션으로 위험 배너나 가격표를 추가할 수 있으며, GitHub Actions 워크플로우를 포함해 GitHub Pages에 바로 배포할 수 있습니다. Claude Code, Cursor 등 AI 에이전트에서 `/landing-page-generator from <path>` 명령어로 실행할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/examples/skills/landing-page-generator

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

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

문서

랜딩 페이지 생성기은(는) 무엇을 하나요?

저장소의 문서와 구조를 분석하여 완전하고 배포 가능한 랜딩 페이지를 생성합니다.

언제 이 스킬을 사용할까요

  • GitHub 저장소의 랜딩 페이지를 만들 때
  • 기존 문서로부터 정적 사이트를 생성할 때
  • 여러 프로젝트에 걸쳐 랜딩 페이지를 표준화할 때
  • README 콘텐츠를 마케팅/쇼케이스 페이지로 변환할 때

이 스킬이 하는 일

  1. 저장소 분석: README.md, CHANGELOG.md, package.json/VERSION, docs/, assets/ 읽기
  2. 콘텐츠 추출: 제목, 태그라인, 기능, 설치 방법, 스크린샷 식별
  3. 섹션 매핑: Hero, Features, Install, FAQ, Footer (+ 선택 사항: Risk Banner, Pricing)
  4. 랜딩 페이지 생성: 완전한 정적 사이트(HTML + CSS + JS) 생성
  5. 배포 준비 완료: GitHub Pages용 GitHub Actions 워크플로우 포함

사용 방법

기본 사용법

/landing-page-generator from ~/path/to/repo

옵션과 함께 사용

/landing-page-generator from ~/path/to/repo --risk-banner --pricing-table

사용 가능한 옵션

옵션설명기본값
--risk-banner화면 상단에 눈에 띄는 경고/면책 배너 추가false
--pricing-table가격 비교 섹션 포함false
--screenshots <path>스크린샷 폴더 경로./assets/
--theme [dark|light]색상 테마 선택dark
--searchCmd+K 검색 활성화true
--output <path>출력 디렉토리./[저장소명]-landing/

워크플로우

1단계: 저장소 분석

다음 파일들을 소스 저장소에서 읽고 분석합니다:

README.md        → 주요 콘텐츠 소스 (제목, 태그라인, 기능, 설치 방법)
CHANGELOG.md     → 버전 정보, 최근 변경 사항
package.json     → 버전 번호, 의존성, 메타데이터
VERSION          → 대체 버전 소스
docs/            → 추가 문서 페이지
assets/          → 스크린샷, 이미지
LICENSE          → 배지용 라이선스 유형

2단계: 콘텐츠 추출 맵

소스대상 섹션추출 방법
README 제목/배지Hero첫 번째 H1 + shield.io 배지 라인
README 요약Hero 태그라인제목 다음 첫 번째 문단 또는 인용문
README 기능Features 그리드글머리 기호 목록이 있는 H2/H3 섹션
README 설치 방법Quick Start쉘 명령어가 포함된 코드 블록
README 사용법Examples예시가 포함된 코드 블록
README FAQFAQdetails/summary 또는 H3+P 패턴
CHANGELOGWhat's New최신 1-3개 릴리스
assets/*.png스크린샷갤러리 섹션

3단계: 섹션 생성

다음 순서대로 섹션을 생성합니다:

  1. 헤더 (고정)

    • 로고/프로젝트 이름
    • 내비게이션 링크: Features, Install, FAQ
    • 액션: 검색(Cmd+K), GitHub Star, 기본 CTA
  2. 위험 배너 (--risk-banner 사용 시)

    • 화면 상단에 주황색/경고 스타일
    • 명확하고 보기 쉬운 면책 문구
    • 상세 공개 섹션으로 링크
  3. Hero 섹션

    • README H1의 제목
    • 요약/첫 번째 문단의 태그라인
    • 통계 배지 (버전, 라이선스, 플랫폼)
    • CTA: "Quick Start" (기본), "View on GitHub" (보조)
  4. 아키텍처/개요 (README에 다이어그램이 있는 경우)

    • ASCII 다이어그램을 스타일 블록으로 변환
    • 또는 개요 카드
  5. Features 그리드

    • README 기능에서 추출한 4-6개의 기능 카드
    • 아이콘 + 제목 + 설명 패턴
  6. 가격표 (--pricing-table 사용 시)

    • 요금제 비교 표
    • 사용량/곱셈 표 (있는 경우)
  7. 스크린샷 갤러리 (assets이 있는 경우)

    • 탭 기반 또는 캐러셀 갤러리
    • 대체 텍스트의 캡션
  8. Quick Start 섹션

    • 한 줄 설치 명령어 (강조 코드 블록)
    • 설정 단계
    • 첫 번째 사용 예시
  9. 위험 공개 (--risk-banner 사용 시)

    • 전체 면책 섹션
    • 이용 약관 고려 사항
    • 권장 사항
  10. FAQ 섹션

    • README FAQ 또는 일반적인 질문에서 생성
    • 접을 수 있는 details 패턴
  11. 관련 프로젝트 (README에 링크가 있는 경우)

    • 의존성/관련 저장소로 연결되는 카드
  12. 푸터

    • 빠른 링크
    • 라이선스 배지
    • 버전 정보
    • 작성자/저장소 링크

4단계: 출력 구조

[프로젝트명]-landing/
├── index.html              # 메인 랜딩 페이지
├── styles.css              # 완전한 스타일시트
├── search.js               # Cmd+K 검색 기능
├── search-data.js          # 검색 인덱스 (FAQ, 기능)
├── favicon.svg             # 생성 또는 복사됨
├── robots.txt              # SEO
├── CLAUDE.md               # 프로젝트 지침
├── README.md               # 랜딩 저장소 문서
├── assets/                 # 복사된 스크린샷
│   └── [소스에서 복사됨]
└── .github/
    └── workflows/
        └── static.yml      # GitHub Pages 배포

5단계: 검증 체크포인트

최종 확정 전에 확인할 사항:

  • 모든 섹션이 브라우저에서 정상적으로 렌더링되는지 확인
  • 링크가 유효한 대상(GitHub 저장소, 문서, 설치 명령어)을 가리키는지 확인
  • 반응형 레이아웃이 모바일(375px), 태블릿(768px), 데스크톱(1280px) 너비에서 작동하는지 확인
  • 접근성: 스킵 링크 존재, 대화형 요소에 ARIA 레이블, 색상 대비 WCAG AA 통과

기술 스택

  • 빌드 단계 없음: 순수 HTML + CSS + JS
  • 검색: CDN에서 지연 로드되는 MiniSearch (폴백 지원)
  • 배포: Actions를 통한 GitHub Pages
  • 스타일링: CSS 사용자 정의 속성, 반응형, 기본 다크 테마
  • 접근성: 스킵 링크, ARIA 레이블, 키보드 내비게이션

CSS 패턴 (기존 랜딩 페이지에서 가져옴)

컴포넌트 클래스

/* 버튼 */
.btn, .btn-primary, .btn-secondary, .btn-github-star, .btn-outline

/* 카드 */
.feature-card, .comparison-card, .path-card

/* 레이아웃 */
.container, .features-grid, .hero, .section

/* 유틸리티 */
.visually-hidden, .skip-link

CSS 변수

:root {
  --color-bg: #0d1117;
  --color-surface: #161b22;
  --color-border: #30363d;
  --color-text: #c9d1d9;
  --color-text-muted: #8b949e;
  --color-primary: #58a6ff;
  --color-success: #3fb950;
  --color-warning: #d29922;
  --color-danger: #f85149;
  --space-xs: 0.25rem;
  --space-sm: 0.5rem;
  --space-md: 1rem;
  --space-lg: 1.5rem;
  --space-xl: 2rem;
  --radius: 6px;
}

예시

사용자: /landing-page-generator from ~/projects/my-project --risk-banner --pricing-table

출력:

~/projects/my-project-landing/에 다음이 생성됩니다:

  • 멀티 프로바이더 라우터를 보여주는 완전한 랜딩 페이지
  • 눈에 띄는 ToS 위험 배너 (주황색, 화면 상단)
  • 프로바이더 카드 (Anthropic, Copilot, Ollama)
  • README의 가격표
  • 스크린샷 갤러리
  • GitHub Pages 배포 준비 완료

팁

  • 법적/ToS 고려 사항이 있는 프로젝트에는 항상 --risk-banner를 포함하세요
  • 스크린샷은 랜딩 품질을 크게 향상시킵니다. assets/가 채워져 있는지 확인하세요
  • 이 스킬은 README 언어(영어/프랑스어)를 유지합니다
  • 생성된 FAQ를 검토하세요. 맞춤 설정이 필요할 수 있습니다
  • 생성 후 반응형 디자인을 테스트하세요

참고 자료

자세한 패턴 문서는 references/landing-pattern.md를 참조하세요. 재사용 가능한 템플릿과 스니펫은 assets/를 참조하세요.

Individual skills in this repo

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

관련 스킬