Communitygithub.com

brainzcode/premium-landing

Reconstrua um design com precisão a partir de uma referência fornecida — uma captura de tela, página PDF, mockup ou URL ao vivo — medindo-o numericamente em vez de estimá-lo visualmente.

O que é premium-landing?

Esta skill é projetada para desenvolvedores e agentes de IA que precisam replicar designs exatos a partir de referências visuais, eliminando a imprecisão da avaliação visual. Ela cobre desde a extração da caixa de conteúdo real de uma captura de tela (removendo bordas e molduras) até a derivação de posições de elementos como porcentagens, resolução de enquadramento de imagens com `object-fit: cover` e verificação numérica de recursos antes da implementação. A skill suporta plataformas como Claude Code, Cursor e Codex, e é ideal para tarefas onde o usuário solicita replicação "exata", "1 para 1" ou "sem erros". O método central envolve scripts em Python para medir elementos, comparar renderizações numericamente e sinalizar quando uma referência não pode ser correspondida, economizando horas de ajustes manuais.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Replicação de referência

O olho humano é bom em "algo está errado" e não confiável em "errado por quanto". Quando a instrução é "replique exatamente, sem erros", meça. Cada hora perdida ajustando um valor foi uma hora que um script de extração teria resolvido.

Nunca confie nas bordas da captura de tela

Capturas de tela chegam com letterbox, molduras de dispositivos ou bordas arredondadas do navegador. Medir com base nas dimensões do arquivo coloca cada porcentagem ligeiramente errada, e o erro é invisível porque tudo está quase certo.

Encontre a caixa de conteúdo real primeiro:

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]                    # uma coluna que é fundo da página
cols = np.nonzero(a[rows.min()+40, :] > 200)[0]
X0, X1, Y0, Y1 = cols.min(), cols.max(), rows.min(), rows.max()

Expresse cada medição subsequente como uma porcentagem dessa caixa, nunca do arquivo.

Extraia posições, não as estime

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

Janela cada elemento e defina um limite em sua faixa de luminância — UI escura sobre fundo claro, ou o contrário. Duas precauções:

  • Um resultado que cai exatamente na borda da sua janela é uma medição cortada, não uma descoberta. Aumente a janela e meça novamente.
  • Texto escuro e uma fotografia escura ambos passam por um limite "escuro". Escolha janelas que contenham apenas o elemento.

Converta para porcentagens da caixa de conteúdo e construa com base nelas. Agora "o título é grande demais" se torna "o título tem 22,4% da largura do painel na referência e 32% no meu".

Verifique uma afirmação antes de construí-la

Procure por um recurso duas vezes antes de se comprometer. Em uma construção, um par de linhas verticais finas foi "visto" em uma miniatura e implementado; a referência não tinha nenhuma — era a borda da silhueta do próprio sujeito. Uma verificação teria detectado:

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

Fundo plano, sem quedas, sem linhas. Uma regra de 1px aparece como uma queda isolada de coluna única; uma borda fotográfica aparece como uma rampa gradual. É trivial distingui-las numericamente e fácil de confundir visualmente.

Resolva o enquadramento de imagem, não o ajuste

Para reproduzir como uma fotografia é cortada, derive-o. Meça a largura do sujeito como uma fração da foto, e novamente como uma fração do painel:

escalaRender = larguraSujeito_noPainel / larguraSujeito_naFoto   # ex: 1.231

Com object-fit: cover escalando pela altura, larguraEscalada = larguraPainel × escalaRender, então proporcaoPainel = 1 / (escalaRender / proporcaoFoto). Isso dá a proporção do painel que o designer usou. Em seguida, resolva object-position a partir do centro do sujeito — a fórmula está em ../landing-page/references/traps.md.

Verifique a sanidade com uma quantidade independente que você não ajustou, como a altura da coroa do sujeito. Se a previsão cair dentro de um ou dois pixels, o modelo está correto.

Saiba quando uma referência não pode ser correspondida

Às vezes a matemática diz não. Se o object-position necessário cair fora de 0–1, nenhum valor coloca o sujeito lá — a proporção do painel ou a imagem precisa mudar.

E se um ativo fornecido é uma regeneração do original em vez do original, suas proporções serão diferentes. Detecte: preveja uma medição a partir da fonte e compare. Correspondência ao pixel em quatro amostras significa mesma imagem; uma incompatibilidade não uniforme (203px onde 282px é previsto, em apenas um ponto) significa um sujeito diferente.

Diga claramente, declare o que é correspondido — métricas de layout, enquadramento, posicionamento — e pare de perseguir o resto. Continuar "corrigindo" produz saída pior e queima o tempo do usuário.

Ambos os viewports, sempre

Uma referência é uma captura de tela de desktop e uma captura de tela mobile. Construir apenas para desktop e inferir mobile inverte a parte difícil — mobile é onde as correções são aplicadas. Se apenas uma foi fornecida, peça a outra antes de começar.

Ciclo de trabalho

  1. Extraia a caixa de conteúdo; meça cada elemento em uma tabela de porcentagens.
  2. Construa tokens e layout com base nesses números.
  3. Renderize na proporção da referência, escale a referência para sua largura, empilhe-as verticalmente com um divisor brilhante. Empilhado é melhor que lado a lado — o olho acompanha uma borda vertical.
  4. Meça novamente seu render com o mesmo script. Compare tabelas, não impressões.
  5. Repita por seção. Não passe para a próxima seção se a atual estiver visivelmente errada.

Lista de verificação

  • Caixa de conteúdo extraída; porcentagens relativas a ela, não ao arquivo
  • Nenhuma medição na borda de sua janela de busca
  • Cada "recurso" confirmado numericamente antes de implementar
  • Enquadramento de imagem resolvido, não ajustado
  • Referências de desktop e mobile em mãos
  • Render medido novamente com o mesmo script e 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.

Habilidades Relacionadas