Communitygithub.com

webbuild

Erstelle professionelle, unverwechselbare, pitchreife Business-Websites – mit scrollgesteuerten ‚3D‘-Hero-Bereichen (KI-Video per Scroll abgetastet), Echtzeit-Three.js/React Three Fiber-Szenen, GSAP- + Lenis-Animationen und bearbeiteten Video-Shadern – die NICHT wie KI-generiert aussehen.

Was ist webbuild?

Die Skill „webbuild“ ist ein umfassender Workflow für KI-Agenten zur Erstellung von hochwertigen Business-Websites, die sich qualitativ deutlich von typischen KI-Vorlagen abheben. Sie deckt den gesamten Prozess ab: von der Briefing-Erfassung und Recherche über das Designsystem und die Auswahl des Hero-Effekts bis hin zu Build, visueller Qualitätssicherung und Deployment. Die Skill unterstützt plattformunabhängiges Arbeiten (einfaches HTML/CSS/ES-Module-Setup oder Integration in bestehende Frameworks wie Next.js, Astro oder R3F). Der Fokus liegt auf handwerklicher Sorgfalt – Entscheidungen vor dem Code und ehrliches, kritisches Betrachten des Ergebnisses. Ein wichtiges Merkmal ist die integrierte Qualitätssicherung mittels Screenshot-Analyse (`shoot.mjs`) und einem „Slop-Linter“ (`slop_check.py`), der sicherstellt, dass generische KI-Muster vermieden werden und die Website lieferbereit ist. Die Skill enthält detaillierte Referenzen (Designsystem, 3D-Playbook, Scroll-Video-Playbook, Reverse-Engineering, Pitch-Vorlagen) und Skripte für die automatisierte Analyse von Referenzseiten, die Erstellung von Frame-Sequenzen und die visuelle Überprüfung. Der letzte Schritt ist ein Pitch-Kit für den Verkauf der Website an lokale Unternehmen.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Harishisonline/webbuild-skill/tree/main

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht webbuild?

Erstelle Websites, für die ein Geschäftsinhaber bezahlen würde: spezifisch für ihn, schnell auf dem Handy, ein unvergesslicher Moment und nichts, das nach „das hat eine KI gemacht“ schreit. Die Handwerkskunst liegt größtenteils in den Entscheidungen vor dem Code und im ehrlichen Betrachten des Ergebnisses danach.

Die Pfade unten sind relativ zum Ordner dieser Skill (scripts/, references/, assets/).

0. Projekt einrichten (2 Min.)

  • Neue Website → Kopiere assets/starter/ in den Projektordner (reines HTML + CSS + ES-Module, feste CDN-Importe, kein Build-Schritt: überall bereitstellbar, einfach zu bearbeiten). Verwende Next.js / Astro / R3F nur, wenn der Benutzer danach fragt oder das Projekt sie bereits verwendet (references/3d-playbook.md §5).
  • Bestehendes Projekt → Behalte dessen Framework, Tokens und Komponenten; diese Skill fügt Richtung, Bewegung und Qualitätssicherung hinzu, keine Neuschreibung.
  • Erstelle BUILD_NOTES.md im Projekt. Es ist das Gedächtnis über Kontext-Resets hinweg: Kurzbeschreibung, Entscheidungen, offene Fragen, Korrekturen, die funktioniert haben.

1. Briefing – das echte Geschäft verstehen

Sammle (vom Benutzer, von der aktuellen Website des Unternehmens, vom Google Business-Profil, von Instagram): Name, was sie verkaufen, wo, seit wann, die eine primäre Aktion (Anruf / Buchung / Bestellung / Angebot / Besuch), echte Beweise (Bewertung + Anzahl, Jahre, Lizenzen, Presse), echte Fotos, Logo/Farben, Öffnungszeiten, Adresse, Telefon. Schreibe das 5-zeilige Briefing aus references/design-system.md §2 in die BUILD_NOTES.md.

Erfinde niemals Fakten – erfundene Bewertungen, Statistiken, Preise oder Adressen in einem Pitch zerstören das Vertrauen, sobald der Eigentümer sie liest. Stattdessen:

  • Schreibe um Unbekanntes herum, sodass die Demo trotzdem fertig aussieht: „Koregaon Park, Pune“ anstelle einer erfundenen Hausnummer; „Bewertet mit 4,7 auf Google“ anstelle erfundener Zitate; Dienstleistungsnamen ohne Preise oder „ab ₹…“ nur, wenn bekannt.
  • Wo eine Tatsache zwingend erforderlich ist (Telefon, genaue Adresse, Öffnungszeiten), verwende einen sichtbaren {{Platzhalter}} – slop_check.py blockiert die Auslieferung, bis es ausgefüllt ist.
  • Setze jede Unbekannte und Annahme auf eine „Fragen Sie den Kunden“-Liste für den Abschlussbericht.

Für eine Creator- oder Channel-Website frage (oder ziehe) die Dashboard-Zahlen und das Profilbild im Voraus: YouTube Studio / Instagram Insights Screenshots sowie vidIQ oder ähnliches, falls verbunden. Ein aus echten Zahlen aufgebauter Abschnitt „Ergebnisse“ ist der Verkaufsfaktor.

Wenn das Briefing dünn ist und der Benutzer in der Nähe ist, stelle maximal 3 Fragen (Unternehmen + Stadt, primäre Aktion, eine Website, die sie lieben). Wenn sie wollen, dass du einfach loslegst, triff vernünftige Annahmen, schreibe sie auf und mach weiter.

2. Referenz (wenn der Benutzer eine Website nennt, eine Aufnahme sendet oder einen „Neubau“ möchte)

Folge references/reverse-engineer.md: node scripts/teardown.mjs <url> misst den Stack, die Schriften, die Palette, Medien und Shader-Nachweise und macht Screenshots des Scrollens; Bildschirmaufnahmen werden zu Frames, die du liest und in eine detaillierte Bewegungsvorgabe umwandelst. Wenn dieser schnelle Durchlauf einen Effekt nicht erklären kann, gehe mit der REA-Engine tiefer: scripts/rea-teardown.sh <url> erfasst die Seite, nimmt Fingerabdrücke des Bundles und exportiert jedes Skript, damit du lesen kannst, wie es tatsächlich gebaut ist (Anleitungen in references/rea/). Dokumentiere BEOBACHTET → SCHLUSSFOLGERUNG → ENTSCHEIDUNG. Lerne die Technik; kopiere niemals Marke, Kopie, Assets oder Code.

3. Richtung – plane, dann greife den Plan an

Lies references/design-system.md (die Anti-Slop-Regeln – klassisch und die neueren „geschmackvollen KI“-Anzeichen wie Creme + Terrakotta, GROSSBUCHSTABEN-Augenbrauen, editoriale Haarlinien). Schreibe in BUILD_NOTES.md:

  • 4–6 benannte Farb-Tokens, die vom Unternehmen stammen, Typ-Kombination + Rollen, Radius-Sprache
  • ASCII-Drahtmodell jedes Abschnitts (variiere den Rhythmus – kein Held → 3 Karten → Logos → Testimonials)
  • den Signature-Moment (genau einen) und warum er zu diesem Unternehmen passt
  • 3 Prinzipien, die es unverwechselbar machen

Überprüfe dann den Plan anhand der Erkennungsliste und rechtfertige für jede Wahl, die wie ein Standardwert wirkt, warum sie für dieses Unternehmen richtig ist, oder ändere sie. Die Frage „Könnte diese Website einem anderen Unternehmen gehören, wenn ich das Logo austausche?“ fängt die meisten Probleme hier, wo sie billig zu beheben sind.

Für eine unentschlossene Richtung, die der Benutzer wählen möchte, zeige 2–3 wirklich unterschiedliche Richtungen (jeweils ein Standbild oder eine kurze HTML-Skizze), bevor du baust – 21st-ui-explore kann helfen, wenn es installiert ist.

4. Hero-Bereich – wähle den Modus, der dem Unternehmen dient

references/3d-playbook.md §1 enthält die Entscheidungstabelle. Kurzfassung:

  • Standbild (gutes Foto / Typografie) – Restaurants, Lebensmittel, Salons, Kliniken, Dienstleistungen. Oft die richtige Wahl.
  • Video – Atmosphären-Schleife, idealerweise bearbeitet mit assets/starter/grade.js, damit KI-/Stock-Filmmaterial eine maßgeschneiderte Gradierung erhält (Korn, Halation, Lift/Gamma/Gain, Vignette). Wähle einen LOOK und halte ihn subtil.
  • Frames – die „10.000-Dollar-3D-Website“: KI-Start-/End-Keyframes → Video des ersten/letzten Frames → scripts/frames.sh → Canvas, das durch Scrollen abgetastet wird. Lies references/scroll-video-playbook.md für die Keyframe-Regeln, Prompts und das Blending.
  • Szene – live Three.js / R3F, wenn 3D die Produktgeschichte ist (konfigurierbares Produkt, Architektur, Technik). Das Objekt muss die Sache des Unternehmens sein, niemals der Platzhalter-Knoten.
  • Ganze Seite – wenn der Eigentümer nach einer „3D-Website“ fragt, meint er normalerweise 3D durchgängig, nicht nur einen 3D-Hero. Verwende eine feste Szene mit einer Kamerastation pro Abschnitt (references/3d-playbook.md §6).

Generiere Assets mit dem, was verbunden ist (Higgsfield / Kling / kie.ai / Nano Banana MCPs oder Skills), oder bitte den Benutzer, Dateien abzulegen. Wenn nichts verfügbar ist, baue mit einem klar gekennzeichneten Platzhalter und liste genau auf, welches Asset mit welchem Prompt generiert werden soll.

5. Bauen

Reihenfolge: Tokens (styles.css :root) → semantische HTML-Abschnitte mit echtem Text → Layout bei 390px und 1440px → Hero-Modus → Bewegung zuletzt.

  • Textregeln: references/design-system.md §8 (Ergebnis + Ort + Details, echte CTA-Verben, verbotene Wörter).
  • Erforderlich für eine Business-Website: ein offensichtlicher CTA oberhalb der Falz und noch einmal am Ende, tel: / Buchung / Formular, Öffnungszeiten + Adresse + Kartenlink, echte Beweise, Titel + Beschreibung + OG-Bild, LocalBusiness-JSON-LD, Favicon, sticky Call/Book-Leiste auf Mobilgeräten, wenn die Aktion ein Anruf ist.
  • Bewegung: ein Signature-Moment + leises 150–300 ms Micro-Feedback; ease-out, niemals bounce; nur transform/opacity; reduced-motion zeigt Endzustände.
  • Komponenten: Suche in references/resources.md-Registern (21st.dev, React Bits, Aceternity, Motion Primitives…), bevor du komplexe Effekte von Hand schreibst, und style sie dann auf die Tokens um. Erstelle in einer statischen Website React-Komponenten in Vanilla neu, anstatt React für einen Effekt hinzuzufügen.
  • Footer: Baue ihn nach references/design-system.md §11 (Markenblock, Linkspalten mit Plattformlogos, Kontakttasten, überdimensionales Wortmarken, untere Reihe). Eigentümer beurteilen die gesamte Website danach. Der kleine Builder-Hinweis ist bereits im Starter enthalten; der Kunde kann um Entfernung bitten.
  • Buttons und Scroll: Folge references/design-system.md §12 (taktile 0,16 s Buttons, Cursor-Ring via cursor.js des Starters, keine native Scrollleiste: blockbar.js des Starters ersetzt sie).
  • Bevor du es als erledigt bezeichnest, lies noch einmal references/design-system.md §10: die Dinge, die Eigentümer immer noch als „Slop“ bezeichnen, nachdem alle Regeln bestanden wurden.

6. Anschauen – hier entstehen gute Websites

Lokal bereitstellen (npx serve . oder den Dev-Server des Projekts), dann:

  1. node scripts/shoot.mjs http://localhost:3000 ./shots – Handy / Laptop / Desktop Screenshots während des Scrollens + Konsolenfehler, Überläufe, LCP, Gewicht. Lies die PNGs. (Oder verwende den Browser-Bereich / Playwright MCP, falls verfügbar.) Führe es auch einmal mit --reduced-motion aus.
  2. python3 scripts/slop_check.py . – muss mit 0 FAIL enden. Behandle WARNs als Fragen. (npx impeccable detect ist eine gute zweite Meinung, falls installiert.)
  3. Kritisiere ehrlich anhand des Briefings: Hierarchie, Typografie, Farbe, der Signature-Moment, Mobilversion, Spezifität des Textes. Korrigiere in Chargen mit klarer Absicht („Untere Abschnitte wirken generisch – mach sie teurer, nicht überladener“).
  4. Entferne ein dekoratives Element, bevor du es als erledigt bezeichnest.

Erwarte 3–6 Runden; niemand schafft das auf Anhieb. Dokumentiere, was was behoben hat, in BUILD_NOTES.md.

7. Ausliefern + Pitchen

  • Bereitstellen: Vercel / Netlify / Cloudflare Pages / GitHub Pages. Commite den Frames-Ordner (der häufigste Grund, warum der Hero in der Produktion verschwindet). Füge <meta name="robots" content="noindex"> zu spezifischen Demos hinzu, bis der Kunde kauft.
  • Wenn es ein Pitch ist, lies references/pitch-and-sell.md: Vorher/Nachher-Video, Outreach-Skripte, Preisanker, die pitchbereite Checkliste, Übergabe.

Abschlussbericht an den Benutzer

Halte es kurz und konkret:

  • Was gebaut wurde (Richtung in einem Satz, Signature-Moment, Hero-Modus) und wo (Pfade, URL)
  • Wie man es ausführt (npx serve . oder der Dev-Befehl)
  • QA-Ergebnisse: slop_check FAIL/WARN-Anzahl, shoot.mjs LCP / Fehler pro Viewport, was du angesehen und behoben hast
  • Fragen Sie den Kunden-Liste: jeder {{Platzhalter}} und jede Annahme
  • Noch zu generierende Assets (mit gebrauchsfertigen Prompts), falls vorhanden

Referenzkarte

LesenWann
references/design-system.mdImmer, vor der Wahl von Farbe/Schrift/Layout/Text
references/3d-playbook.mdBei der Wahl des Hero-Bereichs; Three.js/R3F; Performance + a11y-Budget
references/scroll-video-playbook.mdScrollgesteuerter „3D“-Hero aus KI-Video
references/reverse-engineer.mdEine Referenz-Website, eine Aufnahme oder Neubau einer potenziellen Kundenwebsite
references/rea/README.mdTiefer gehen als teardown.mjs mit REA-Werkzeugen
references/resources.mdKomponentenregister, Effektwerkzeuge, Inspiration, Begleit-Skills
references/pitch-and-sell.mdSpezifikationsseite für einen Interessenten, Preisgestaltung, Kontaktaufnahme, Übergabe
SkriptFunktion
scripts/teardown.mjs <url>Eine Referenzseite vermessen (Stack, Schriften, Palette, Medien, Shader, Screenshots)
scripts/rea-teardown.sh <url>Tiefenanalyse mit REAs Engine: Seitenaufnahme, Fingerabdrücke des Bundles, exportierte Skripte
scripts/frames.sh <video> <out>Video → WebP-Framesequenzen (Desktop + Mobil) + Manifest
scripts/shoot.mjs <url> [out]Screenshots in 3 Breiten entlang des Scrollens + Fehler/LCP/Überläufe
scripts/slop_check.py <dir>KI-Slop- + Auslieferungsbereitschafts-Linter (0 FAIL zum Ausliefern)

Playwright für die .mjs-Skripte: npm i -D playwright && npx playwright install chromium.

Verwandte Skills