Communitygithub.com

저장소 정적 랜딩 페이지

README, 라이선스, 명령으로 빌드 없는 랜딩을 만든다. 라이트/다크 테마, Open Graph, JSON-LD, 6개 언어를 포함한다.

저장소 정적 랜딩 페이지란 무엇인가요?

make-lp는 저장소에 이미 있는 파일만으로 docs/index.html, docs/style.css, docs/main.js를 쓴다. 히어로, 기능 그리드, 설치 명령, 푸터와 함께 테마 토큰, 소셜 카드, 구조화 데이터, SVG 파비콘, 복사 버튼, 그리고 영·일·중·서·러·독 6개 언어를 넣는다. 저장소가 말하지 않은 기능은 지어내지 않는다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/hidao80/agent-skills/tree/HEAD/skills/make-lp

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

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

문서

저장소 정적 랜딩 페이지은(는) 무엇을 하나요?

저장소에 있는 정보를 바탕으로 정적 랜딩 페이지(docs/index.html + docs/style.css + docs/main.js)를 생성합니다. 저장소에 실제로 없는 기능, 제공자 또는 명령어는 절대 나열하지 마세요.

콘텐츠의 진실 공급원(Source of Truth)

무엇이든 작성하기 전에 다음을 읽으십시오:

  • README.* — 개요, 기능, 기술 스택, 설치/빠른 시작 명령어
  • LICENSE* — 라이선스 이름, 버전, URL
  • CHANGELOG.* — 변경 이력 요약
  • package.json, composer.json, requirements.txt 등: 이름, 설명, 의존성 (기술 스택 배지의 기초)
  • AGENTS.md, CLAUDE.md, config.toml, GEMINI.md 등: 프로젝트의 목적 및 (있는 경우) 지원되는 제공자/설정 테이블
  • 기존 docs/index.html (있는 경우): 명시적으로 재설계를 요청하지 않는 한, 그 섹션 구조를 재사용하고 처음부터 다시 구축하지 말고 콘텐츠를 그 자리에서 편집하십시오.

필수 요소

  1. 라이트/다크 테마 — prefers-color-scheme: dark 미디어 쿼리로 CSS 사용자 정의 속성(--bg, --text, --accent 등)을 재정의하십시오. 요청하지 않는 한 JS 테마 전환 버튼을 추가하지 마세요.

  2. OGP + Twitter/X 카드 — og:title, og:description, og:url, og:image, og:type, og:site_name, twitter:card, twitter:title, twitter:description, twitter:image. og:image/twitter:image는 저장소에 실제로 존재하는 에셋(예: social-preview.png)을 가리키십시오. 없으면 먼저 make-social-preview 기술로 생성하십시오.

  3. JSON-LD 스키마 — <script type="application/ld+json"> 블록(앱/도구의 경우 SoftwareApplication, 그렇지 않으면 프로젝트에 맞는 @type). OGP 설명과 일관성을 유지하십시오.

  4. 파비콘 — 프로젝트에 적합한 Twemoji SVG를 <link rel="icon">으로 참조하십시오.

  5. multilanguagejs(CDN, 빌드 단계 없음)를 통한 다국어 지원:

    <script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>
    

    번역할 모든 요소를 <template type="language-group">로 감싸고, 그 안에 각 언어에 대해 하나의 하위 요소를 배치하되 각각 language="xx" 속성(lang 아님)을 사용하십시오:

    <h2>
      <template type="language-group">
        <span language="en">Features</span>
        <span language="ja">機能</span>
      </template>
    </h2>
    

    각 template[type=language-group]은 지원되는 언어당 정확히 하나의 요소를 포함해야 합니다. multilanguagejs는 템플릿당 첫 번째 일치하는 [language=X]를 취하므로, 중복되면 콘텐츠가 자동으로 손실됩니다.

    main.js에서 초기화하십시오:

    var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" });
    ml.setLanguage(lang); // 로드 시 및 <select> 전환기의 변경 이벤트에서
    

    <title> 및 <meta name="description">는 [language] 템플릿의 범위 밖에 있습니다(라이브러리는 일치하는 요소의 textContent만 업데이트하며, <meta> 태그의 번역은 텍스트가 아닌 content 속성에 있습니다). main.js에 언어별 { title, description } 사전을 작게 만들고 ml.setLanguage()와 함께 이 두 태그를 수동으로 업데이트하십시오.

    navigator.language에서 방문자의 언어를 감지하고 선택한 언어를 localStorage에 저장한 후, 로드 시 브라우저 감지로 돌아가기 전에 다시 적용하십시오.

    필수 언어 세트(항상, 앱 자체가 지원하는 것과 관계없이): 영어(en), 일본어(ja), 중국어(zh), 스페인어(es), 러시아어(ru), 독일어(de) — 최소 6개 언어. 이는 src/locales/*.json 또는 앱 자체의 i18n.ts/i18n.js가 이들 중 일부만을 다루더라도 적용됩니다(예: en/ja 전용 앱의 경우에도 랜딩 페이지를 6개 언어로 만드십시오). 요청 시 이 6개 언어에 다른 언어를 추가할 수 있습니다.

  6. 클립보드 복사 버튼 — <code> 블록에 표시된 모든 설치/실행 명령어에 인라인 SVG 아이콘(절대 이모지 사용 금지)이 있는 복사 버튼을 제공하고, navigator.clipboard.writeText()를 통해 확인 표시 상태를 표시하십시오. 일관된 레이아웃을 위해 <code>와 버튼을 .code-row 플렉스 컨테이너로 감싸십시오.

  7. 반응형 — 모바일 우선. 명시적으로 스크롤하도록 의도된 컨테이너(예: 넓은 비교 테이블)를 제외하고는 좁은 뷰포트에서 가로 스크롤이 발생하지 않도록 하십시오.

  8. 빌드 단계 없음 — 앱 자체가 어떤 번들러(Vite 등)를 사용하든 HTML 파일을 열거나 정적 폴더를 그대로 제공하기만 하면 페이지가 작동하도록 만드십시오. main.js를 읽을 수 있는 소스로 유지하고 <script src="main.js">로 페이지에 직접 로드하십시오.

  9. 시맨틱 구조 — 다음을 시맨틱하게 구성하십시오: 히어로(제목, 리드 텍스트, CTA, 주요 실행 명령어), 스크린샷(있는 경우 기존 저장소/GitHub 에셋 URL 재사용), 기능 그리드, 빠른 시작/설치 명령어, 기술 스택 배지, 푸터.

  10. 기존 CSS 재사용 — 병렬적이고 분리된 스타일링 시스템을 만들지 말고 저장소의 docs/style.css에 이미 있는 CSS 사용자 정의 속성과 클래스 이름을 재사용하십시오.

  11. 디자인 시스템 존중 — 기존 AI 에이전트 런타임 환경의 디자인 시스템을 존중하십시오. 새 CSS를 추가할 때는 기존 사용자 정의 속성과 클래스 이름을 재사용하고 저장소의 디자인 시스템과 일관된 명명 규칙, 디자인, 레이아웃, 어조 및 방식을 따르십시오.

워크플로우

  1. 위의 콘텐츠 소스를 읽으십시오.
  2. docs/가 없으면 만드십시오.
  3. docs/index.html이 이미 있으면 그 자리에서 편집하십시오. 명시적으로 재설계를 요청하지 않는 한 완전히 교체하지 말고 섹션 구조를 유지하고 콘텐츠를 업데이트하십시오.
  4. 섹션을 시맨틱하게 구성하십시오: 히어로(제목, 리드 텍스트, CTA, 주요 실행 명령어), 스크린샷(있는 경우 기존 저장소/GitHub 에셋 URL 재사용), 기능 그리드, 비교/설정 테이블(프로젝트에 비교할 만한 여러 제공자/모드/백엔드가 있는 경우), 빠른 시작/설치 명령어, 기술 스택 배지, 푸터.
  5. 병렬적이고 분리된 스타일링 시스템을 만들지 말고 저장소의 docs/style.css에 이미 있는 CSS 사용자 정의 속성과 클래스 이름을 재사용하십시오.
  6. docs/main.js를 업데이트하십시오.
  7. 완료하기 전에 확인하십시오: 대화형 아이콘에 이모지가 사용되지 않음(SVG만); 모든 template[type=language-group]이 지원되는 각 언어에 대해 정확히 하나의 하위 요소를 가지며 중복이나 누락이 없음; OGP/JSON-LD가 저장소에 실제로 존재하는 파일/URL을 가리킴.

관련 스킬