Communitygithub.com

clone-design

Clonagem ponta a ponta de sites, remix de landing pages e extração de DESIGN.md. Use quando o Codex precisar clonar um site/página 1:1 a partir de uma URL, transformar um site de origem em uma landing page local para o projeto atual, extrair o sistema de design de um site para DESIGN.md, analisar linguagem visual ou sintetizar múltiplas páginas/capturas em orientações de design reutilizáveis.

O que é clone-design?

O skill clone-design capacita o agente de IA a clonar sites completos a partir de URLs, remixar landing pages para projetos locais e extrair sistemas de design em um arquivo DESIGN.md. Ele suporta dois modos principais: o 'Modo A: Remix de Landing Page', que clona um site 1:1, preserva o layout, substitui texto e imagens por conteúdo do projeto atual, e gera uma landing page final; e o 'Modo B: Extração de Sistema de Design', que analisa clones e capturas para produzir diretrizes de design, incluindo paleta de cores, tipografia e comportamento. O skill lida com páginas renderizadas no servidor e no cliente, permite múltiplas capturas em sessões autenticadas e utiliza scripts localizados para automação. Ideal para desenvolvedores que usam Codex, Cursor ou Claude Code, ele elimina o trabalho manual de clonagem e análise de design, garantindo fidelidade visual e gerando documentação reutilizável.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add Charlo-O/clone-design

Perguntar na sua IA favorita

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

Documentação

O que clone-design faz?

Clone um site primeiro e depois remixe-o em uma landing page específica do projeto ou destile-o em DESIGN.md.

Postura padrão: preserve o layout renderizado do site de origem sem desvio criativo até que o clone 1:1 tenha sido verificado. Somente depois disso você pode substituir o texto, as imagens e o conteúdo específico da marca para o projeto atual.

Quando Usar

Use este skill quando o usuário pedir para:

  • clonar um site ou landing page a partir de uma URL
  • replicar uma landing page 1:1 antes de adaptá-la
  • transformar a landing page de outro site em uma landing page para o projeto local atual
  • substituir o texto do site clonado por texto da pasta do projeto atual
  • substituir as imagens clonadas por assets raster gerados relevantes ao projeto
  • transformar um site em DESIGN.md
  • extrair o sistema de design de um site
  • analisar a linguagem visual de uma página
  • analisar uma UI de produto logada ou workspace
  • sintetizar orientações de design a partir de múltiplas páginas ou estados
  • transformar um clone de UI em orientações de design reutilizáveis
  • transformar uma URL diretamente em um pacote de design

Escolha o Modo

Modo A: Remix de Landing Page

Use este modo quando o usuário quiser clonar outra landing page e adaptá-la ao projeto atual.

Pipeline:

URL -> clone 1:1 -> página local verificada -> mapa de texto do projeto -> assets imagegen -> landing page final

Leia e siga:

Modo B: Extração de Sistema de Design

Use este modo quando o usuário quiser DESIGN.md, análise de linguagem visual ou orientações de design.

Pipeline:

URL ou clone.html -> captura(s) -> design-md/<slug>/

Leia e siga:

Regras de Captura de Origem

Se o usuário fornecer uma URL:

  • não peça ao usuário para instalar ou executar frontend-ui-clone separadamente
  • crie primeiro um snapshot HTML autocontido
  • reutilize o mesmo fluxo de clonagem e escada de fidelidade do frontend-ui-clone
  • salve o material de origem sob captures/<slug>/
  • inclua clone.html para cada página ou estado capturado
  • adicione capturas de tela e um despejo de tokens quando útil
  • verifique o clone em um navegador antes de remixar ou destilar

Se o usuário fornecer um arquivo .html local:

  • use-o diretamente
  • aceite um arquivo, vários arquivos ou um diretório de captura que contenha vários arquivos clone.html

Evite remixar ou escrever DESIGN.md a partir de uma busca HTTP bruta quando o site depender de renderização no lado do cliente.

Caminhos Padrão

Se o usuário não especificar caminhos:

Arquivos de captura:

  • pasta de captura de página única: captures/<slug>/
  • pasta de captura de múltiplas páginas: captures/<slug>/<page-slug>/
  • arquivos por página: clone.html, homepage.png, live.json
  • manifesto de captura opcional do site: captures/<slug>/capture-plan.json

Saída do remix de landing page:

  • pasta de saída: landing-pages/<slug>/
  • página final: index.html
  • clone de origem verificado: source-clone.html
  • inventário extraído: content-inventory.json
  • assets gerados: assets/generated/
  • arquivos de planejamento e QA:
    • copy-map.json
    • image-plan.json
    • qa/original-desktop.png
    • qa/clone-desktop.png
    • qa/final-desktop.png
    • capturas de tela móvel opcionais

Saída da extração de design:

  • pasta de saída: design-md/<slug>/
  • arquivos de saída:
    • DESIGN.md
    • README.md
    • preview.html
    • preview-dark.html
  • arquivo de evidência opcional: evidence.json

Padrão de Clone 1:1

Quando a entrada for uma URL:

  • prefira ferramentas internas do navegador/Playwright quando disponíveis
  • use a mesma viewport padrão e estratégia de rolagem do frontend-ui-clone
  • preserve o DOM renderizado, CSS, fontes e URLs de assets resolvidos
  • preserve a estrutura DOM original, nomes de classe, ordem de seções, espaçamentos, raios, sombras, tipografia, gradientes e comportamento responsivo
  • não redesenhe, simplifique, renomeie a marca ou reorganize o layout antes que o clone verificado exista
  • se a página precisar de autenticação, deixe o usuário completar o login no navegador e mantenha o mesmo contexto do navegador ativo
  • após o login, capture cada página ou estado de UI solicitado separadamente na mesma sessão
  • se a primeira captura tiver um herói em branco ou problema óbvio de sobreposição, aplique a mesma mentalidade de escalada do frontend-ui-clone:
    • Nível 1: clone DOM + CSS
    • Nível 1a: clone híbrido com correções direcionadas
    • Nível 1b: cozimento de estilo direcionado
  • faça QA de captura de tela desktop em aproximadamente 1440 x 900
  • faça QA de captura de tela móvel em aproximadamente 390px de largura quando a página for responsiva
  • corrija incompatibilidades visíveis antes de continuar

Não rastreie automaticamente um aplicativo autenticado inteiro, a menos que o usuário peça explicitamente essa amplitude. Prefira um conjunto selecionado de páginas ou estados chave.

Regras de Remix

Ao adaptar uma landing page clonada para o projeto atual:

  1. Inspecione a pasta do projeto atual para obter contexto do produto antes de escrever o texto. Prefira README, PRODUCT.md, package.json, landing pages existentes, docs, strings de origem, capturas de tela e assets da marca.
  2. Execute scripts/extract_landing_inventory.py no clone verificado para semear o planejamento de texto e imagem.
  3. Construa um mapa de texto do texto visível original para o texto de substituição. Preserve a mesma hierarquia de conteúdo e comprimento aproximado do texto para que o layout permaneça intacto.
  4. Substitua nomes de marca, títulos, subtítulos, CTAs, rótulos de recursos, depoimentos, texto de FAQ e texto de rodapé por linguagem relevante ao projeto.
  5. Mantenha o layout de origem, temporização de animação, ordem de seções e estrutura de componentes, a menos que o usuário peça explicitamente alterações estruturais.
  6. Inventarie imagens raster, mídia de herói, miniaturas, avatares, mockups de produto e fotos decorativas.
  7. Use o skill imagegen para substituições raster relevantes ao projeto quando a imagem de origem não deve permanecer. Salve os assets gerados em landing-pages/<slug>/assets/generated/ e atualize as referências HTML/CSS.
  8. Prefira preservar as dimensões originais da imagem, proporção de aspecto, comportamento de corte, object-fit, raio de borda e peso visual.
  9. Não substitua ícones SVG simples, marcas vetoriais, gradientes CSS ou decoração geométrica por bitmaps gerados, a menos que o usuário peça.
  10. Remova ou substitua logotipos de terceiros, nomes, capturas de tela e marcas registradas, a menos que o usuário explicitamente queira mantê-los para um clone de referência privada.
  11. Verifique a página adaptada final no navegador após a substituição de texto e imagem. Corrija estouro de texto, imagens quebradas, quebra de linha móvel e mudanças de layout.

Geração de DESIGN.md

Para o modo de extração de design, use o script agrupado:

python3 scripts/generate_design_md.py "$CLONE_HTML" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

Para múltiplas páginas capturadas:

python3 scripts/generate_design_md.py \
  "captures/$SLUG/home/clone.html" \
  "captures/$SLUG/workspace/clone.html" \
  "captures/$SLUG/settings-modal-open/clone.html" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

Ou escaneie uma raiz de captura diretamente:

python3 scripts/generate_design_md.py \
  --capture-dir "captures/$SLUG" \
  --name "$SITE_NAME" \
  --url "$SITE_URL" \
  --out-dir "design-md/$SLUG" \
  --json-out "design-md/$SLUG/evidence.json"

Omita flags opcionais quando você não tiver esses valores.

Após a geração:

  • leia o DESIGN.md produzido
  • aperte a redação vaga
  • mantenha as reivindicações de token fundamentadas na origem
  • marque declarações incertas como inferidas

Nunca invente:

  • cores não presentes no clone
  • famílias de fontes não observadas no CSS
  • breakpoints que não foram extraídos
  • interações que exigem estado de tempo de execução que você não capturou
  • alegações de cobertura para páginas ou fluxos que você não incluiu na sessão

Seções obrigatórias de DESIGN.md:

  1. Tema Visual e Atmosfera
  2. Paleta de Cores e Funções
  3. Regras de Tipografia
  4. Estilizações de Componentes
  5. Princípios de Layout
  6. Profundidade e Elevação
  7. O que Fazer e o que Não Fazer
  8. Comportamento Responsivo
  9. Guia de Prompt do Agente

Resposta Final

Para o modo de remix de landing page, relate:

  • URL de origem
  • pasta de captura e caminho do clone verificado
  • pasta da landing page final e index.html
  • quais arquivos do projeto informaram o texto de substituição
  • quantas substituições de texto foram feitas
  • quantas imagens geradas foram criadas e onde foram salvas
  • verificação de navegador desktop/móvel realizada
  • quaisquer limitações, como interações não capturadas ou assets que não puderam ser substituídos de forma limpa

Para o modo de extração de design, relate:

  • onde a pasta de captura foi salva, se você clonou de uma URL
  • se ela contém um clone.html ou várias pastas de página com seus próprios clone.html e, opcionalmente, homepage.png / live.json
  • onde a pasta de saída foi salva
  • se ela contém DESIGN.md, README.md, preview.html e preview-dark.html
  • onde evidence.json foi salvo, se gerado
  • se o resultado veio de uma fonte de clone forte ou de um fallback mais fraco
  • quantas páginas ou estados foram incluídos na síntese final
  • quaisquer limitações notáveis

Habilidades Relacionadas