Communitygithub.com

brainzcode/premium-landing

Reconstruye con precisión un diseño a partir de una referencia suministrada (captura de pantalla, PDF, maqueta o URL en vivo) midiéndolo numéricamente en lugar de hacerlo a ojo.

¿Qué es premium-landing?

Este skill está diseñado para desarrolladores e ingenieros de frontend que necesitan replicar o clonar un diseño de forma exacta, especialmente cuando la instrucción es «hazlo 1 a 1, sin errores». Su enfoque principal es eliminar la subjetividad visual: en lugar de ajustar valores a ojo, se extraen medidas precisas del contenido real de una captura de pantalla, ignorando bordes, marcos de dispositivo o cromo del navegador. Con código Python (PIL + NumPy) se obtiene la caja de contenido real, se miden las posiciones de los elementos como porcentajes y se verifica que no haya errores de recorte o de interpretación visual (como confundir un borde fotográfico con una línea UI). También cubre cómo resolver el encuadre de imágenes con `object-fit: cover` y detecta cuándo una referencia no puede ser replicada fielmente, ahorrando tiempo al usuario. Está pensado para plataformas como Claude Code, Cursor, Codex o cualquier agente que construya landing pages o interfaces a partir de referencias visuales. Su utilidad es crítica para ahorrar horas de ajustes manuales y garantizar una réplica exacta, tanto en desktop como en móvil.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Replicación de referencias

El ojo es bueno para detectar «algo está mal» pero malo para saber «cuánto está mal». Cuando la instrucción es «replícalo exactamente, sin errores», mide. Cada hora perdida ajustando un valor fue una hora que un solo script de extracción habría terminado.

Nunca confíes en los bordes de la captura de pantalla

Las capturas llegan con formato letterbox, con marco de dispositivo o con un cromo de navegador redondeado. Medir contra las dimensiones del archivo pone cada porcentaje ligeramente incorrecto, y el error es invisible porque todo está casi bien.

Encuentra primero la caja de contenido real:

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]                    # una columna que es fondo de página
cols = np.nonzero(a[rows.min()+40, :] > 200)[0]
X0, X1, Y0, Y1 = cols.min(), cols.max(), rows.min(), rows.max()

Expresa cada medición posterior como un porcentaje de esa caja, nunca del archivo.

Extrae posiciones, no las estimes

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()

Ventana cada elemento y umbraliza en su banda de luminancia — UI oscura sobre fondo claro, o viceversa. Dos precauciones:

  • Un resultado que cae exactamente en el borde de tu ventana es una medición recortada, no un hallazgo. Amplía la ventana y vuelve a medir.
  • El texto oscuro y una fotografía oscura pasan ambos un umbral «oscuro». Elige ventanas que contengan solo el elemento.

Convierte a porcentajes de la caja de contenido y construye con esos valores. Ahora «el titular es demasiado grande» se convierte en «el titular mide el 22.4% del ancho del panel en la referencia y el 32% en el mío».

Verifica una afirmación antes de construirla

Busca una característica dos veces antes de comprometerte. En una construcción, un par de líneas verticales finas fueron «vistas» en una miniatura e implementadas; la referencia no las tenía — era el borde de la silueta del sujeto. Una sola comprobación lo habría detectado:

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

Fondo plano, sin caídas, sin líneas. Una regla de 1px aparece como una caída aislada de una sola columna; un borde fotográfico aparece como una rampa gradual. Son triviales de distinguir numéricamente y fáciles de confundir a simple vista.

Resuelve el encuadre de imágenes, no lo ajustes a ojo

Para reproducir cómo se recorta una fotografía, derívalo. Mide el ancho del sujeto como fracción de la foto, y de nuevo como fracción del panel:

escalaRender = anchoSujeto_enPanel / anchoSujeto_enFoto   # p.ej. 1.231

Con object-fit: cover escalando por altura, anchoEscalado = anchoPanel × escalaRender, así que aspectoPanel = 1 / (escalaRender / aspectoFoto). Eso da la proporción del panel que usó el diseñador. Luego resuelve object-position desde el centro del sujeto — la fórmula está en ../landing-page/references/traps.md.

Haz una verificación de cordura con una cantidad independiente que no hayas ajustado, como la altura de la coronilla del sujeto. Si la predicción cae dentro de uno o dos píxeles, el modelo es correcto.

Reconoce cuándo una referencia no se puede igualar

A veces las matemáticas dicen que no. Si el object-position requerido cae fuera de 0–1, ningún valor coloca al sujeto ahí — hay que cambiar el aspecto del panel o la imagen.

Y si un recurso suministrado es una regeneración del original en lugar del original, sus proporciones diferirán. Detéctalo: predice una medida de la fuente y compárala. Coincidir al píxel en cuatro muestras significa la misma imagen; una discrepancia no uniforme (203px donde se predicen 282px, en un solo punto) significa un sujeto diferente.

Dilo claramente, indica qué está igualado — métricas de diseño, encuadre, colocación — y deja de perseguir el resto. Seguir «arreglándolo» produce peor resultado y desperdicia el tiempo del usuario.

Ambos viewports, siempre

Una referencia es una captura de escritorio y una captura de móvil. Construir solo escritorio e inferir móvil invierte la parte difícil — el móvil es donde caen las correcciones. Si solo se suministró una, pide la otra antes de empezar.

Ciclo de trabajo

  1. Extrae la caja de contenido; mide cada elemento en una tabla de porcentajes.
  2. Construye tokens y diseño con esos números.
  3. Renderiza en el aspecto de la referencia, escala la referencia a tu ancho, apílalos verticalmente con un divisor brillante. Apilado gana a lado a lado — el ojo sigue un borde vertical.
  4. Vuelve a medir tu render con el mismo script. Compara tablas, no impresiones.
  5. Repite por sección. No pases a una sección que esté visiblemente incorrecta.

Lista de verificación

  • Caja de contenido extraída; porcentajes relativos a ella, no al archivo
  • Ninguna medición posada en el borde de su ventana de búsqueda
  • Cada «característica» confirmada numéricamente antes de implementar
  • Encuadre de imagen resuelto, no ajustado a ojo
  • Referencias de escritorio y móvil en mano
  • Render vuelto a medir con el mismo script y comparado como números

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.

Skills relacionados