Communitygithub.com

brainzcode/premium-landing

Rekonstruiere ein Design präzise aus einer Referenz (Screenshot, PDF, Mockup oder Live-URL) durch numerische Messung statt durch Schätzen. Verwende dies bei Anfragen, ein Design „exakt“, „1 zu 1“ oder „fehlerfrei“ zu replizieren oder nachzubauen.

Was ist premium-landing?

Diese Skill ermöglicht es, ein Design aus einer Referenz (Screenshot, PDF, Mockup oder Live-URL) millimetergenau zu reproduzieren – basierend auf numerischer Messung statt auf visuellem Schätzen. Sie extrahiert zunächst den tatsächlichen Inhaltsbereich aus einem oft gepolsterten Screenshot (Letterboxing, Geräterahmen, abgerundete Ecken) und drückt alle Elementpositionen als Prozentsätze dieses Bereichs aus, nicht des Dateibildes. Damit werden Abweichungen wie „Die Überschrift ist zu groß“ zu präzisen Zahlen (z. B. 22,4 % vs. 32 % der Panelbreite). Die Skill unterstützt die Extraktion von Bounding Boxen über Luminanzschwellen, die Überprüfung von behaupteten Merkmalen (z. B. dünne Linien vs. Fotokanten) und die Berechnung von `object-fit`- und `object-position`-Werten für Bilder. Sie erkennt auch, wann eine Referenz nicht exakt nachgebaut werden kann (z. B. falsche Bildproportionen) und stoppt dann die Verschwendung von Zeit. Plattformen: Entwickler-Workflows mit Python (PIL, NumPy) – ideal für Claude Code, Cursor, Codex und ähnliche KI-Agenten, die präzises UI-Design umsetzen müssen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/reference-replication

In Ihrer bevorzugten KI fragen

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

Dokumentation

Referenzreplikation

Das Auge ist gut darin, „etwas stimmt nicht“ zu erkennen, aber unzuverlässig bei „um wie viel“. Wenn die Aufgabe lautet „repliziere es exakt, keine Fehler“, dann miss. Jede Stunde, die mit Herumjustieren eines Werts verloren geht, ist eine Stunde, die ein Extraktionsskript beendet hätte.

Vertraue niemals den Rändern des Screenshots

Screenshots kommen mit Letterboxing, Geräterahmen oder abgerundeten Browser-Ecken an. Wenn du anhand der Dateiabmessungen misst, ist jeder Prozentsatz leicht falsch, und der Fehler bleibt unsichtbar, weil fast alles richtig aussieht.

Finde zuerst den tatsächlichen Inhaltsbereich:

from PIL import Image
import numpy as np
a = np.array(Image.open(src).convert('RGB')).astype(int).sum(axis=2)/3
rows = np.nonzero(a[:, 5] > 200)[0]                    # eine Spalte, die den Seitenhintergrund darstellt
cols = np.nonzero(a[rows.min()+40, :] > 200)[0]
X0, X1, Y0, Y1 = cols.min(), cols.max(), rows.min(), rows.max()

Drücke jede nachfolgende Messung als Prozentsatz dieses Bereichs aus, niemals als Prozentsatz der Datei.

Extrahiere Positionen, schätze sie nicht

def bbox(x0, x1, y0, y1, lo, hi):
    reg = a[y0:y1, x0:x1]
    ys, xs = np.nonzero((reg >= lo) & (reg <= hi))
    return x0+xs.min(), x0+xs.max(), y0+ys.min(), y0+ys.max()

Fenstere jedes Element ein und setze einen Schwellenwert auf sein Luminanzband – dunkle UI auf hellem Hintergrund oder umgekehrt. Zwei Warnungen:

  • Ein Ergebnis, das genau auf deiner Fensterkante liegt, ist eine abgeschnittene Messung, kein Fund. Vergrößere das Fenster und miss erneut.
  • Dun­kler Text und ein dun­kles Foto über­schreiten beide einen „dun­klen“ Schwellenwert. Wähle Fenster, die nur das Element enthalten.

Wandle in Prozentsätze des Inhaltsbereichs um und baue entsprechend. Dann wird aus „die Überschrift ist zu groß“ „die Überschrift ist 22,4 % der Panelbreite in der Referenz und 32 % in meiner".

Überprüfe eine Behauptung, bevor du sie umsetzt

Suche ein Merkmal zweimal, bevor du dich festlegst. Bei einem Build wurden vertikale haarfeine Linien in einer Miniaturansicht „gesehen“ und implementiert; die Referenz hatte keine – es war die eigene Silhouettenkante des Motivs. Eine Überprüfung hätte es verhindert:

band = a[60:330, :].mean(axis=0)          # Zeilen ohne andere UI
dips = [i for i in range(200, W-200) if band[i] < 228 - 0.8]

Flacher Hintergrund, keine Einbrüche, keine Linien. Eine 1px-Linie zeigt sich als isolierter Einzelspalten-Einbruch; eine Fotokante als allmähliche Rampe. Numerisch sind sie trivial zu unterscheiden, mit dem Auge leicht zu verwechseln.

Löse die Bildrahmung, justiere nicht daran herum

Um zu reproduzieren, wie ein Foto beschnitten ist, leite es her. Miss die Breite des Motivs als Bruchteil des Fotos und erneut als Bruchteil des Panels:

renderScale = subjectWidth_inPanel / subjectWidth_inPhoto   # z. B. 1,231

Bei object-fit: cover, das nach Höhe skaliert: scaledW = panelW × renderScale, also panelAspect = 1 / (renderScale / photoAspect). Das ergibt das Panel-Seitenverhältnis, das der Designer verwendet hat. Löse dann object-position aus dem Zentrum des Motivs – die Formel steht in ../landing-page/references/traps.md.

Überprüfe mit einer unabhängigen Größe, die du nicht angepasst hast, etwa der Höhe der Krone des Motivs. Liegt die Vorhersage innerhalb von ein oder zwei Pixeln, ist das Modell richtig.

Erkenne, wann eine Referenz nicht nachgebaut werden kann

Manchmal sagt die Mathematik Nein. Liegt der erforderliche object-position außerhalb von 0–1, kann kein Wert das Motiv dort platzieren – das Panel-Seitenverhältnis oder das Bild muss sich ändern.

Und wenn ein geliefertes Asset eine Neuerstellung des Originals ist und nicht das Original, unterscheiden sich seine Proportionen. Erkenne es: sage eine Messung aus der Quelle voraus und vergleiche sie. Stimmt sie auf vier Stichproben pixelgenau überein, handelt es sich um dasselbe Bild; ein uneinheitlicher Fehler (203 px, wo 282 px vorhergesagt werden, an nur einer Stelle) bedeutet ein anderes Motiv.

Sage es klar, nenne, was übereinstimmt – Layout-Metriken, Rahmung, Platzierung – und höre auf, den Rest zu verfolgen. Weiter zu „korrigieren“ produziert schlechtere Ausgabe und verschwendet die Zeit des Benutzers.

Beide Viewports, immer

Eine Referenz ist ein Desktop-Screenshot und ein mobiler Screenshot. Nur den Desktop zu bauen und das Mobile abzuleiten, dreht den schwierigen Teil um – Mobile ist der Ort, an dem die Korrekturen landen. Wurde nur eine Ansicht geliefert, fordere die andere an, bevor du beginnst.

Arbeitsablauf

  1. Extrahiere den Inhaltsbereich; miss jedes Element in eine Prozenttabelle.
  2. Baue Tokens und Layout nach diesen Zahlen.
  3. Rendere im Seitenverhältnis der Referenz, skaliere die Referenz auf deine Breite, stapele sie vertikal mit einem hellen Trenner. Gestapelt ist besser als nebeneinander – das Auge verfolgt eine vertikale Kante.
  4. Messe deinen Render erneut mit demselben Skript. Vergleiche Tabellen, nicht Eindrücke.
  5. Wiederhole pro Abschnitt. Gehe nicht von einem Abschnitt weiter, der sichtbar falsch ist.

Checkliste

  • Inhaltsbereich extrahiert; Prozentsätze relativ zu ihm, nicht zur Datei
  • Keine Messung an ihrer Suchfensterkante
  • Jedes „Merkmal“ numerisch bestätigt, bevor es implementiert wurde
  • Bildrahmung gelöst, nicht justiert
  • Desktop- und mobile Referenzen vorhanden
  • Render mit demselben Skript erneut gemessen und als Zahlen verglichen

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

brainzcode/premium-landing

Source free, licence-clear photography for a site from Unsplash — searching by mood rather than noun, sizing and cropping for the slot, honouring the API's hotlink and download-tracking requirements, and writing real alt text. Use when a page needs a hero image, section photography, avatars or card art and none was supplied; when placeholder greys need replacing with real imagery; or when asked to find, pick or swap photos for a design.

Verwandte Skills