Communitygithub.com

Statische Repo-Landingpage

Baut aus README, Lizenz und Befehlen des Repos eine Landingpage ohne Build, mit Hell und Dunkel, Open Graph, JSON-LD und sechs Sprachen.

Was ist Statische Repo-Landingpage?

make-lp schreibt docs/index.html, docs/style.css und docs/main.js nur aus Dateien, die das Repo schon hat. Die Seite hat Hero, Feature-Raster, Installationsbefehle und Footer, dazu Theme-Tokens, Social Cards, strukturierte Daten, ein SVG-Favicon, Kopierbuttons und Texte auf Englisch, Japanisch, Chinesisch, Spanisch, Russisch und Deutsch. Was das Repo nicht behauptet, wird nicht erfunden.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Statische Repo-Landingpage?

Generieren Sie eine statische Landingpage (docs/index.html + docs/style.css + docs/main.js), deren Inhalt aus dem Repository stammt, in dem sie sich befindet. Führen Sie niemals Funktionen, Anbieter oder Befehle auf, die im Repository nicht tatsächlich vorhanden sind.

Quelle der Wahrheit für Inhalte

Lesen Sie vor dem Schreiben Folgendes:

  • README.* — Überblick, Funktionen, Technologie-Stack, Installations-/Schnellstartbefehle
  • LICENSE* — Lizenzname, -version, -URL
  • CHANGELOG.* — Zusammenfassung des Änderungsverlaufs
  • package.json, composer.json, requirements.txt, usw.: Name, Beschreibung, Abhängigkeiten (Grundlage für Tech-Stack-Badges)
  • AGENTS.md, CLAUDE.md, config.toml, GEMINI.md, usw.: Der Zweck des Projekts und, falls das Projekt solche hat, Tabellen der unterstützten Anbieter/Einstellungen
  • Ein vorhandenes docs/index.html (falls vorhanden): Die Abschnittsstruktur wiederverwenden und den Inhalt direkt bearbeiten, anstatt von Grund auf neu zu erstellen, sofern nicht ausdrücklich eine Neugestaltung verlangt wird.

Erforderliche Elemente

  1. Helles/dunkles Design — Überschreiben Sie CSS-Custom-Properties (--bg, --text, --accent, usw.) mit einer prefers-color-scheme: dark Media Query. Fügen Sie keinen JS-Design-Umschalter hinzu, es sei denn, dies wird verlangt.

  2. OGP + Twitter/X-Karte — og:title, og:description, og:url, og:image, og:type, og:site_name, twitter:card, twitter:title, twitter:description, twitter:image. Verweisen Sie og:image/twitter:image auf ein Asset, das tatsächlich bereits im Repository existiert (z.B. social-preview.png). Falls keines existiert, generieren Sie zuerst eines mit dem Skill make-social-preview.

  3. JSON-LD-Schema — Ein <script type="application/ld+json">-Block (SoftwareApplication für eine App/ein Tool; andernfalls jeder @type, der zum Projekt passt). Halten Sie ihn konsistent mit der OGP-Beschreibung.

  4. Favicon — Referenzieren Sie ein Twemoji-SVG, das zum Projekt passt, mit <link rel="icon">.

  5. Mehrsprachigkeitsunterstützung mittels multilanguagejs (CDN, kein Build-Schritt):

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

    Umschließen Sie jedes zu übersetzende Element mit <template type="language-group">, und platzieren Sie darin ein untergeordnetes Element pro Sprache, jedes mit einem language="xx"-Attribut (nicht lang):

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

    Jedes template[type=language-group] muss genau ein Element pro unterstützter Sprache enthalten – multilanguagejs nimmt das erste passende [language=X] pro Template, daher führen Duplikate dazu, dass Inhalte stillschweigend verloren gehen.

    Initialisieren Sie es in main.js:

    var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" });
    ml.setLanguage(lang); // beim Laden und beim Change-Event des <select>-Umschalters
    

    <title> und <meta name="description"> liegen außerhalb des Geltungsbereichs der [language]-Templates (die Bibliothek aktualisiert nur den textContent passender Elemente, und die Übersetzung eines <meta>-Tags befindet sich in seinem content-Attribut, nicht in seinem Text). Geben Sie main.js ein kleines sprachspezifisches Wörterbuch { title, description } mit und aktualisieren Sie diese beiden Tags manuell zusammen mit ml.setLanguage().

    Erkennen Sie die Sprache des Besuchers über navigator.language, speichern Sie die ausgewählte Sprache in localStorage und wenden Sie sie beim Laden erneut an, bevor Sie auf die Browsererkennung zurückfallen.

    Erforderlicher Sprachsatz (immer, unabhängig davon, was die App selbst unterstützt): Englisch (en), Japanisch (ja), Chinesisch (zh), Spanisch (es), Russisch (ru), Deutsch (de) – mindestens 6 Sprachen. Dies gilt auch, wenn src/locales/*.json oder die eigene i18n.ts/i18n.js der App nur einige davon abdeckt (z.B. erstellen Sie die Landingpage selbst für eine en/ja-App in 6 Sprachen). Auf Wunsch können Sie weitere Sprachen zu diesen 6 hinzufügen.

  6. Copy-to-Clipboard-Buttons — Statten Sie jeden Installations-/Ausführungsbefehl, der in einem <code>-Block angezeigt wird, mit einem Kopierbutton und einem Inline-SVG-Icon (niemals ein Emoji) sowie einem Bestätigungszustand mit Häkchen über navigator.clipboard.writeText() aus. Verwenden Sie für ein konsistentes Layout einen .code-row-Flex-Container, der das <code>-Element und seinen Button umschließt.

  7. Responsiv — Mobile First. Vermeiden Sie horizontales Scrollen auf schmalen Ansichtsfenstern, außer in Containern, die explizit zum Scrollen vorgesehen sind (z.B. eine breite Vergleichstabelle).

  8. Kein Build-Schritt — Stellen Sie sicher, dass die Seite allein durch das Öffnen der HTML-Datei oder das Bereitstellen des statischen Ordners wie besehen funktioniert, unabhängig davon, welches Bündelungstool (Vite, usw.) die App selbst verwendet. Halten Sie main.js als lesbaren Quellcode. Laden Sie es direkt in die Seite mit <script src="main.js">.

  9. Semantische Struktur — Strukturieren Sie diese semantisch: Heldenbereich (Überschrift, Einleitungstext, CTA, primärer Ausführungsbefehl), Screenshots (verwenden Sie vorhandene Repository-/GitHub-Asset-URLs, falls vorhanden), Feature-Raster, Schnellstart-/Installationsbefehle, Tech-Stack-Badges, Footer.

  10. Vorhandenes CSS wiederverwenden — Verwenden Sie die bereits im docs/style.css des Repositorys vorhandenen CSS-Custom-Properties und Klassennamen, anstatt ein paralleles, separates Stilsystem zu erstellen.

  11. Respektieren Sie das Designsystem — Respektieren Sie das Designsystem der bestehenden KI-Agenten-Laufzeitumgebung. Wenn Sie neues CSS hinzufügen, verwenden Sie vorhandene Custom Properties und Klassennamen wieder und befolgen Sie Namenskonventionen, Design, Layout sowie Ton und Stil, die mit dem Designsystem des Repositorys konsistent sind.

Arbeitsablauf

  1. Lesen Sie die oben genannten Inhaltsquellen.
  2. Wenn docs/ nicht existiert, erstellen Sie es.
  3. Wenn docs/index.html bereits existiert, bearbeiten Sie es direkt – sofern nicht ausdrücklich eine Neugestaltung verlangt wird, ersetzen Sie es nicht vollständig, sondern behalten Sie die Abschnittsstruktur bei und aktualisieren Sie den Inhalt.
  4. Strukturieren Sie die Abschnitte semantisch: Heldenbereich (Überschrift, Einleitungstext, CTA, primärer Ausführungsbefehl), Screenshots (verwenden Sie vorhandene Repository-/GitHub-Asset-URLs, falls vorhanden), Feature-Raster, Vergleichs-/Einstellungstabelle (falls das Projekt mehrere Anbieter/Modi/Backends hat, die einen Vergleich lohnen), Schnellstart-/Installationsbefehle, Tech-Stack-Badges, Footer.
  5. Verwenden Sie die bereits im docs/style.css des Repositorys vorhandenen CSS-Custom-Properties und Klassennamen wieder, anstatt ein paralleles, separates Stilsystem zu erstellen.
  6. Aktualisieren Sie docs/main.js.
  7. Überprüfen Sie vor dem Abschluss: Es werden keine Emojis für interaktive Icons verwendet (nur SVG); jedes template[type=language-group] enthält genau ein untergeordnetes Element pro unterstützter Sprache, ohne Duplikate oder Auslassungen; OGP/JSON-LD verweisen auf Dateien/URLs, die tatsächlich im Repository vorhanden sind.

Verwandte Skills