Communitygithub.com

auditoria-de-portfolio

Audita um portfólio de design como um gerente de contratação ou cliente leria, em uma primeira passagem de cerca de 30 segundos, e retorna o que entenderiam, o que perderiam e os reparos mais importantes, com cópia reescrita.

O que é auditoria-de-portfolio?

Esta skill realiza uma auditoria de portfólio de design simulando a leitura rápida que um recrutador ou cliente faz em cerca de 30 segundos, o chamado 'teste dos 30 segundos'. Ela é útil para designers, diretores de arte, líderes de design, ilustradores, artistas 3D e motion, fotógrafos e engenheiros de design que desejam saber por que não estão conseguindo entrevistas ou clientes. A skill funciona analisando a primeira tela do portfólio, a página inicial e um projeto principal, verificando se a comunicação é clara e eficaz para o público-alvo específico. Ela gera um relatório detalhado que inclui o que um estranho entende em 30 segundos, os três reparos mais importantes (com sugestões concretas), o que já funciona, o que não foi verificado e uma tabela completa de regras. A skill é compatível com vários formatos, incluindo sites completos, páginas do Behance, Dribbble, Read.cv, PDFs e decks. A abordagem é focada em dados reais, extraídos de HTML e capturas de tela, e prioriza a clareza da comunicação em vez do gosto pessoal.

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

Perguntar na sua IA favorita

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

Documentação

Auditoria de portfólio: o teste dos 30 segundos

A primeira passada sobre um portfólio é curta. Um revisor com quarenta abas abertas decide em menos de um minuto se este merece uma olhada real. Apenas as pessoas que passam por esse filtro ganham os cinco ou dez minutos cuidadosos que vêm depois. Portanto, a auditoria faz uma pergunta antes de qualquer outra: o que um estranho entende em 30 segundos, e isso é suficiente para fazê-lo continuar lendo?

Você não está julgando gosto. Muitos portfólios bonitos falham neste teste e muitos portfólios simples passam. Você está julgando se a página comunica: quem é, o que faz, em que nível, para quem, e como entrar em contato.

O que você precisa antes de começar

  • O portfólio. Uma URL ou arquivos locais.

  • O alvo. O cargo ou cliente para o qual o portfólio é direcionado ("designer de produto sênior em uma fintech", "trabalho freelance de marca para restaurantes"). Cada regra é julgada contra ele, porque um portfólio só é bom para algo. Se a pessoa não disse, deduza o alvo mais provável a partir da primeira frase da página, declare sua suposição no relatório e prossiga. Não pare para perguntar.

    Um alvo é dado apenas quando a pessoa o nomeou com suas próprias palavras nesta conversa. "Audite meu portfólio" com um link não dá nenhum alvo. Qualquer coisa que você deduziu da página, de um exemplo nesta skill ou de quem a pessoa parece ser é assumido, e o relatório diz isso e diz a partir de quê. Toda a conclusão depende do alvo, então um alvo errado apresentado como dela faz a auditoria parecer errada desde a primeira linha.

Como executar

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

1. Colete os fatos primeiro

Execute o script incluído na página inicial, na primeira página de projeto, se houver, e na página "sobre", se houver. Ele relata o que realmente está nas páginas para que você não precise adivinhar:

python3 scripts/snapshot.py https://exemplo.com https://exemplo.com/primeiro-projeto https://exemplo.com/sobre
python3 scripts/snapshot.py --text https://exemplo.com/primeiro-projeto     # o texto legível de uma página

O snapshot fornece o título, a descrição, o cartão de compartilhamento (com seu tamanho real), os cabeçalhos, as primeiras palavras que um visitante lê, as imagens, os links de contato, os dados estruturados, o peso dos scripts e se robots.txt, sitemap.xml e llms.txt existem. Ele também sinaliza contradições que pode ver, como um número diferente de anos na descrição e na página.

Leia suas notas com atenção:

  • Casca vazia (nenhum texto no HTML): a página é renderizada por JavaScript. Essa é uma descoberta real para a regra 15. Todo o resto sobre o conteúdo é desconhecido, não ausente, até que você veja a página em um navegador ou em capturas de tela. Sem um ou outro, marque as regras que dependem de conteúdo como não verificadas em vez de vasculhar pacotes de script.
  • Muito pouco texto: a página está no HTML, mas é esparsa (uma tela, uma única declaração). As contagens de imagens significam pouco aqui; olhe para a página.

Leia a página "sobre". Fatos que passariam pela primeira tela (anos, empregadores, tamanho da equipe, uma declaração de autoria) geralmente estão escritos lá e em nenhum lugar que um visitante de 30 segundos olhe. Essa lacuna é uma das coisas mais úteis que uma auditoria pode encontrar.

2. Olhe para a primeira tela

Se você tem um navegador ou ferramenta de captura de tela, capture a primeira tela no tamanho de desktop (cerca de 1440×900) e no tamanho de celular (cerca de 390×844) sem rolar, depois que a página terminar de carregar. Esta é a evidência mais importante. Se a pessoa lhe deu capturas de tela, use-as da mesma forma.

Se uma captura de tela e o HTML discordam (o HTML tem um título, a captura mostra uma tela vazia), suspeite da captura: animações de entrada e carregamento lento geralmente deixam a primeira captura em branco. Capture novamente se puder. Se não puder, relate ambos e diga em qual você confia, e não falhe em uma regra com base em uma captura da qual você duvida.

Se você não tem como ver a página, diga isso no topo do relatório: a auditoria é baseada em texto e código, e o layout, a hierarquia e a qualidade da imagem não foram vistos.

3. Percorra como um revisor

Siga o caminho que um revisor segue e anote o que você aprende em cada etapa, não o que você poderia encontrar cavando:

SegundosO que o revisor fazO que eles devem levar consigo
0–5Lê a primeira telaQuem é, o que faz, em que nível
5–15Rola e examinaTrabalho real, o melhor primeiro, e que tipo de trabalho é
15–30Abre ou para em um projetoQual foi a parte dessa pessoa e uma coisa que ela decidiu
SaídaSai ou ageUma maneira óbvia de entrar em contato e um motivo para fazê-lo

Para a terceira etapa, use o primeiro projeto que a página oferece:

  • Uma página de projeto: abra-a e julgue sua primeira tela.
  • Um site de página única (seções, uma grade, uma lightbox): a primeira seção ou bloco é o projeto. Julgue o que diz onde está. Não ter páginas de projeto não é uma falha em si; não ter nenhum lugar que diga função, decisão ou resultado é.
  • Um site em tela, horizontal ou de tela única: "um rolar de distância" torna-se "um gesto óbvio de distância".
  • Um link para um produto ou loja externa: anote para onde vai, depois use o primeiro projeto no próprio site.

4. Verifique as regras

Leia references/rules.md e marque cada regra:

  • Passa: um revisor entende para que serve a regra. Se você está hesitando entre Passa e Fraco e a página comunica, é um Passa. Uma página que quebra a letra de uma regra e ainda assim comunica passa.
  • Fraco: um revisor notaria a lacuna, e isso custa algo.
  • Falha: a coisa está ausente ou age ativamente contra a pessoa.
  • Não verificado: você não conseguiu ver o que a regra precisa. Nunca marque por suposição.

Quando você viu apenas parte do que uma regra precisa (a primeira tela do celular, mas não o resto), marque com base no que viu, adicione "(parcialmente)" ao resultado e liste a parte não vista em "Não verificado". Quando desktop e celular diferem, a regra assume o pior dos dois.

5. Escreva o relatório

Use o formato abaixo. Escreva no idioma em que a pessoa escreveu para você. Cite a página em seu próprio idioma e escreva a cópia reescrita também no idioma da página, pois ela se destina a ser colada.

Formato do relatório

# Auditoria de 30 segundos: [nome ou site]

**Alvo:** [o cargo ou cliente. Em seguida, "(dado)" apenas se eles próprios o nomearam; caso contrário, "(assumido a partir de [o que na página])", mais uma frase sobre o que mudaria com o outro alvo provável]
**Veredito:** [uma ou duas frases. Se eles fizeram uma pergunta sim/não, responda-a primeiro. Em seguida: isso passaria no primeiro filtro para esse alvo, e por quê]
**Pontuação:** [N] de 17 regras passam · [N] fracas · [N] falham · [N] não verificadas ([N] parcialmente)
**Baseado em:** [o que você viu: página ao vivo no navegador, capturas de tela, apenas HTML]

## O que um estranho entende em 30 segundos
| Pergunta | O que a página diz |
|---|---|
| Quem é? | ... |
| O que faz? | ... |
| Em que nível? | ... |
| Para quem? | ... |
| Qual foi sua parte no trabalho? | ... |
| Como entro em contato? | ... |

(Escreva o que é realmente comunicado nesse tempo. Se não estiver lá, escreva "Não está claro" e onde você acabou encontrando, se encontrou.)

## Os três reparos que mais importam
1. **[Reparo]** · [por que custa a eles, em uma frase] · [a mudança concreta, com cópia reescrita onde se aplica]
2. ...
3. ...

## O que já funciona
[Duas ou três coisas que valem a pena manter, para que não se percam na próxima reformulação.]

## Não verificado
[O que você não conseguiu ver e como a pessoa pode verificar por conta própria.]

## Todas as regras
| # | Regra | Resultado | Evidência |
|---|---|---|---|

O relatório é lido em uma janela de chat, de cima para baixo, e a maioria das pessoas para após os três reparos. Portanto, tudo o que elas precisam para agir está acima desse ponto, e a tabela de todas as regras vai por último como o registro por trás do veredito. Mantenha cada linha de evidência em uma frase curta, cerca de uma dúzia de palavras: o que você viu, não o argumento. Se uma regra precisa de explicação, provavelmente é um dos três reparos e já está explicada lá.

A pontuação conta regras; o veredito prevê o que um revisor faz. Eles podem diferir: um nome conhecido ou um empregador famoso pode levar uma página além do filtro com metade das regras fracas, e uma página arrumada pode passar na maioria das regras e ainda assim não ter objetivo. Quando diferirem, diga por que no veredito.

Como julgar bem

Ordene os reparos pelo que um revisor perde, não pelo quão fáceis são. Um título vago na primeira tela supera dez detalhes técnicos mais abaixo. Os três reparos devem ser os três que mais mudam os primeiros 30 segundos.

Seja específico o suficiente para agir. "Melhore seu título" não ajuda ninguém. Cite o atual e escreva um melhor. O mesmo vale para introduções de projeto e a linha de contato.

Reescreva apenas com fatos encontrados no site. Qualquer página do site conta, e diga onde encontrou o fato. Quando uma linha melhor precisar de algo que você não sabe (anos, um cliente, tamanho da equipe, um número), deixe um espaço entre colchetes, como [N] anos ou [cliente], e diga o que preencher. Inventar uma credencial para alguém é o único erro aqui que pode realmente prejudicá-lo.

Separe o que você viu do que você infere. "O layout para celular empilha em uma coluna" é uma observação. "Provavelmente lento em dados móveis" é uma inferência e deve ser redigida como tal ou omitida.

Sinalize contradições. Seis anos em um lugar e dez em outro, dois títulos diferentes, um ano desatualizado. Um revisor que percebe uma para de confiar no resto. Elas pertencem à regra 3.

Diga quando o problema é o trabalho, não a página. Às vezes, a resposta honesta para "isso é bom o suficiente para X" é que o portfólio não mostra nenhum trabalho do tipo X. Nenhum título resolve isso. Diga claramente no primeiro reparo, depois diga que trabalho fecharia a lacuna e deixe os reparos de apresentação para depois.

Pese as regras de acordo com o que o alvo é contratado para fazer.

  • Designers de produto e UX são contratados pelo raciocínio: função, decisões e resultados têm o maior peso.
  • Líderes de design, heads de design, gerentes são contratados pelo escopo: tamanho da equipe, quem contrataram e desenvolveram, o que foi lançado sob eles, por quanto tempo. Trabalho solo bonito sob um título de liderança parece uma incompatibilidade, então as regras 3, 4 e 11 têm o maior peso, e o primeiro projeto deve ser um que eles lideraram.
  • Ilustradores, fotógrafos, artistas 3D e motion, diretores de arte são contratados pelo trabalho em si: qualidade da imagem, edição e ordem são o que importa. Uma legenda é suficiente; não peça um estudo de caso escrito.
  • Engenheiros de design e desenvolvedores criativos: o próprio site é uma peça de trabalho. Credite sua interação e qualidade de construção como evidência e espere que a primeira frase diga que eles constroem, não apenas projetam.

Seja direto e gentil. A pessoa pediu porque algo não está funcionando. Diga o que está errado claramente, depois diga o que fazer. "Destrua" e "seja brutal" significam ser franco e pular os rodeios; eles não mudam o formato e não são uma licença para zombar. O objetivo é que eles consertem isso esta semana.

Lembre-se do que um pedido público revela. Se a pessoa tem um emprego e o alvo é outro emprego, não escreva uma linha de encerramento que anuncie que ela está procurando. Ofereça uma neutra ("Montando uma equipe de design? Vamos conversar.").

Não redesenhe. Tipo de fonte, cor e estilo de layout são deles. Comente sobre eles apenas quando impedirem a página de comunicar: texto que não pode ser lido, trabalho que não pode ser visto, navegação que não pode ser encontrada.

Quando a entrada é incomum

  • Um único estudo de caso ou um PDF: execute as etapas 3 a 5 nele e pule as regras que se aplicam apenas a um site inteiro. Conte-as como não verificadas.
  • Uma página do Behance, Dribbble, Read.cv ou Notion: audite da mesma forma e mencione o que a própria plataforma impede (cartão de compartilhamento, domínio próprio, dados estruturados) separadamente do que a pessoa pode mudar.
  • Uma página que vende várias coisas (um emprego, trabalho freelance, um curso, um produto): considere a oferta na primeira frase como o alvo e conte o resto contra a regra 11.
  • Trabalho protegido por senha: não tente contorná-lo. Observe que um primeiro projeto bloqueado encerra a maioria das visitas de 30 segundos e audite o que é público.
  • Portfólio de outra pessoa: audite se solicitado, como feedback privado. Ainda é o trabalho de uma pessoa.

Individual skills in this repo

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

Habilidades Relacionadas