Communitygithub.com

portfolio-build

Constrói ou reconstrói um portfólio de designer para que um revisor o entenda em 30 segundos, a partir de um único arquivo de conteúdo e um de três grids de página comprovados (um perfil fixo ao lado de trabalhos em largura total, uma grade de duas colunas ou um estudo de caso longo por projeto).

O que é portfolio-build?

Esta skill cria sites de portfólio estáticos e focados, garantindo que a primeira impressão seja clara e impactante em apenas 30 segundos. Ela oferece três grids de layout comprovados — perfil fixo com trabalhos em largura total, grade de duas colunas ou estudo de caso longo — que o designer escolhe. A skill extrai todo o conteúdo de um único arquivo JSON e usa um script Python para gerar HTML e CSS puros, sem frameworks ou dependências. Ela também inclui verificações de auditoria integradas, identificando problemas comuns e slots de informações faltantes, além de recursos como comparação de grids e carregamento de fontes personalizadas. Ideal para designers, diretores de arte, ilustradores, fotógrafos e outros criativos que desejam um portfólio profissional e de rápida compreensão.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/adrituyo/30s/tree/main/skills/portfolio-build

Perguntar na sua IA favorita

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

Documentação

Portfolio build

Um portfólio tem cerca de 30 segundos na primeira visita. Esta skill constrói um que usa bem esses segundos: quem você é e o que faz na primeira tela, trabalho real ao lado, sua parte em cada projeto indicada e uma forma clara de entrar em contato.

Ela corrige a estrutura e deixa a aparência para a pessoa. Os três grids decidem onde as coisas vão e em que ordem. Tipo de letra, cor, raio do canto e espaçamento são dela, definidos em um bloco pequeno. Dois portfólios construídos com esta skill devem ter a mesma estrutura de leitura e parecer completamente diferentes.

Os caminhos abaixo são relativos à pasta desta skill.

Como funciona

Um arquivo, portfolio.json, contém tudo: quem é a pessoa, os projetos, o grid escolhido e a aparência. Um comando transforma isso em um site estático (HTML e CSS puros, sem framework, nada para instalar):

python3 scripts/build.py caminho/para/o-site-do-designer/portfolio.json

O site é gerado ao lado do arquivo de conteúdo. Em seguida, o script imprime duas listas: o que uma auditoria de 30 segundos ainda sinalizaria, cada linha vinculada a um número de regra (references/rules.md tem as dezessete em uma linha cada), e cada [slot] aguardando um fato. Trate ambas como a lista de tarefas.

Etapas

1. Descubra para que serve o portfólio

Pergunte ou deduza a partir do que foi fornecido:

  • O alvo. O cargo ou cliente a que se destina. Define o título principal, a ordem e o que é omitido.
  • O trabalho. Quais projetos e, para cada um: o que era, a parte da pessoa, para quem era, o ano, uma decisão que ela tomou e o que aconteceu como resultado.
  • O material. Onde estão as imagens e vídeos.

Se a pessoa já tem um site existente, leia-o primeiro e transfira o que já está lá. Se a skill portfolio-audit estiver disponível e houver um site ativo, executá-la primeiro informa exatamente o que mudar.

Pergunte apenas o que você não consegue encontrar. Uma pessoa com uma pasta de imagens e uma página no LinkedIn já lhe deu a maior parte. Se ninguém estiver disponível para responder, continue com o que você tem e use slots (etapa 3).

Material sobre o qual a pessoa está insegura (um caderno de esboços, um projeto de estudante, algo antigo) fica de fora. Ela duvidou por um motivo, e um portfólio é julgado pelo seu ponto mais fraco. Diga o que foi omitido e por quê. Três projetos fortes são um portfólio completo; não adicione itens apenas para chegar a quatro.

2. Deixe a pessoa escolher o grid

Leia references/grids.md. Ele descreve os três grids e para quem cada um é adequado. O grid decide como todo o site será lido, então é a escolha da pessoa, não sua. Sua parte é tornar essa escolha fácil.

Antes de construir, nomeie os três em uma mensagem curta, uma linha cada, diga qual você recomenda para o trabalho e alvo dela e por quê, e pergunte qual ela quer. Junte isso com qualquer outra pergunta necessária da etapa 1, para que haja apenas uma rodada de perguntas, não duas.

  • Se ela já nomeou um grid, use-o e não reabra a questão.
  • Se ela escolher um diferente da sua recomendação, construa o dela. Diga uma vez o que isso custa, se for relevante (por exemplo, index não tem espaço para uma decisão e um resultado), e então deixe de lado.
  • Se ela estiver insegura, ou ninguém estiver lá para responder, siga com sua recomendação e construa com --compare na etapa 5, para que todos os três estejam disponíveis para abrir lado a lado.

Mudar depois é uma palavra no arquivo, então ninguém fica preso. Isso é um motivo para oferecer a escolha de forma leve, não um motivo para pulá-la.

3. Escreva o arquivo de conteúdo

Copie assets/example/portfolio.json como ponto de partida e leia references/content.md para cada campo. Coloque-o na pasta que se tornará o site, com as imagens ao lado. O exemplo usa o grid case; para index e columns, decision e result são opcionais e linhas de antes/depois raramente são necessárias.

Como escrever as partes mais importantes:

  • Título: uma frase que diz o que a pessoa faz e para quem, com um fato incluído. Não deve servir para o site de mais ninguém. "Designer de produto para aplicativos fintech. Oito anos, mais recentemente líder do fluxo de savings na Ledger." Não "Profissional multidisciplinar apaixonado por criar experiências."
  • Prova: os três ou quatro nomes ou números mais fortes, logo após o título.
  • Ordem: o projeto que melhor se encaixa no alvo vai primeiro, independentemente da data. Quatro a oito projetos. Disciplinas secundárias (filme para um diretor de arte, ilustração para um designer de produto) são melhor como um segundo site com seu próprio arquivo de conteúdo do que misturadas.
  • Cada projeto: um resumo de uma linha, a função desempenhada e se foi para um cliente, um empregador ou um conceito pessoal. Para alvos de produto e liderança, adicione a decisão e o resultado.
  • Função: o cargo atual da pessoa como é, não o que ela está pleiteando.
  • Pedido: uma frase acima do e-mail que diz sobre o que escrever.
  • Idioma: escreva no idioma do público da pessoa e defina site.lang. As palavras do próprio template (Index, Facts, Next…) seguem para inglês e espanhol; para qualquer outro idioma, defina-as em labels.

Use apenas fatos que a pessoa forneceu ou que estão em suas páginas existentes. Um fato que você deduziu, como um nome de cliente lido de um nome de arquivo, pode ser usado, mas informe a pessoa que foi inferido para que ela confirme.

Onde um fato estiver faltando, escreva um slot entre colchetes ([ano], [tamanho da equipe], [o que foi lançado]). Slots aparecem no site exatamente como escritos e a build lista cada um, então:

  • Mantenha o título livre de slots: escreva-o com o que você sabe. Um slot na primeira frase é a primeira coisa que um visitante lê.
  • Se um campo inteiro for desconhecido e opcional (cidade, equipe, site.url), omita o campo.
  • Para trabalho sem resultado, diga a verdade: "Lançado em 2024; não tenho os números", "Conceito, não implementado". Isso é um resultado. Uma promessa vazia de impacto não é.
  • Um site com slots é um rascunho. Diga isso claramente na entrega.

Um portfólio com uma lacuna honesta é aceitável. Um portfólio com um cliente inventado é um problema em uma entrevista.

4. Defina a aparência

No bloco theme: claro ou escuro, uma cor de destaque, o tipo de letra, raio do canto, espaçamento entre imagens. Se a pessoa tem uma marca ou um site existente, tire-os daí. Se ela não tem nada, escolha um tipo de letra e uma cor de destaque que combinem com o trabalho dela e diga o que escolheu. Não copie a aparência do exemplo ou de qualquer outro site de designer.

Um tipo de letra que não está em todos os dispositivos precisa de font_url para carregá-lo; nomeá-lo apenas em font faz com que a maioria dos visitantes use a fonte do sistema. Forneça ambos ou escolha uma pilha de fontes do sistema.

5. Construa, veja, corrija

Execute a build. Se a pessoa não escolheu um grid, adicione --compare:

python3 scripts/build.py caminho/para/o-site-do-designer/portfolio.json --compare

Isso também escreve o mesmo conteúdo em todos os três grids em uma pasta compare/, com uma página que os vincula. Mostre essa página para a pessoa e deixe-a escolher. compare/ é apenas para escolha: exclua-a antes de publicar.

Em seguida, visualize em um navegador em largura de desktop e celular, se possível: inicie python3 -m http.server na pasta do site (o grid case vincula a pastas de projeto, que precisam de um servidor) e verifique a primeira tela você mesmo: nome, o que faz, prova, uma forma de contato e um trabalho real, sem rolagem.

Se não puder abrir um navegador, informe isso na entrega e, pelo menos, mantenha o título e a prova juntos em cerca de 45 palavras, o que cabe acima da primeira imagem em um celular.

Percorra a lista que o script imprimiu. Corrija o que puder pelo conteúdo (uma linha de função ausente, uma imagem pesada, um título longo). Passe o restante para a pessoa como uma lista curta do que só ela pode fornecer.

6. Entrega

Diga a ela: qual grid e se ela escolheu ou você (e que os outros dois estão a uma palavra de distância, ou em compare/ se você construiu), o que você escreveu para o título, o que foi omitido, qualquer coisa que foi inferida, os slots ainda a preencher, o que a lista de auditoria ainda mostra e como fazer alterações (editar portfolio.json, executar a build novamente). A pasta é um site estático completo: pode ser publicado em qualquer host estático enviando-o como está.

Duas coisas que só ela pode fornecer, então peça-as aqui: o endereço onde o site ficará (site.url) e uma imagem de 1200×630 para prévias de links (site.share_image); um recorte da melhor imagem do primeiro projeto funciona.

Imagens

  • Exporte no máximo 2000 px de largura, como AVIF ou WebP, com cerca de 500 KB cada. A build avisa sobre imagens mais pesadas. JPEG, PNG e SVG também funcionam.
  • Uma cópia menor para celulares é usada automaticamente quando os arquivos são nomeados como um par: shot-lg.jpg no arquivo de conteúdo e shot-sm.jpg ao lado. Um .avif com os mesmos nomes é oferecido primeiro para navegadores que o leem.
  • Dê a cada imagem um alt que diga o que mostra. Sem ele, o título do projeto é usado, o que diz a um mecanismo de busca ou assistente de IA muito pouco. Se você não viu as imagens, diga qual peça cada uma é e peça à pessoa que as descreva.
  • Vídeos curtos em loop (.mp4, .webm) funcionam como blocos. Eles são reproduzidos sem som, apenas enquanto estão na tela. Dê a eles um ratio.

O que não fazer

  • Não adicione animação de introdução, carregador, cursor personalizado ou efeitos de rolagem que atrasem o conteúdo. O template mostra a primeira tela imediatamente de propósito.
  • Não oculte títulos de projeto atrás de hover. Celulares não têm hover.
  • Não remova a barra de ancoragem, a pequena barra com o nome e o e-mail que aparece quando o bloco de contato foi rolado para fora. Um revisor decide escrever no meio de um projeto, não no final da página.
  • Não preencha trabalho ralo com imagens de processo (post-its, personas). Uma decisão, dita claramente, vale mais.
  • Não edite o HTML gerado manualmente: a próxima build o sobrescreve. Altere o arquivo de conteúdo, ou o template em assets/template/ se a própria estrutura precisar mudar.

Individual skills in this repo

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

Habilidades Relacionadas