Communitygithub.com

Frontend-Style-Extraktor

Extrahiert und dokumentiert ein portables Frontend-Designsystem aus einer bestehenden Web-App oder einer zugänglichen Website.

Was ist Frontend-Style-Extraktor?

Der Frontend-Style-Extraktor ist ein Skill für KI-Agenten (z. B. Claude, Cursor, Codex), der aus einer bestehenden Frontend-Applikation (Repository oder öffentliche Website) ein vollständiges, framework-neutrales Portable Design System Bundle v1.0.0 erstellt. Der Skill analysiert systematisch UI-Stile, Design-Tokens, Typografie, Layouts, Komponenten, Interaktionen, Responsivität und generiert daraus wiederverwendbare Stilregeln. Er arbeitet strikt evidenzbasiert – alle Regeln und Tokens werden mit Quelle (z. B. Dateipfad, computed style), Vertrauensgrad und konkreten Belegen versehen. Der Skill unterstützt sowohl lokale Repositories als auch öffentliche URLs (eingeschränkt). Unbestätigte Werte werden explizit als Inferenzen gekennzeichnet. Der Workflow umfasst eine optionale Inventarisierung mittels eines Python-Skripts, die manuelle Überprüfung repräsentativer UI-Komponenten, die Auflösung von Regelhierarchien und die Validierung des generierten Bundles. Ziel ist ein Handoff-Vertrag für den Frontend-Style-Adapter, nicht die Kopie von Quellcode oder ein pixelgenauer Klon. Der Skill beachtet harte Grenzen: Kein Kopieren von Geschäftslogik, proprietären Assets oder Secrets; kein Verändern der Quell-App; separate Themes und Responsive-Regeln bleiben erhalten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaduroLabs/styleport/tree/HEAD/skills/frontend-style-extractor

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Frontend-Style-Extraktor?

Ziel

Erstellen eines evidenzbasierten, framework-neutralen Portable Design System Bundle v1.0.0 aus einem Quell-Frontend. Das Ergebnis ist ein Übergabevertrag für den frontend-style-adapter, KEIN kopierter Quellcode und KEIN pixelgenauer Klon.

Lies references/CONTRACT.md vor dem Erstellen des Bundles. Lies references/INSPECTION_CHECKLIST.md während der Inspektion. Erfinde keine Stilwerte oder stelle abgeleitete Muster als beobachtete Fakten dar.

Eingaben

  • Quelle: Repository-Root / Arbeitsbereich, ausgewählte Verzeichnisse oder eine zugängliche gerenderte Website.
  • Optional: bestimmte Seiten/Komponenten, Themes, Breakpoints, Designgenauigkeit, Ausgabepfad.
  • Standardwerte: Quelle = aktuelles Repository; Umfang = repräsentatives gemeinsames UI + im Repository auffindbare Routen/Seiten; Ausgabe = design-system/portable/ im Quell-Repository (sofern vom Benutzer kein anderer Ort gewünscht).
  • Eine öffentliche URL ohne zugängliches Quell-CSS oder berechnete Stile ist eine reine visuelle Quelle. Markiere exakte Pixel/Farb-/Abstandsmessungen als abgeleitet, sofern nicht über Tools messbar. Falls die Umgebung die Website nicht öffnen kann, erkläre die Einschränkung, anstatt eine Analyse zu erfinden.

Arbeitsablauf

  1. Orientieren ohne die Quelle zu verändern. Überprüfe Git-Status, Projektstruktur, Paketmanifest, Framework und Styling-Stack, Routen-/Seitenstruktur, globale Stile, Theme-Provider, Komponentenbibliotheken und Design-Tokens. Respektiere AGENTS.md und Repository-Anweisungen. Lese niemals .env, Geheimnisse oder irrelevante Daten.
  2. Führe optionale heuristische Inventarisierung durch (nur Stdlib; kein autoritärer CSS-Parser): python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json Verwende wenn möglich einen temporären Pfad außerhalb des Repositorys. Lies die Zusammenfassung; überprüfe wichtige Behauptungen direkt im Code/gerenderten UI.
  3. Untersuche repräsentatives UI: globales Shell, Navigation, Überschriften/Text, Buttons, Felder/Formulare, Karten, Tabellen, Modals, Alarme, Lade-/Leer-/Fehlerzustände; inspiziere Desktop und Mobil, Hover/Fokus/Deaktiviert, Hell/Dunkel falls unterstützt. Untersuche sowohl übliche als auch ungewöhnliche Routen. Dokumentiere untersuchte vs. übersprungene Oberflächen.
  4. Löse die Regelhierarchie auf: explizite Tokens/Konfiguration → gemeinsame Komponenten → wiederholte Seitenmuster → einmalige Ausnahmen. Verwechsele nicht das Layout einer einzelnen Seite mit einer globalen Regel. Behalte semantische Tokens und Aliase (z. B. var(--brand-primary)) bei, wenn sie sinnvoll sind; gebe tatsächliche aufgelöste Werte nur an, wenn sie verifiziert wurden.
  5. Dokumentiere die Herkunft: jeder Token und jede strukturierte Regel benötigt origin, confidence und konkrete evidence. Bevorzuge Dateipfad + Zeile/Symbol, computed-style-Beobachtung oder Screenshot-/Viewport-Referenz. Jede nicht unterstützte Inferenz muss als solche gekennzeichnet sein. Gib alle Einschränkungen, nicht untersuchten Seiten, Abhängigkeits-/Asset-Lizenzunsicherheiten an.
  6. Erstelle das Bundle am gewählten Ausgabepfad. Erforderliche Dateien: manifest.json, tokens.json, rules.json, README.md, typography.md, layout-rules.md, component-rules.md, interaction-rules.md, responsive-rules.md. Optional assets.md für Symbol-/Bild-/Schriftart-Hinweise. Siehe references/CONTRACT.md und assets/example-bundle/ für die Form; ersetze ALLE Beispielinhalte durch quellspezifische Beobachtungen. Verwende portable Sprache (Komponentenverträge und Designabsicht) anstelle von frameworkspezifischer Implementierung als einziger Beschreibung.
  7. Validieren: python3 <skill-root>/scripts/validate_bundle.py <bundle-path>. Behebe alle Fehler. Überprüfe unbekannte/niedrige Vertrauenspunkte manuell. Behaupte nicht, dass die visuelle Wiedergabetreue getestet wurde, wenn kein Browser-/Screenshot-Vergleich durchgeführt wurde.
  8. Bericht: Quelle und untersuchte Oberflächen, Framework/Styling-Methode, Ausgabepfad, Token-/Regelanzahl, Abdeckung/Unsicherheiten, Validierergebnis und Übergabeverwendung: Rufe frontend-style-adapter mit dem Designsystem-Pfad auf.

Harte Einschränkungen

  • Extrahiere Designsprache, nicht Geschäftslogik, Kopien, proprietäre Assets oder Implementierungsinterna.
  • Verändere nicht die App-Quelle, installiere keine Pakete, schreibe keine Konfiguration um oder committe automatisch. Das Erstellen des angeforderten Bundles ist erlaubt.
  • Kopiere keine Logos, Schriftart-Binärdateien, lizenzierte Bilder/Symbole in das Bundle, es sei denn, der Benutzer autorisiert dies ausdrücklich und die Rechte sind klar; beschreibe stattdessen ihr Erscheinungsbild, ursprüngliche Referenzen und Lizenzhinweise.
  • Übertrage keine .env, Anmeldeinformationen, Benutzerdaten, Live-API-Antworten oder Geheimnisse.
  • Behalte separate Dunkel-/Hell-Themes und responsive Regeln bei, falls vorhanden; glätte sie nicht zu einem einzigen Stil.
  • Exakte Implementierungsdetails gehören in evidence/Anmerkungen; Anforderungen sollten framework-übergreifend portabel bleiben.
  • Bevorzuge Klarheit gegenüber Umfang: hochwertige dokumentierte Muster sind besser als hunderte nicht unterstützter Tokens.
  • Wenn kein ausführbares UI/Browser verfügbar ist, melde visualVerification: "not_performed" im Manifest.

Erledigt, wenn

Bundle validiert; jeder exportierte Fakt nachvollziehbar; globale Regeln von Ausnahmen getrennt; Barrierefreiheits-/Responsive-Zustände adressiert; und der Bericht bekannte Lücken angibt.

Verwandte Skills