SKILL.md — Construtor de Portfólio
Construa um portfólio pessoal que faça as pessoas lembrarem de você. Com suporte a 67+ estilos de UI, 161 paletas de cores, 57 pares de fontes e padrões específicos para portfólios. Pipeline: entender → identidade da marca → conteúdo → construir → implantar.
Visão Geral
Um portfólio tem um único objetivo: fazer alguém querer trabalhar com você. Tudo — design, texto, seleção de projetos, interações — serve a esse objetivo.
Pipeline (5 Fases):
Fase 0 — Entender → Quem é você? O que você faz? Quem está vendo isso?
Fase 1 — Design → Identidade visual: estilo, paleta, fontes — a "sensação" do seu trabalho
Fase 2 — Conteúdo → Biografia, descrições de projetos, habilidades, contato
Fase 3 — Construir → HTML/CSS + grade interativa de projetos + animações
Fase 4 — Entregar → Preview ao vivo → Deploy na Vercel
Tipos de Portfólio
| Tipo | Público-alvo | Foco |
|---|---|---|
| Designer | Clientes, gerentes de contratação | Trabalho visual, estudos de caso, processo |
| Desenvolvedor | Recrutadores, clientes, colaboradores | Projetos, stack tecnológico, GitHub |
| Criativo (fotógrafo/ilustrador/etc.) | Clientes, galerias | Imagens em tela cheia, texto mínimo |
| Freelancer | Clientes em potencial | Serviços, trabalhos anteriores, contato/CTA |
| Estudante / Em transição de carreira | Recrutadores, gerentes de contratação | Projetos, habilidades, narrativa de crescimento |
Stack Tecnológico
Padrão: HTML + CSS + Vanilla JS — igual à Landing Page. Sem necessidade de framework.
- Mais rápido de construir e implantar
- Zero dependências, máximo controle sobre animações
- Vercel implanta como arquivos estáticos instantaneamente
Estrutura de Arquivos
portfolio/
├── index.html # Página principal (página única ou navegação por âncoras)
├── styles.css # Design tokens → reset → layout → componentes → seções → animações
├── main.js # Filtro, lightbox, efeitos de scroll, navegação mobile
├── assets/
│ ├── images/ # Screenshots dos projetos, avatar, imagem OG
│ └── fonts/ # Fontes auto-hospedadas (opcional)
└── README.md
Fase 0 — Entender
0.1 Perguntas Chave
| Pergunta | Por que é Importante |
|---|---|
| O que você faz? | Designer / desenvolvedor / fotógrafo / freelancer / estudante / híbrido |
| Quem visitará isso? | Recrutadores, clientes, colaboradores, curadores de galeria |
| Qual é o objetivo #1? | Ser contratado / conseguir clientes freelancers / entrar em um programa / apenas ter presença |
| Quantos projetos mostrar? | 3–6 é o ideal; qualidade sobre quantidade |
| Você já tem uma marca? | Cores, fontes, logo existentes — ou começando do zero |
| Tom? | Mínimo, ousado, escuro, lúdico, editorial, técnico, luxuoso |
| Algum portfólio de referência? | Sites que você ama ou dos quais quer se diferenciar |
0.2 Mapeamento de Arquétipos de Portfólio
| Arquétipo | Seções Principais | Prioridade Visual |
|---|---|---|
| Designer | Hero + Trabalhos Selecionados (estudos de caso) + Sobre + Habilidades + Contato | Detalhe de estudo de caso, fotos do processo |
| Desenvolvedor | Hero + Projetos (links ao vivo + GitHub) + Habilidades/Stack + Sobre + Contato | Trechos de código, demos ao vivo, estatísticas do GitHub |
| Criativo | Hero em tela cheia + Galeria/Grade + Sobre + Contato | Imagens dominam, UI mínima |
| Freelancer | Hero + Serviços + Trabalhos + Depoimentos + Contato | Proeminência do CTA, sinais de confiança |
| Estudante | Hero + Projetos + Habilidades + Sobre + Contato | Narrativa de crescimento — progresso e potencial |
Fase 1 — Pesquisa de Design
1.1 O Banco de Dados de Design
# Busca de estilo
python3 src/ui-ux-pro-max/scripts/search.py "<consulta>" --domain style --max-results 5
# Paleta de cores
python3 src/ui-ux-pro-max/scripts/search.py "<humor/indústria>" --domain color --max-results 5
# Tipografia
python3 src/ui-ux-pro-max/scripts/search.py "<estilo/humor>" --domain typography --max-results 3
# Padrões específicos para portfólio
python3 src/ui-ux-pro-max/scripts/search.py "portfolio" --domain landing --max-results 5
# Regras de tipo de produto para sites pessoais
python3 src/ui-ux-pro-max/scripts/search.py "portfolio personal site" --domain product
# Sistema de design completo
python3 src/ui-ux-pro-max/scripts/search.py "<consulta>" --design-system -p "Portfolio"
# Snippets específicos de stack
python3 src/ui-ux-pro-max/scripts/search.py "<consulta>" --stack html
1.2 Princípios Estéticos Específicos para Portfólio
Um portfólio É o trabalho de design. Se parecer genérico, o visitante assume que o trabalho é genérico.
| ❌ Genérico (evitar) | ✅ Marcante (buscar) |
|---|---|
| Fundo branco, fonte Inter, texto cinza | Uma paleta que expressa personalidade |
| "Olá, sou [Nome]. Sou designer." hero | Uma frase de abertura que cria intriga |
| Grade de cards de 3 colunas com padding idêntico | Um layout que reflete o caráter do trabalho |
| Hover: opacidade 0.8 | Hover: revela informações do projeto com personalidade |
| Rodapé: "© 2024 Nome. Todos os direitos reservados." | Rodapé que é uma extensão da marca |
1.3 Estratégia de Cores para Portfólios
Diferente de landing pages (acento = CTA), as cores do portfólio expressam personalidade:
| Persona | Direção da Paleta |
|---|---|
| Designer minimalista | Quase branco + 1 acento forte, bastante espaço em branco |
| Criativo ousado | Fundo escuro + acento vívido, alto contraste |
| Desenvolvedor técnico | Estética escura/de terminal OU limpa e clara com acentos inspirados em código |
| Freelancer acolhedor | Tons terrosos, acessíveis, com sensação humana |
| Luxo/premium | Neutros profundos + dourado/champanhe, tipografia refinada |
1.4 Brief de Design para Portfólios
## Portfolio Design Brief: <Nome>
### Identidade
- **Quem:** <nome + função>
- **Arquétipo:** <designer / desenvolvedor / criativo / freelancer / estudante>
- **Objetivo do portfólio:** <ser contratado / conseguir clientes / apenas ter presença>
- **Público-alvo:** <recrutadores / clientes / colaboradores>
### Personalidade (escolha 3 adjetivos)
- <ex.: preciso, acolhedor, ousado>
### Direção de Estilo
- **Estilo principal:** <da busca — ex.: "Dark Editorial", "Soft Minimalism">
- **Estética em uma palavra:** <ex.: "focado", "expressivo", "técnico">
- **Por que este estilo se encaixa no trabalho:** <uma frase>
### Paleta de Cores
- **Fundo:** <hex> — <nome>
- **Fundo secundário:** <hex> — para cards/painéis
- **Texto principal:** <hex>
- **Texto suave:** <hex>
- **Acento:** <hex> — usado com moderação, máximo impacto
- **Borda/divisória:** <hex>
### Tipografia
- **Fonte de título:** <nome> + peso + URL do Google Fonts
- **Fonte de corpo:** <nome> + URL do Google Fonts
- **Nota de estilo do título:** <ex.: "tracking apertado, grande contraste de escala">
### Padrão de Layout
- **Grade:** <ex.: 2-col assimétrica, masonry, linha em tela cheia>
- **Estilo do card de projeto:** <ex.: imagem primeiro com hover overlay, card de texto mínimo>
- **Transições entre seções:** <ex.: divisórias de largura total, entrada escalonada, nenhuma>
### Interações
- **Hover no card do projeto:** <ex.: escala + overlay com título/tags>
- **Animações de scroll:** <ex.: fade-up escalonado na grade de trabalho>
- **Cursor:** <padrão / ponto personalizado / nenhum>
1.5 Critérios de Qualidade
- Arquétipo identificado, objetivo principal claro
- 3+ opções de estilo pesquisadas antes de decidir
- Paleta expressa personalidade (não apenas padrões "limpos")
- Par de fontes tem contraste — uma display, uma de corpo
- Padrão de layout corresponde ao tipo de trabalho (fotografia ≠ projetos de código)
- Usuário aprovou o Design Brief
Fase 2 — Conteúdo
2.1 Texto do Hero
A frase de abertura do hero é o texto mais importante da página. Ela deve responder: quem é você, o que você faz e por que isso importa — com personalidade.
Opções de fórmula:
| Fórmula | Exemplo |
|---|---|
| Função + diferencial | "Product designer que obseda pelos momentos de 0,1 segundo" |
| Foco no resultado | "Eu faço software complexo parecer simples" |
| Declaração ousada | "Bom design é invisível. Grande design é inevitável." |
| Direto/divertido | "Eu construo coisas para a web. Atualmente disponível para trabalho." |
| Nome + descritor | "Oi, sou a Maya — projeto para humanos, não para telas" |
Evite:
- "Sou um designer apaixonado com 5 anos de experiência"
- "Bem-vindo ao meu portfólio"
- Adjetivos genéricos: criativo, inovador, dedicado, apaixonado
2.2 Descrições de Projetos
Cada entrada de projeto precisa de:
### <Nome do Projeto>
**Função:** <sua função — ex.: "Lead Designer", "Desenvolvedor Solo">
**Tipo:** <ex.: "App Mobile", "Identidade de Marca", "Web App">
**Tags:** [<tags de tecnologia/habilidade>]
**O desafio:** <1-2 frases — que problema precisava ser resolvido>
**O que fiz:** <2-3 frases — sua contribuição e decisões específicas>
**O resultado:** <1 frase com um resultado, se possível — "Reduziu o tempo de onboarding em 40%">
[Ao Vivo →](<url>) [Estudo de Caso →](<url>) [GitHub →](<url>)
Regras:
- Comece com o PROBLEMA, não com a tecnologia
- Sua FUNÇÃO deve ser específica — "designer" não é uma função, "projetou o fluxo de onboarding" é
- Se tiver métricas, use-as. Se não, descreva o resultado qualitativo
- Máximo de 3–6 projetos — curatorialmente impiedoso
2.3 Seção Sobre
Estrutura:
- Quem você é — estado atual (função, localização, no que está focado)
- Como você chegou aqui — breve trajetória (não um currículo, uma história)
- O que você valoriza — o "porquê" por trás do trabalho
- O que você está procurando — disponível para trabalho / tipos específicos de projetos / colaborações
Comprimento: 80–150 palavras. Não é uma biografia, não é um CV. É uma pessoa.
2.4 Seção de Habilidades / Stack
Para designers:
Design: Figma, Prototipagem, Design Systems, Tipografia, Motion
Pesquisa: Entrevistas com Usuários, Testes de Usabilidade, Análise Competitiva
Para desenvolvedores:
Frontend: React, TypeScript, Next.js, CSS/Tailwind
Backend: Node.js, PostgreSQL, REST/GraphQL
Ferramentas: Git, Docker, Vercel, Figma
Exiba como nuvens de tags, grades de ícones ou listas agrupadas — nunca apenas uma lista simples com marcadores.
2.5 Seção de Contato
Mantenha extremamente simples:
- Email (a coisa mais importante — torne-o clicável com
mailto:) - 2–3 links sociais (GitHub, LinkedIn, Twitter/X, Dribbble — escolha o relevante)
- Opcional: uma linha curta "atualmente disponível para..."
- Opcional: um formulário de contato simples (Formspree)
Sem formulários de contato com 6 campos. Sem o clichê "vamos tomar um café".
2.6 Critérios de Qualidade
- Frase de abertura do hero tem personalidade (não genérica)
- Cada projeto começa com o problema, não com a tecnologia
- Funções são específicas, não apenas títulos de cargo
- Seção Sobre parece que foi escrita por uma pessoa
- 3–6 projetos, curados pela qualidade
- Seção de contato tem um link mailto como ação principal
Fase 3 — Construir
3.1 Estrutura HTML
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title><Nome> — <Função></title>
<meta name="description" content="<descrição pessoal de 150 caracteres>">
<!-- Google Fonts -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=<FonteTitulo>:wght@400;600;700&family=<FonteCorpo>:wght@400;500&display=swap" rel="stylesheet">
<!-- OG Tags -->
<meta property="og:title" content="<Nome> — <Função>">
<meta property="og:description" content="<descrição>">
<meta property="og:image" content="<og-image.jpg>">
<meta name="twitter:card" content="summary_large_image">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<nav class="nav" id="nav">...</nav>
<main>
<section class="hero" id="home">...</section>
<section class="work" id="work">...</section>
<section class="about" id="about">...</section>
<section class="skills" id="skills">...</section> <!-- opcional -->
<section class="contact" id="contact">...</section>
</main>
<footer class="footer">...</footer>
<div class="project-modal" id="modal" aria-hidden="true">...</div> <!-- opcional lightbox -->
<script src="main.js"></script>
</body>
</html>
3.2 Arquitetura CSS
/* ── 1. Google Fonts ── */
/* ── 2. CSS Variables ── */
:root {
/* Cores do Design Brief */
--color-bg: <hex>;
--color-bg-secondary: <hex>;
--color-text: <hex>;
--color-text-muted: <hex>;
--color-accent: <hex>;
--color-border: <hex>;
/* Tipografia */
--font-heading: '<FonteTitulo>', serif;
--font-body: '<FonteCorpo>', sans-serif;
/* Escala tipográfica */
--text-hero: clamp(3rem, 8vw, 7rem);
--text-h2: clamp(1.75rem, 4vw, 2.75rem);
--text-h3: clamp(1.125rem, 2vw, 1.5rem);
--text-body: 1.0625rem;
--text-sm: 0.875rem;
/* Espaçamento */
--section-padding: clamp(5rem, 12vw, 10rem);
--container-width: 1200px;
--gap: 1.5rem;
--radius: 8px;
--radius-lg: 16px;
/* Transições */
--transition: 0.3s ease;
--transition-slow: 0.6s ease;
}
/* ── 3. Reset + Base ── */
/* ── 4. Layout (.container, .section, .grid-2, .grid-3) ── */
/* ── 5. Nav (fixa, mudança de bg ao scroll) ── */
/* ── 6. Hero ── */
/* ── 7. Trabalhos / Grade de Projetos ── */
/* ── 8. Card de Projeto + Hover ── */
/* ── 9. Sobre ── */
/* ── 10. Habilidades ── */
/* ── 11. Contato ── */
/* ── 12. Footer ── */
/* ── 13. Modal / Lightbox (se usado) ── */
/* ── 14. Animações de scroll ── */
/* ── 15. Responsivo ── */
3.3 Grade de Projetos
<!-- Seção de trabalho com filtro opcional -->
<section class="work" id="work">
<div class="container">
<div class="work__header">
<h2 class="work__title">Trabalhos Selecionados</h2>
<!-- Abas de filtro opcionais -->
<div class="work__filters" role="tablist">
<button class="filter-btn active" data-filter="all">Todos</button>
<button class="filter-btn" data-filter="design">Design</button>
<button class="filter-btn" data-filter="dev">Desenvolvimento</button>
</div>
</div>
<div class="work__grid" id="work-grid">
<!-- Card de Projeto -->
<article class="project-card" data-category="design" data-index="0">
<div class="project-card__image">
<img src="assets/images/project-1.jpg" alt="<Nome do Projeto> — <descrição breve>" loading="lazy">
<div class="project-card__overlay">
<span class="project-card__type"><Tipo></span>
<h3 class="project-card__title"><Nome do Projeto></h3>
<div class="project-card__tags">
<span class="tag"><Tag 1></span>
<span class="tag"><Tag 2></span>
</div>
</div>
</div>
<div class="project-card__info">
<p class="project-card__description"><Descrição curta></p>
<div class="project-card__links">
<a href="<url>" class="project-link" target="_blank">Ao Vivo →</a>
<a href="<url>" class="project-link" target="_blank">GitHub →</a>
</div>
</div>
</article>
<!-- Repita para outros projetos -->
</div>
</div>
</section>
3.4 Efeitos de Hover nos Cards
.project-card__overlay {
position: absolute;
inset: 0;
background: rgba(0, 0, 0, 0.7);
display: flex;
flex-direction: column;
justify-content: flex-end;
padding: 1.5rem;
opacity: 0;
transition: opacity var(--transition);
}
.project-card:hover .project-card__overlay {
opacity: 1;
}
.project-card:hover .project-card__image img {
transform: scale(1.05);
}
.project-card__image img {
transition: transform var(--transition-slow);
}
3.5 Funcionalidade de Filtro
// Filtragem da grade de projetos
document.querySelectorAll('.filter-btn').forEach(button => {
button.addEventListener('click', () => {
const filter = button.dataset.filter;
document.querySelectorAll('.filter-btn').forEach(btn => btn.classList.remove('active'));
button.classList.add('active');
document.querySelectorAll('.project-card').forEach(card => {
if (filter === 'all' || card.dataset.category === filter) {
card.style.display = 'block';
} else {
card.style.display = 'none';
}
});
});
});
3.6 Lightbox (Opcional)
<div class="lightbox" id="lightbox">
<span class="lightbox__close">×</span>
<img class="lightbox__image" id="lightbox-img" src="" alt="">
<a class="lightbox__prev">❮</a>
<a class="lightbox__next">❯</a>
</div>
.lightbox {
display: none;
position: fixed;
z-index: 1000;
left: 0;
top: 0;
width: 100%;
height: 100%;
background: rgba(0, 0, 0, 0.9);
align-items: center;
justify-content: center;
}
.lightbox.active {
display: flex;
}
.lightbox__image {
max-width: 90%;
max-height: 90vh;
}
// Lógica do lightbox
const lightbox = document.getElementById('lightbox');
const lightboxImg = document.getElementById('lightbox-img');
document.querySelectorAll('.project-card__image img').forEach(img => {
img.addEventListener('click', () => {
lightboxImg.src = img.src;
lightbox.classList.add('active');
});
});
document.querySelector('.lightbox__close').addEventListener('click', () => {
lightbox.classList.remove('active');
});
lightbox.addEventListener('click', (e) => {
if (e.target === lightbox) {
lightbox.classList.remove('active');
}
});
3.7 Animações de Scroll
.scroll-animate {
opacity: 0;
transform: translateY(30px);
transition: opacity 0.6s ease, transform 0.6s ease;
}
.scroll-animate.visible {
opacity: 1;
transform: translateY(0);
}
// Intersection Observer para animações de scroll
const observer = new IntersectionObserver((entries) => {
entries.forEach(entry => {
if (entry.isIntersecting) {
entry.target.classList.add('visible');
}
});
}, { threshold: 0.1 });
document.querySelectorAll('.scroll-animate').forEach(el => observer.observe(el));
Fase 4 — Implantar
4.1 Construção Local
# Teste local
open index.html
# Ou sirva com um servidor local
python3 -m http.server 8000
# Acesse: http://localhost:8000
4.2 Deploy na Vercel
# Crie um repositório no GitHub
# Faça upload dos arquivos
# Conecte o repositório à Vercel
# Ou use a Vercel CLI:
npm install -g vercel
vercel
# Siga as instruções
# Para produção:
vercel --prod
4.3 Domínio Personalizado
- Compre um domínio (Namecheap, Cloudflare, Porkbun, etc.)
- Adicione no painel da Vercel: Project → Settings → Domains
- Configure os registros DNS (apontar CNAME para
cname.vercel-dns.comou usar nameservers da Vercel)
4.4 Otimizações de Performance
- Use
loading="lazy"em todas as imagens da grade de projetos - Redimensione imagens para no máximo 1920px de largura (WebP ou JPEG com qualidade 80%)
- Inline do CSS crítico ou adie CSS não crítico
- Minimize HTML, CSS e JS (use parcel, vite ou ferramentas online)
Recursos
Guias de Design
Bancos de Dados
Implantação
Checklist de Qualidade
- Conexão clara entre cor, fonte e personalidade da marca
- Hero com personalidade, não genérico
- 3–6 projetos, curados pela qualidade
- Cada projeto mostra problema → ação → resultado
- Grade de projetos totalmente responsiva
- Hover nos cards de projeto funciona em desktop
- Filtros funcionam (se implementados)
- Lightbox funcional (se implementado)
- Link mailto para contato
- Deploy na Vercel bem-sucedido
- Meta tags OG para compartilhamento social
- Imagens carregam com lazy loading
