Communitygithub.com

supersite-build

Chirurgischer Website-Builder für KI-Codierungsagenten. Liest den Spezifikationsvertrag supersite-plan.md, generiert saubere, komponierbare React/Next.js-Komponenten, verdrahtet Design-Tokens und verifiziert die Kompilierung mit npm run build.

Was ist supersite-build?

supersite-build ist eine spezialisierte Fähigkeit für KI-Codierungsagenten (wie Claude Code, Cursor oder Codex), die den architektonischen Bauplan von /supersite-plan präzise umsetzt. Die Fähigkeit liest die vertragliche Spezifikation supersite-plan.md, analysiert ästhetische Genres, Farbpaletten, Typografie, Routen- und Komponentenmanifeste und generiert daraus saubere, komponierbare React/Next.js-Komponenten. Der gesamte Workflow ist in fünf Schritte unterteilt: Validierung des Spezifikationsvertrags, Erstellung von Typescript-Typen und Konfiguration, modulare UI-Primitive (Container, Button, Badge, Card), sektionsbasierte Blöcke (Navbar, Hero, Feature Grid, Pricing, Footer) und abschließend die Montage der Routen sowie die Verifikation des Builds mit npm run build. Besonders wertvoll ist die eingebaute Vor-Flug-Prüfung gegen generische Platzhalter, die Einhaltung der Zero-Em-Dash-Regel und die Sicherstellung von Touch-Zielen ≥44×44px. Fehlerhafte Builds werden automatisch repariert, bis eine saubere Kompilierung erreicht ist. Die Fähigkeit unterstützt Next.js-Projekte mit TypeScript, Tailwind CSS und Lucide Icons und erzeugt eine strukturierte, semantische und barrierefreie Codebasis.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/developer-mohanaditya/supersite/tree/HEAD/skills/supersite-build

In Ihrer bevorzugten KI fragen

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

Dokumentation

🔨 supersite-build: Chirurgischer Builder

supersite-build setzt den architektonischen Plan von /supersite-plan um. Es liest supersite-plan.md, konstruiert atomare Komponenten, verdrahtet Design-Tokens und Kopien, und validiert die Implementierung gegen die Build-Engine.


Die Ausführungspipeline

┌─────────────────────────────────────────────────────────────┐
│ 1. Lese & valiere Spezifikationsvertrag                     │
│ Parse Tokens, Routen und Manifest aus supersite-plan.md     │
├─────────────────────────────────────────────────────────────┤
│ 2. Grundgerüst, Typen & Konfiguration                       │
│ Erstelle src/types/site.ts, src/config/site.ts & Basis CSS  │
├─────────────────────────────────────────────────────────────┤
│ 3. Baue UI-Primitive                                        │
│ Container, SectionHeader, Button, Badge & Card              │
├─────────────────────────────────────────────────────────────┤
│ 4. Baue Abschnittsblöcke                                    │
│ Navbar, Hero, Contrast, Features, Proof, Pricing & Footer   │
├─────────────────────────────────────────────────────────────┤
│ 5. Montiere Routen & verifiziere Build                      │
│ Verdrahte Seiten, prüfe Barrierefreiheit & führe npm run build aus│
└─────────────────────────────────────────────────────────────┘

Schritt 1: Lese & valiere supersite-plan.md

  1. Suche nach supersite-plan.md im Stammverzeichnis des Workspace.
    • Wenn nicht vorhanden, pausiere und informiere den Benutzer:

      „Keine supersite-plan.md im Stammverzeichnis des Projekts gefunden. Bitte führe /supersite-plan aus, um deinen Plan gemeinsam zu entwerfen, oder führe /supersite <prompt> aus, um direkt zu generieren.“

  2. Parsee die architektonischen Parameter aus dem Plan:
    • Ästhetisches Genre & Farbpalette (Hex/OKLCH, 60-30-10 Verteilung).
    • Typografie- und Eckenradius-Auswahl.
    • Routen- und Komponentenmanifest.
    • Abschnittskopien, Überschriften und interaktive Elemente.

Schritt 2: Grundgerüst, Typen & Konfiguration

  1. Überprüfe Abhängigkeiten:
    • Stelle sicher, dass Standardwerkzeuge vorhanden sind (lucide-react, clsx, tailwind-merge). Installiere fehlende:
      npm install lucide-react clsx tailwind-merge
      
  2. Generiere TypeScript-Verträge (src/types/site.ts):
    • Definiere Typen für NavItem, FeatureItem, PricingPlan, Testimonial und FAQItem.
  3. Generiere zentralisierte Konfiguration (src/config/site.ts):
    • Speichere Navigationslinks, Markenmetadaten und strukturierte Abschnittsinhalte an einem Ort.
  4. Aktualisiere Basis-CSS (src/app/globals.css):
    • Füge Farbvariablen, Auswahlstile und den Accessibility-Block für reduzierte Bewegung ein:
      @layer base {
        ::selection {
          background-color: var(--accent);
          color: var(--accent-foreground);
        }
      }
      
      @media (prefers-reduced-motion: reduce) {
        *, ::before, ::after {
          animation-duration: 0.01ms !important;
          animation-iteration-count: 1 !important;
          transition-duration: 0.01ms !important;
          scroll-behavior: auto !important;
        }
      }
      

Schritt 3: Baue UI-Primitive (src/components/ui/)

Generiere modulare Primitive:

  • container.tsx: Max-Breite Container (max-w-6xl oder max-w-7xl) mit responsive Padding.
  • section-header.tsx: Standardisierter Badge-, Titel- und Beschreibungsblock.
  • button.tsx: Variantengetriebener Button (primary, secondary, outline, ghost) mit explizitem :focus-visible Stil.
  • badge.tsx: Pill- und Status-Chips mit feinen Haarline-Rändern.
  • card.tsx: Oberflächen-Wrapper, der die Oberflächenfarbe, Rahmen- und Radius-Tokens des Plans anwendet.

Schritt 4: Baue Abschnittsblöcke (src/components/site/)

Konstruiere jeden im Plan spezifizierten Abschnitt:

  • navbar.tsx: Responsiver Header mit Desktop-Navigationslinks, Action-CTA und mobilem Hamburger-Drawer.
  • hero.tsx: Hook-Pill, H1-Titel, Lead-Absatz, CTA-Cluster und interaktive Produktvorschau (z.B. Terminal- oder UI-Frame).
  • problem-contrast.tsx: Asymmetrischer visueller Kontrast, der den Status-quo-Schmerz versus die moderne Lösung veranschaulicht.
  • feature-grid.tsx: Asymmetrisches Bento-Raster oder modulare Feature-Zellen. Keine repetitiven 3-Karten-Kopien.
  • product-showcase.tsx: Interaktive Komponente (Tab-basierter Code-Explorer, Live-Interaktive Vorschau oder Konfigurations-Spielplatz).
  • social-proof.tsx: Überprüfbare Metrik-Kennzahlen und Kundenmeinungen mit spezifischen Ingenieursrollen.
  • pricing-matrix.tsx: Monatlicher/Jährlicher Abrechnungsumschalter (mit "use client"), Tarifkarten, Feature-Checklisten und Checkout-CTAs.
  • faq-accordion.tsx: Erweiterbares technisches Q&A mit sanften CSS-Grid-Höhenübergängen.
  • footer.tsx: Mehrspaltige Navigationslinks, rechtliche Anker, Systemstatus-Punkt und Copyright.

Schritt 5: Montiere Routen & verifiziere Build

  1. Montiere src/app/page.tsx:
    • Importiere Abschnittskomponenten und komponiere das narrative Layout in sauberem, deklarativem JSX.
  2. Montiere zusätzliche Routen:
    • Wenn der Plan mehrseitige Routen spezifiziert hat (/features, /pricing, /security), konstruiere die entsprechenden page.tsx-Dateien.
  3. Führe Vor-Flug-Prüfung gegen generische Platzhalter durch:
    • Prüfe auf verbotene Stile: keine lila Farbverlaufsblobs, keine unverankerten Karten, keine generischen Platzhalterkopien.
    • Prüfe Berührungsziele: überprüfe, ob interaktive Trefferflächen ≥44×44px groß sind.
    • Prüfe auf Em-Dashes: überprüfe, ob null Em-Dashes (— oder --) in allen UI-Kopien, Überschriften, Mikrokopien und Button-Beschriftungen vorhanden sind.
  4. Kompiliere & Build-Tor:
    • Führe den Build-Befehl des Workspace aus:
      npm run build
      
    • Bei einem TypeScript-Fehler oder fehlendem Import behebe ihn sofort und führe ihn erneut aus, bis der Build sauber mit Code 0 durchläuft.
  5. Berichte dem Benutzer:
    • Setze in allen Gesprächsantworten und Fortschrittsberichten die Zero-Em-Dash-Regel durch (verwende niemals — oder --). Verwende stattdessen Punkte, Doppelpunkte, Kommas oder Klammern.
    • Gib eine saubere Zusammenfassung der erstellten Dateien mit klickbaren Links:
      • [supersite-plan.md](file:///pfad/zu/supersite-plan.md)
      • [page.tsx](file:///pfad/zu/src/app/page.tsx)
      • Individuelle Komponentenlinks in src/components/site/
    • Bestätige die erfolgreiche Kompilierung.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills