Communitygithub.com

homepage-maker

Zeigt einem Agenten, wie man eine Landing Page, Homepage oder Portfolio-Seite art-directet und erstellt. Der Prozess gliedert sich in Vorrecherche, Vorgehen und Regeln. Verwenden Sie diesen Skill, wenn eine neue Aufgabe diese Fertigkeit erfordert.

Was ist homepage-maker?

Der Skill 'homepage-maker' befähigt KI-Agenten, professionelle Webseiten zu erstellen, die nicht nach KI-generierten Vorlagen aussehen (mittig ausgerichtete Titel, lila Farbverläufe, drei Karten). Stattdessen wird ein designerischer Ansatz verfolgt: Zuerst werden reale, gut gestaltete Websites analysiert, die Inspirationsquellen transparent dokumentiert, und alle für eine lokale Geschäftsseite erforderlichen Informationen werden lückenlos eingebunden. Der Skill unterstützt die Plattformen Claude Code, Cursor und Codex und wird über ein Node.js-Skript (`scripts/homepage.mjs`) gesteuert. Der Workflow umfasst eine gründliche Vorrecherche, das Sammeln von Referenzen aus genehmigten Quellen (SiteInspire, Land-book, Awwwards u.a.), die Erstellung von drei Designrichtungen, die sektionsweise Entwicklung mit Quellenangabe (`data-ref`-Attribute), eine automatische Prüfung (Check) auf Fakten, Barrierefreiheit, mobile Optimierung und koreanische Sprachregeln, sowie die Bereitstellung auf Vercel. Ein integrierter humanize-korean-Prüfpunkt hilft, KI-typische Formulierungen zu vermeiden. Der Skill stellt strenge Anforderungen an die Nachvollziehbarkeit von Designentscheidungen, die Einhaltung von Vorschriften für lokale Geschäfte (Naver Maps, LocalBusiness JSON-LD, Herkunftsangaben) und die Qualität der finalen Ausgabe durch mehrere Analyse- und Genehmigungsstufen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/min9lin9/min9maker-homepage/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht homepage-maker?

Um zu vermeiden, dass KI-generierte Seiten (mittig ausgerichteter Titel, lila Farbverlauf, drei Karten) entstehen, geht dieser Skill wie ein Designer vor: Zuerst reale, gut gemachte Websites ansehen, transparent machen, was von wo übernommen wurde, und sicherstellen, dass keine für die Geschäftsseite wichtigen Informationen fehlen. Das Rendern und Prüfen übernimmt scripts/homepage.mjs.

SK=.claude/skills/homepage-maker/scripts/homepage.mjs
node $SK init sites/<slug>
node $SK ref sites/<slug> <url> --note "Eine Sache, die von dieser Seite übernommen wird"
node $SK board sites/<slug>
node $SK copy sites/<slug>
node $SK check sites/<slug> [--draft]
node $SK shots sites/<slug> --compare <ref1>,<ref2>
node $SK deploy sites/<slug> [--prod]

Erstinstallation: Im Skill-Ordner npm install && npx playwright install chromium ausführen (siehe README-Installationsanleitung). Befehle werden im Projektstamm ausgeführt. Der KI-Text-Score hilft nur, wenn humanize-korean unter .claude/skills/humanize-korean/ im Projekt vorhanden ist (andere Pfade über HUMANIZE_KOREAN_ROOT).

Vorrecherche

Dieser Skill erstellt Seiten basierend auf Rechercheergebnissen. Die einzige selbst durchzuführende Recherche ist das Sammeln von Designreferenzen. Folgendes muss bereits vorliegen: Details zu den einzelnen Punkten, ihrer Verwendung und den Folgen bei Fehlen finden sich in references/prerequisites.md.

ZeitpunktErforderliche Recherche
Vor dem BriefGrundlegende Kundendaten (Adresse, Telefon, Öffnungszeiten, Parken, Reservierung, Speisekarte, Preise, Herkunft), Besucherkontext (Wer kommt in welcher Situation?), Werberegulierung der Branche
Vor den drei RichtungenWettbewerber, Präsenz alternativer Geschäfte (Bewertungen, Beschreibungen, Webseiten), Markendefinition
Vor der TextfestlegungKeywords, Suchmaschinensichtbarkeit
Vor dem DeploymentDomain, Hosting-Eigentümer, erforderliche Hinweise (bei Reservierungs-/Kontaktformular)

Nicht bestätigte Werte werden in facts.md als „Bestätigung erforderlich“ markiert, sodass der Check sie nicht auf der Seite zulässt.

Vorgehen

⛔ Gekennzeichnete Schritte erfordern eine menschliche Genehmigung.

  1. init — Überprüfen anhand der obigen Tabelle, ob die Vorrecherche abgeschlossen ist. Erstellt sites/<slug> mit brief.md, facts.md, refs.md, site/ und refs/.
  2. Brief — Der Seitenzweck wird auf eine einzige Aktion des Besuchers festgelegt (Navigation, Reservierung, Anruf). Der Besucherkontext wird beschrieben (z. B. ein Gast, der am Wochenende mit dem Auto kommt und vor Abfahrt auf dem Handy nachschaut).
  3. Faktenblatt (Facts) — Adresse, Telefon, Öffnungszeiten, Ruhetage, Parken, Reservierungslink, Naver Maps-Link, Speisekarte, Preise, Herkunft werden mit Quellenangabe erfasst. Unbestätigte Angaben werden als „Bestätigung erforderlich“ markiert und nicht auf der Seite verwendet. Wenn auf der Seite eine Zahl steht, die nicht in facts.md enthalten ist, schlägt der Check fehl.
  4. Referenzen finden — Aus den Quellen in references/sources.md von mindestens drei Stellen 8–12 Kandidaten suchen. Nicht nur dieselbe Branche, sondern Websites, die das gleiche Problem (Menü präsentieren, Standort anzeigen, Prozess darstellen) gut gelöst haben.
  5. Erfassen und aufzeichnen — 5–8 ausgewählte Seiten mit ref erfassen. Desktop- und Mobile-Screenshots sowie Schriftart, -größe, Farbe, Textbreite und Bewegungsgrad werden in refs/<slug>/ gespeichert und in refs.md dokumentiert. Zu jeder Referenz wird eine Zeile notiert, was übernommen wurde. Layout, Fotos und Text werden nicht übernommen. Vorgehen siehe references/moves.md.
  6. ⛔ Drei Richtungen vorschlagen — Mit board werden out/board.png und ein Ordner out/board/ zum Teilen erstellt (kein Index für Suchmaschinen, jede Karte mit Link zur Originalseite, übernommenem Element und verwendetem Abschnitt). Drei Richtungen vorschlagen, die von unterschiedlichen Referenzen ausgehen. Für jede Richtung angeben, was von welcher Referenz übernommen wurde. Keine Umsetzung, bis eine Person eine auswählt.
  7. Abschnittsweises Erstellen — site/index.html (+ CSS/Bilder in site/) abschnittsweise erstellen. Jedes <section> mit data-ref="<Referenzordnername>" versehen, um die Quelle anzugeben. Vor dem Erstellen eines Abschnitts den entsprechenden Abschnitt der Referenz erneut ansehen. Pflichtblöcke für lokale Geschäfte: references/korea-local.md.
  8. Textredaktion — Mit copy die auf der Seite sichtbaren Texte blockweise extrahieren und in sites/<slug>/_workspace/<Datum>-NNN-<tag>/01_input.txt speichern (Bildquellen, Lizenzzeilen und data-copy-skip-Bereiche werden ausgeschlossen). Ist humanize-korean (epoko77-ai/im-not-ai) im Projekt vorhanden, zeigt derselbe Befehl Pfad (light·standard·heavy) und Risiko an. Diesen Run-Ordner mit dem humanize-korean-Skill redigieren, final.md erstellen, verify_gates.py bestehen lassen, dann nur die geänderten Sätze in site/ übertragen. Zahlen, Eigennamen und Zitate werden nicht geändert. Fehlt das Tool, endet dieser Schritt nach der Textextraktion.
  9. Check — Korrigieren, bis die Fehleranzahl (✗) null beträgt. Während der Arbeit kann mit --draft der Fehlerstatus auf Warnung herabgesetzt werden, aber für Abnahme und Deployment muss der Check ohne --draft bestehen.
  10. Visueller Vergleich — Mit shots --compare wird out/compare.png erstellt, um die Seite neben den ausgewählten Referenzen zu betrachten. out/site-mobile.png ebenfalls öffnen. Prüfpunkte: Ist auf den ersten Blick erkennbar, was das Geschäft ist und wo es sich befindet? Ist die eine aus der Referenz übernommene Sache tatsächlich umgesetzt? Sieht die Seite nicht wie eine Vorlage aus? Bei Verbesserungsbedarf zurück zu Schritt 7.
  11. ⛔ Genehmigung — Genehmigung einholen mit compare.png, site-mobile.png und out/report.json.
  12. Deployment — deploy lädt die Seite nur dann auf Vercel hoch, wenn der Check bestanden wurde. Zunächst wird das Projekt auf Vercel mit dem Ordnernamen (slug von sites/<slug>) verbunden. Da Vercel das erste Deployment eines neuen Projekts immer als Production (<slug>.vercel.app) bereitstellt, wird bei temporären Daten ein Hinweis „Vorläufige Informationen“ oben auf der Seite platziert. Ab dem zweiten Deployment erscheint eine Vorschau-URL; --prod wird erst nach Genehmigung verwendet. Die Verbindung einer eigenen Domain erfolgt ebenfalls erst nach Genehmigung.

Regeln

  • Als Referenzquellen werden nur die in references/sources.md aufgeführten erlaubten Quellen verwendet. Seiten, die den Claude-Agenten per robots.txt blockieren (Godly, GDWEB), werden von ref abgelehnt. In diesem Fall manuell ansehen und nur Notizen machen.
  • Referenzerfassung dient der Analyse. refs/ wird nicht ins Repository hochgeladen (.gitignore). Die Fotos, Texte und Logos der Referenzen werden nicht auf der Website verwendet.
  • Für die Abgabeseite werden ausschließlich selbst aufgenommene Fotos des Geschäfts verwendet. Keine KI-generierten Lebensmittelbilder oder synthetischen Personen. In der Entwurfsphase können lizenzrechtlich einwandfreie Platzhalterbilder (CC etc.) verwendet werden, die auf der Seite als „Platzhalter“ gekennzeichnet sind und deren Quelle in facts.md vermerkt ist.
  • Bei Verwendung vorläufiger Informationen für Entwürfe werden diese in facts.md als vorläufig markiert und auf der Seite mit einem Hinweis „Vorläufige Informationen“ versehen. Telefonnummern dürfen nur nicht reale Werte sein (z. B. 031-000-0000).
  • Exklusivbehauptungen (erster, größter, einziger, Original, Nr. X) nur mit Beleg in facts.md. Bei Menü- und Preisangaben ist die Herkunftsangabe (Herkunftslandgesetz) erforderlich. Gleiche Regel wie bei carousel-maker.
  • Bilder maximal 500 KB pro Stück (WebP/AVIF empfohlen), gesamte Webseite unter 3 MB.

Prüfgates

GateFehlerbedingung
refsWeniger als 3 Referenzen mit dokumentierter Übernahme
attributionAbschnitte ohne data-ref oder Verweis auf nicht in refs/ vorhandene Referenz
factSeitenzahl nicht in facts.md
placeholderVorhandensein von [...], 【...】, lorem, TODO
claim · originUnbelegte Exklusivbehauptungen, Fleischgerichte + Preis ohne Herkunftsangabe
localFehlen von LocalBusiness/Restaurant JSON-LD, tel:-Link, Naver-/Kakao-Maps-Link, Öffnungszeiten
metaFehlen von og:title·og:image, lang="ko", viewport
koreanword-break: keep-all fehlt im body
a11y · contrastBilder ohne alt-Text, WCAG-AA-Kontrast unterschritten
mobileHorizontaler Scroll bei 390px, Text unter 16px (Button unter 44px: Warnung)
template · weightLila Farbverlauf, Floskeltexte, schwere Bilder (Warnung)
copy-stylehumanize-korean-Score nicht Risiko low, Pfad nicht light, Kommas nach Konjunktionen z>3, 'A가 아니라 B' 2x+ (Warnung). Übersprungen, wenn Tool fehlt (i)

Vergleich mit Muzli MCP

Muzli MCPhomepage-maker
ReferenzenNur Muzli-RedaktionskuratierungMuzli-öffentliche Sammlungen + SiteInspire·Land-book·Lapa Ninja·One Page Love·Awwwards
QuellenangabeNur im DialogVia data-ref auf jedem Abschnitt erzwungen, Fehler bei Fehlen
ReferenzanalyseBilder und BeschreibungDesktop- & Mobile-Captures + Schriftart·Größe·Farbe·Breite-Token
ErgebnisprüfungKeineFakten·Gesetze·lokale Geschäftsinfos·Mobile·Kontrast·Koreanisch-Gates + KI-Text-Score (humanize-korean)
Visuelle ÜberprüfungKeineVergleichsbild nebeneinander mit Referenzen
Deploymentmuzli.space (keine Suchindizierung, kein Formular, 10-Seiten-Limit)Vercel (Suchindizierung, eigene Domain möglich)
Koreanische BranchenKeineNaver Maps·Reservierung, JSON-LD, Herkunftsangabe, koreanischer Zeilenumbruch
Wo Muzli besser istKuratierung basierend auf 900.000 Designern, Nutzung der eigenen SammlungNur öffentliche Seiten, keine Personalisierung

Verwandte Skills