랜딩 페이지 생성기
리포지토리의 문서와 구조를 분석하여 완전하고 배포 가능한 랜딩 페이지를 생성합니다.
이 스킬을 사용하는 경우
- GitHub 리포지토리의 랜딩 페이지를 만들 때
- 기존 문서로 정적 사이트를 생성할 때
- 여러 프로젝트의 랜딩 페이지를 표준화할 때
- README 콘텐츠를 마케팅/쇼케이스 페이지로 변환할 때
이 스킬의 기능
- 리포지토리 분석: README.md, CHANGELOG.md, package.json/VERSION, docs/, assets/ 파일을 읽습니다.
- 콘텐츠 추출: 제목, 태그라인, 기능, 설치 방법, 스크린샷을 식별합니다.
- 섹션 매핑: Hero, Features, Install, FAQ, Footer로 매핑합니다 (+ 선택 사항: 위험 배너, 가격).
- 랜딩 페이지 생성: 완전한 정적 사이트(HTML + CSS + JS)를 만듭니다.
- 배포 준비 완료 출력: 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 |
--search | Cmd+K 검색 활성화 | true |
--output <path> | 출력 디렉토리 | ./[repo-name]-landing/ |
워크플로우
1단계: 리포지토리 분석
소스 리포지토리에서 다음 파일을 읽고 분석합니다.
README.md → 기본 콘텐츠 소스 (제목, 태그라인, 기능, 설치)
CHANGELOG.md → 버전 정보, 최근 변경 사항
package.json → 버전 번호, 종속성, 메타데이터
VERSION → 대체 버전 소스
docs/ → 추가 문서 페이지
assets/ → 스크린샷, 이미지
LICENSE → 배지용 라이선스 유형
2단계: 콘텐츠 추출 맵
| 소스 | 대상 섹션 | 추출 방법 |
|---|---|---|
| README 제목/배지 | Hero | 첫 번째 H1 + shield.io 배지 줄 |
| README TL;DR | Hero 태그라인 | 제목 뒤 첫 번째 문단 또는 인용문 |
| README 기능 | Features 그리드 | 글머리 기호 목록이 있는 H2/H3 섹션 |
| README 설치 | Quick Start | 셸 명령어가 포함된 코드 블록 |
| README 사용법 | Examples | 예제가 포함된 코드 블록 |
| README FAQ | FAQ | details/summary 또는 H3+P 패턴 |
| CHANGELOG | What's New | 최신 1-3개 릴리스 |
| assets/*.png | Screenshots | 갤러리 섹션 |
3단계: 섹션 생성
다음 순서로 섹션을 생성합니다.
-
Header (고정)
- 로고/프로젝트 이름
- 탐색 링크: Features, Install, FAQ
- 작업: 검색(Cmd+K), GitHub Star, 기본 CTA
-
위험 배너 (
--risk-banner인 경우)- 접힌 부분 위에 주황색/경고 스타일
- 명확하고 눈에 띄는 면책 문구
- 상세 공개 섹션 링크
-
Hero 섹션
- README H1의 제목
- TL;DR/첫 번째 문단의 태그라인
- 통계 배지(버전, 라이선스, 플랫폼)
- CTA: "Quick Start" (기본), "View on GitHub" (보조)
-
아키텍처/개요 (README에 다이어그램이 있는 경우)
- ASCII 다이어그램을 스타일 블록으로 변환
- 또는 개요 카드
-
Features 그리드
- README 기능의 4-6개 기능 카드
- 아이콘 + 제목 + 설명 패턴
-
가격 표 (
--pricing-table인 경우)- 요금제 비교 표
- 곱셈기/사용량 표 (있는 경우)
-
스크린샷 갤러리 (assets이 있는 경우)
- 탭 기반 또는 캐러셀 갤러리
- 대체 텍스트의 캡션
-
Quick Start 섹션
- 한 줄 설치 명령어 (강조 코드 블록)
- 설정 단계
- 첫 번째 사용 예제
-
위험 공개 (
--risk-banner인 경우)- 전체 면책 섹션
- ToS 고려 사항
- 권장 사항
-
FAQ 섹션
- README FAQ 또는 일반적인 질문에서 생성
- 접을 수 있는 details 패턴
-
관련 프로젝트 (README에 링크가 있는 경우)
- 종속성/관련 리포지토리로 연결되는 카드
-
Footer
- 빠른 링크
- 라이선스 배지
- 버전 정보
- 작성자/리포지토리 링크
4단계: 출력 구조
[project-name]-landing/
├── index.html # 기본 랜딩 페이지
├── styles.css # 전체 스타일시트
├── search.js # Cmd+K 검색 기능
├── search-data.js # 검색 인덱스 (FAQ, 기능)
├── favicon.svg # 생성 또는 복사됨
├── robots.txt # SEO
├── CLAUDE.md # 프로젝트 지침
├── README.md # 랜딩 리포지토리 문서
├── assets/ # 복사된 스크린샷
│ └── [source에서 복사됨]
└── .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/를 참조하세요.