Communitygithub.com

Portfolio Forge

Transforma informações pessoais em um site/portfólio pessoal esteticamente impecável. Fluxo: documento de conteúdo como única fonte de verdade → geração de imagens de referência por seção → revisão adversarial imagem por imagem → replicação de alta fidelidade com Codex Frontend App Builder → QA headless seção por seção → deploy reversível no Cloudflare Pages. Acionado quando o usuário diz 'fazer site pessoal', 'fazer portfólio', 'personal website', 'portfolio site', 'transformar minhas informações em site', 'me ajudar com uma landing page'.

O que é Portfolio Forge?

Portfolio Forge é um skill de agente de IA especializado em transformar informações pessoais brutas (perfil, experiência, projetos) em sites/portfólios pessoais de altíssima qualidade estética, prontos para publicação. A habilidade segue um pipeline validado em seis estágios: (0) esclarecimento de posicionamento via entrevista, (1) criação de um documento de conteúdo como única fonte de verdade, (2) geração de imagens de referência por seção usando o skill `imagegen-frontend-web`, (3) revisão adversarial de cada imagem de referência para garantir qualidade, (4) replicação de alta fidelidade com Codex Frontend App Builder, (5) QA headless seção por seção com Puppeteer, e (6) deploy reversível no Cloudflare Pages. O diferencial está em três etapas críticas que garantem qualidade real: documento de conteúdo para evitar alucinações, revisão adversarial sistemática de cada imagem, e validação headless antes do deploy. Suporta Claude (para entrevista, documentação, revisão, QA e orquestração) e Codex (para geração de imagens e replicação frontend), com dependências externas como Chrome + Puppeteer para QA e Wrangler para deploy.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Heng-xiu/xiuxiu-agent-skills/tree/HEAD/skills/portfolio-forge

Perguntar na sua IA favorita

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

Documentação

O que Portfolio Forge faz?

Transforma "informações de uma pessoa" em um site pessoal esteticamente impecável e publicável. O núcleo é um pipeline validado: Documento de conteúdo (única fonte de verdade) → Imagens de referência → Revisão adversarial → Replicação de alta fidelidade → QA seção por seção → Deploy reversível.

Inspirado no método de quatro passos "faça um site pessoal com Codex em duas horas" (organizar conteúdo → gerar imagens de referência com taste → gerar ativos → replicar), este skill solidifica três etapas que realmente determinam a qualidade e que o original não ensina: documento de conteúdo contra alucinações, revisão adversarial imagem por imagem, e validação headless antes do deploy.

Quando Acionar

  • "Fazer site pessoal" "Fazer portfólio" "Transformar minhas informações em site"
  • "personal website" "portfolio" "Me ajudar com uma landing page"
  • "Quero uma página pessoal para mostrar" "No era da IA, site pessoal é currículo"
  • Até mesmo apenas "Me ajuda a fazer um site" "Colocar minhas coisas numa página"

Pré-requisitos (Verificar no Primeiro Uso)

Este pipeline requer três ferramentas externas. Se faltarem, instale (veja métodos em workflows/reference-image-gen.md e início de workflows/frontend-replication.md):

  1. taste-skill imagegen-frontend-web — Gera imagens de referência de alta estética por seção. Instale em ~/.claude/skills/ e ~/.codex/skills/.
  2. Plugin build-web-apps do Codex (com skill Frontend App Builder) — Replicação de alta fidelidade. codex plugin add build-web-apps@openai-curated.
  3. Chrome + puppeteer-core — QA headless para capturar screenshots por seção.

Princípios Fundamentais

  1. Documento de conteúdo é a única fonte de verdade: Antes de começar, organize o perfil da pessoa / posicionamento / estilo / paleta de cores / estrutura de seções em um arquivo CONTENT.md. Depois, qualquer texto gerado por IA nas imagens de referência que não corresponda ao documento deve ser ignorado — o documento é soberano. Esta é a base contra alucinações.
  2. Revisão adversarial imagem por imagem: As imagens de referência não são para replicar diretamente; são para desafiar. Pergunte para cada imagem: "O tamanho da fonte está exagerado? Tem espaço para respirar? A composição caiu em padrão de IA? Tem texto alucinado? As imagens são consistentes entre si?" Se não passar, regere apenas aquela imagem. Este passo determina se o resultado final será "aceitável" ou "realmente bonito".
  3. Ativos reais têm prioridade: Fotos reais da pessoa, screenshots de projetos reais — use sempre os reais. IA é usada apenas para gerar "imagens de referência de estilo" e "ativos estilizados", nunca para falsificar rostos ou screenshots. Se o usuário forneceu fotos, use-as diretamente, não gere outras.
  4. QA seção por seção é o único critério de conclusão: A replicação não é entrega; é validação. Use Puppeteer para rolar a página real, capturar screenshots de cada seção, e compará-las lado a lado com as imagens de referência. Se algo não corresponder, volte para o estágio de replicação e itere.
  5. Deploy reversível, sem mexer em ativos existentes: O deploy é sempre primeiro em um subdomínio independente *.pages.dev. Antes de tocar no domínio existente do usuário, verifique as vinculações e trate a decisão de "mudar o domínio" como escolha do usuário, sem agir por conta própria.
  6. Texto em linguagem humana primeiro (feedback de usuário de julho de 2026): O texto do site e materiais de divulgação, por padrão, são escritos para leitores não técnicos — termos de stack tecnológico (framework, banco de dados, provedor de serviços) não aparecem no corpo do texto; em vez disso, diga "o que isso faz, para quem serve". Termos técnicos só são mantidos se a entrevista confirmar que o público é técnico. Instruções de instalação/uso priorizam comandos do tipo "entregue este parágrafo para seu assistente de IA", em vez de comandos de terminal.

Fluxo de Trabalho (Seis Estágios)

Estágio 0: Esclarecer Posicionamento (Entrevista para Convergência)

Siga workflows/content-intake.md. Use AskUserQuestion para convergir as decisões-chave: para quem é o site, posicionamento, estilo visual, idioma e escala, fonte dos ativos, trabalhos selecionados, CTA principal, destino do deploy. Opções de estilo conforme references/design-style-library.md (estilo é o input mais importante na geração de imagens com taste).

Estágio 1: Documento de Conteúdo (Única Fonte de Verdade)

Organize os resultados da entrevista + dados externos capturados (site existente, Substack, redes sociais) em CONTENT.md, seguindo o formato de references/content-doc-template.md. Este documento é a base para todos os estágios seguintes.

Estágio 2: Gerar Imagens de Referência por Seção

Siga workflows/reference-image-gen.md. Divida a página em 6–8 seções. Use imagegen-frontend-web para gerar uma imagem por seção (via codex exec em segundo plano). Salve em refs/.

Estágio 3: Revisão Adversarial + Iteração (A Alma)

Siga workflows/adversarial-design-review.md. Primeiro, leia cada imagem e a desafie por conta própria. Depois, submeta para revisão do usuário. As que não passarem, regere apenas aquela imagem. Este passo pode exigir várias rodadas — é normal, não pule.

Estágio 4: Replicação de Alta Fidelidade

Siga workflows/frontend-replication.md. Entregue o pacote completo ("imagens de referência aprovadas + CONTENT.md + ativos reais") para o Codex Frontend App Builder, com o objetivo de replicação 1:1, orientado a dados, com animações e RWD. Os efeitos dinâmicos são selecionados de references/motion-effects-library.md (11 receitas de efeitos validados na prática) e listados um a um no prompt de replicação — regra de ferro: movimento serve ao tema, respeite prefers-reduced-motion, no máximo 1 efeito grande por página.

Estágio 5: QA Seção por Seção

Siga a primeira metade de workflows/headless-qa-and-deploy.md. Use Puppeteer para rolar a página real e capturar screenshots de cada seção. Compare com as imagens de referência usando references/qa-checklist.md. Se algo não corresponder, volte para o Estágio 4.

Estágio 6: Deploy + Smoke Test

Siga a segunda metade de workflows/headless-qa-and-deploy.md. Faça deploy no Cloudflare Pages em subdomínio independente *.pages.dev → execute smoke test headless online (status HTTP + carregamento de assets + screenshot da primeira tela) → devolva a decisão de domínio ao usuário.

Design de Subagentes / Ferramentas

As tarefas pesadas deste pipeline são delegadas ao Codex (geração de imagens, replicação). O Claude fica responsável pela entrevista, redação de documentos, revisão adversarial, QA de validação e orquestração do deploy.

  • Geração de Imagens / Replicação: codex exec --skip-git-repo-check --full-auto "<prompt>", usando run_in_background: true para execução em segundo plano. Valide após a conclusão.
  • Captura de Dados Externos: WebFetch (site existente, perfil e artigos do Substack).
  • QA com Screenshots: Chrome headless ou puppeteer-core (veja notas de armadilhas no workflow para screenshots por seção).
  • Deploy: wrangler pages.

Estratégia de paralelismo: As 7–8 imagens de referência são geradas sequencialmente em uma única execução de codex exec (o skill imagegen já gera uma por vez); para regenerar, execute novamente apenas as imagens que precisam de ajustes.

Tom de Comunicação

  • Todo o texto em português (PT-BR), termos técnicos e identificadores mantidos no original.
  • Em cada estágio, primeiro diga "O que vou fazer", depois reporte ativamente a conclusão, sem esperar perguntas.
  • Na revisão adversarial, seja direto: aponte exatamente o que não funciona em cada imagem, dê direções específicas de melhoria.
  • Após entrega/deploy, reporte ativamente quatro coisas: branch, commit hash, se foi mergeado (merged), e se a worktree foi limpa.
  • Antes de tocar no domínio existente do usuário / ativos externos, devolva a decisão ao usuário.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas