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.
| Zeitpunkt | Erforderliche Recherche |
|---|---|
| Vor dem Brief | Grundlegende Kundendaten (Adresse, Telefon, Öffnungszeiten, Parken, Reservierung, Speisekarte, Preise, Herkunft), Besucherkontext (Wer kommt in welcher Situation?), Werberegulierung der Branche |
| Vor den drei Richtungen | Wettbewerber, Präsenz alternativer Geschäfte (Bewertungen, Beschreibungen, Webseiten), Markendefinition |
| Vor der Textfestlegung | Keywords, Suchmaschinensichtbarkeit |
| Vor dem Deployment | Domain, 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.
- init — Überprüfen anhand der obigen Tabelle, ob die Vorrecherche abgeschlossen ist. Erstellt
sites/<slug>mitbrief.md,facts.md,refs.md,site/undrefs/. - 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).
- 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.
- Referenzen finden — Aus den Quellen in
references/sources.mdvon 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. - Erfassen und aufzeichnen — 5–8 ausgewählte Seiten mit
referfassen. Desktop- und Mobile-Screenshots sowie Schriftart, -größe, Farbe, Textbreite und Bewegungsgrad werden inrefs/<slug>/gespeichert und inrefs.mddokumentiert. Zu jeder Referenz wird eine Zeile notiert, was übernommen wurde. Layout, Fotos und Text werden nicht übernommen. Vorgehen siehereferences/moves.md. - ⛔ Drei Richtungen vorschlagen — Mit
boardwerdenout/board.pngund ein Ordnerout/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. - Abschnittsweises Erstellen —
site/index.html(+ CSS/Bilder insite/) abschnittsweise erstellen. Jedes<section>mitdata-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. - Textredaktion — Mit
copydie auf der Seite sichtbaren Texte blockweise extrahieren und insites/<slug>/_workspace/<Datum>-NNN-<tag>/01_input.txtspeichern (Bildquellen, Lizenzzeilen unddata-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.mderstellen,verify_gates.pybestehen lassen, dann nur die geänderten Sätze insite/übertragen. Zahlen, Eigennamen und Zitate werden nicht geändert. Fehlt das Tool, endet dieser Schritt nach der Textextraktion. - Check — Korrigieren, bis die Fehleranzahl (✗) null beträgt. Während der Arbeit kann mit
--draftder Fehlerstatus auf Warnung herabgesetzt werden, aber für Abnahme und Deployment muss der Check ohne--draftbestehen. - Visueller Vergleich — Mit
shots --comparewirdout/compare.pngerstellt, um die Seite neben den ausgewählten Referenzen zu betrachten.out/site-mobile.pngebenfalls ö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. - ⛔ Genehmigung — Genehmigung einholen mit
compare.png,site-mobile.pngundout/report.json. - Deployment —
deploylädt die Seite nur dann auf Vercel hoch, wenn der Check bestanden wurde. Zunächst wird das Projekt auf Vercel mit dem Ordnernamen (slugvonsites/<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;--prodwird erst nach Genehmigung verwendet. Die Verbindung einer eigenen Domain erfolgt ebenfalls erst nach Genehmigung.
Regeln
- Als Referenzquellen werden nur die in
references/sources.mdaufgeführten erlaubten Quellen verwendet. Seiten, die den Claude-Agenten per robots.txt blockieren (Godly, GDWEB), werden vonrefabgelehnt. 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
| Gate | Fehlerbedingung |
|---|---|
| refs | Weniger als 3 Referenzen mit dokumentierter Übernahme |
| attribution | Abschnitte ohne data-ref oder Verweis auf nicht in refs/ vorhandene Referenz |
| fact | Seitenzahl nicht in facts.md |
| placeholder | Vorhandensein von [...], 【...】, lorem, TODO |
| claim · origin | Unbelegte Exklusivbehauptungen, Fleischgerichte + Preis ohne Herkunftsangabe |
| local | Fehlen von LocalBusiness/Restaurant JSON-LD, tel:-Link, Naver-/Kakao-Maps-Link, Öffnungszeiten |
| meta | Fehlen von og:title·og:image, lang="ko", viewport |
| korean | word-break: keep-all fehlt im body |
| a11y · contrast | Bilder ohne alt-Text, WCAG-AA-Kontrast unterschritten |
| mobile | Horizontaler Scroll bei 390px, Text unter 16px (Button unter 44px: Warnung) |
| template · weight | Lila Farbverlauf, Floskeltexte, schwere Bilder (Warnung) |
| copy-style | humanize-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 MCP | homepage-maker | |
|---|---|---|
| Referenzen | Nur Muzli-Redaktionskuratierung | Muzli-öffentliche Sammlungen + SiteInspire·Land-book·Lapa Ninja·One Page Love·Awwwards |
| Quellenangabe | Nur im Dialog | Via data-ref auf jedem Abschnitt erzwungen, Fehler bei Fehlen |
| Referenzanalyse | Bilder und Beschreibung | Desktop- & Mobile-Captures + Schriftart·Größe·Farbe·Breite-Token |
| Ergebnisprüfung | Keine | Fakten·Gesetze·lokale Geschäftsinfos·Mobile·Kontrast·Koreanisch-Gates + KI-Text-Score (humanize-korean) |
| Visuelle Überprüfung | Keine | Vergleichsbild nebeneinander mit Referenzen |
| Deployment | muzli.space (keine Suchindizierung, kein Formular, 10-Seiten-Limit) | Vercel (Suchindizierung, eigene Domain möglich) |
| Koreanische Branchen | Keine | Naver Maps·Reservierung, JSON-LD, Herkunftsangabe, koreanischer Zeilenumbruch |
| Wo Muzli besser ist | Kuratierung basierend auf 900.000 Designern, Nutzung der eigenen Sammlung | Nur öffentliche Seiten, keine Personalisierung |