Communitygithub.com

Construtor de Portfólio

Crie um site de portfólio pessoal impressionante com uma identidade visual marcante. Integra o banco de dados de design ui-ux-design-pro (67+ estilos, 161 paletas, 57 pares de fontes) para uma estética ousada e memorável. Abrange branding pessoal, layout de portfólio, HTML/CSS responsivo, efeitos interativos (hover/filtro/lightbox) e deploy na Vercel.

O que é Construtor de Portfólio?

Esta skill é um guia completo e sistemático para construir um site de portfólio pessoal que se destaque, indo além do básico. Ela estrutura o processo em cinco fases: entender o usuário, definir a identidade visual (usando o banco de dados de design UI-UX-Pro), planejar o conteúdo, construir com HTML/CSS/JS e fazer o deploy (Vercel). Diferente de tutoriais genéricos, a skill enfatiza a curadoria estratégica, a cópia de impacto e a consistência visual, ajudando designers, desenvolvedores e freelancers a criar uma presença online que comunica profissionalismo e personalidade. A integração com a base de design acelera a tomada de decisões estéticas, e o pipeline orientado a fases garante que nenhum detalhe crucial seja negligenciado.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/qike7777/skill-library/tree/HEAD/skills/3-websites-and-apps/portfolio

Perguntar na sua IA favorita

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

Prévia

Do README da skill

Construtor de Portfólio preview

Documentação

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

TipoPúblico-alvoFoco
DesignerClientes, gerentes de contrataçãoTrabalho visual, estudos de caso, processo
DesenvolvedorRecrutadores, clientes, colaboradoresProjetos, stack tecnológico, GitHub
Criativo (fotógrafo/ilustrador/etc.)Clientes, galeriasImagens em tela cheia, texto mínimo
FreelancerClientes em potencialServiços, trabalhos anteriores, contato/CTA
Estudante / Em transição de carreiraRecrutadores, gerentes de contrataçãoProjetos, 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

PerguntaPor 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étipoSeções PrincipaisPrioridade Visual
DesignerHero + Trabalhos Selecionados (estudos de caso) + Sobre + Habilidades + ContatoDetalhe de estudo de caso, fotos do processo
DesenvolvedorHero + Projetos (links ao vivo + GitHub) + Habilidades/Stack + Sobre + ContatoTrechos de código, demos ao vivo, estatísticas do GitHub
CriativoHero em tela cheia + Galeria/Grade + Sobre + ContatoImagens dominam, UI mínima
FreelancerHero + Serviços + Trabalhos + Depoimentos + ContatoProeminência do CTA, sinais de confiança
EstudanteHero + Projetos + Habilidades + Sobre + ContatoNarrativa 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 cinzaUma paleta que expressa personalidade
"Olá, sou [Nome]. Sou designer." heroUma frase de abertura que cria intriga
Grade de cards de 3 colunas com padding idênticoUm layout que reflete o caráter do trabalho
Hover: opacidade 0.8Hover: 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:

PersonaDireção da Paleta
Designer minimalistaQuase branco + 1 acento forte, bastante espaço em branco
Criativo ousadoFundo escuro + acento vívido, alto contraste
Desenvolvedor técnicoEstética escura/de terminal OU limpa e clara com acentos inspirados em código
Freelancer acolhedorTons terrosos, acessíveis, com sensação humana
Luxo/premiumNeutros 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órmulaExemplo
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:

  1. Quem você é — estado atual (função, localização, no que está focado)
  2. Como você chegou aqui — breve trajetória (não um currículo, uma história)
  3. O que você valoriza — o "porquê" por trás do trabalho
  4. 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">&times;</span>
  <img class="lightbox__image" id="lightbox-img" src="" alt="">
  <a class="lightbox__prev">&#10094;</a>
  <a class="lightbox__next">&#10095;</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.com ou 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

Individual skills in this repo

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

Habilidades Relacionadas