Communitygithub.com

portfolio-maker

Constrói um portfólio pessoal de produção para engenheiros, designers, editores, pesquisadores ou consultores, como um aplicativo React ou um único arquivo HTML.

O que é portfolio-maker?

Esta skill capacita o agente a criar portfólios pessoais de altíssima qualidade e prontos para produção, atuando como um sistema de design e engenharia totalmente autônomo. Ela elimina a dependência de habilidades ou recursos externos de design, incorporando inteligência estética nativa, tipografia matemática, harmonia espacial e um arsenal de componentes interativos. A skill suporta cinco arquétipos profissionais principais (engenheiros, criadores, designers, pesquisadores e consultores) e rejeita rigorosamente padrões de design genéricos e 'AI slop', aplicando um 'Código de Honra Anti-Slop' que proíbe gradientes neon roxos, grades de caixa cinzas e textos vagos. O fluxo de trabalho começa com a extração de dados do usuário (currículo ou questionário), seguido por uma etapa obrigatória de alinhamento interativo para escolher o estilo visual, tema e componentes. Em seguida, a skill monta primitivos de design da sua biblioteca de componentes interna, permitindo a geração de código em dois formatos: um projeto completo React + Vite + Tailwind (TypeScript) ou um único arquivo HTML/Tailwind/Lucide/JS independente para implantação imediata. Ao final, a skill audita a saída contra suas regras estéticas e fornece instruções de execução. O agente também pode acessar um vasto catálogo de componentes shadcn via MCP server (gratuito, sem chave de API) e inspirar-se em ecossistemas de design premium como VibeUI e Aceternity UI.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/NaitikGrover/portfolio-maker/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Portfolio Maker: Habilidade de Design e Engenharia Autônoma

Autônoma e Autossuficiente: Esta habilidade opera com total autonomia. Ela não depende, delega ou requer qualquer habilidade externa de design ou animação de terceiros. Toda intuição estética, matemática tipográfica, harmonia espacial, dinâmica de microinteração, aplicação de regras anti-slop e primitivas de componentes são nativamente incorporadas a esta habilidade.


🎯 Propósito e Missão Principal

Eliminar portfólios amadores e genéricos "AI slop" e produzir de forma autônoma portfólios premiados e de nível profissional para qualquer profissional em 5 arquétipos principais:

  1. Engenheiros de Software e Arquitetos de Sistemas (Sistemas distribuídos, APIs de alta vazão, bento técnico limpo)
  2. Editores de Vídeo, Motion Graphics e Criadores (Showreels virais, comparações antes/depois de correção de cor, métricas de visualizações)
  3. Designers de Produto e Líderes de UI/UX (Sistemas de design, estudos de caso, tipografia suíça de alto contraste, detalhamento de tokens)
  4. Pesquisadores de IA/ML e Engenheiros de Dados (Arquiteturas de modelos, publicações no arXiv, telemetria de benchmarks, badges de pesos)
  5. Agências, Consultores e Solopreneurs (Prova social, avaliações de clientes, tiers de serviço, conversão de agendamento sem atrito)

🚫 O Código de Honra Anti-AI-Slop (APLICAÇÃO ESTRITA)

Cada portfólio gerado DEVE passar por este rigoroso filtro estético antes de gerar o código:

1. Slop Visual Banido:

  • ❌ NUNCA use o clichê do gradiente neon roxo/violeta: Sem texto de título from-purple-500 via-indigo-500 to-pink-500. Sem orbes de fundo roxas e borradas (bg-purple-500/10 blur-3xl).
  • ❌ Sem grades de caixas cinzas chatas e planas: Evite blocos padrão do Tailwind bg-gray-100 / border-gray-300 com profundidade ou textura zero.
  • ❌ Sem bordas laser supersaturadas: Evite traços neon synthwave de alta intensidade.

2. Paletas de Cores Aprovadas de Elite:

  • Monocromático Titânio (Suíço Escuro/Claro): Tela obsidiana profunda (#09090b), camada de cartão elevada (#121215 com backdrop-blur-md), bordas finas (border-white/[0.08]), títulos brancos nítidos (#ffffff), texto zinc suave (#a1a1aa), holofotes sutis ardósia/branco (rgba(255,255,255,0.06)).
  • Precisão Esmeralda e Ardósia: Tela obsidiana (#09090b), indicador de status ativo esmeralda (#10b981), cartões monocromáticos com sutis acentos menta ao passar o mouse.
  • Cobalto Elétrico Internacional: Tela carvão escuro (#0a0a0f), tipografia branca nítida, azul royal elétrico de alto contraste (#2563eb) para alvos de interação e botões.
  • Areia Arquitetônica Quente e Expresso: Tela creme quente (#fafaf9), títulos expresso ricos (#18181b), acentos sutis champanhe/âmbar (#d97706).
  • Rosa e Âmbar Cinematográficos: Tela obsidiana #0b0c10, acentos impactantes rosa (#e11d48) e âmbar quente (#f59e0b) para criativos e showreels de vídeo.

3. Enrolação AI Fluff Banida:

  • ❌ Banido: "Desenvolvedor apaixonado transformando ideias em soluções digitais elegantes."
  • ❌ Banido: "Inovando na interseção de design, tecnologia e empatia."
  • ❌ Banido: "Profissional orientado a resultados com talento para resolver problemas."
  • ✅ Obrigatório: Declarações concretas, orientadas por métricas e focadas em impacto:
    • "Construiu microsserviços Go distribuídos lidando com 120k req/s a 14ms de latência p99."
    • "Editou documentários virais long-form no YouTube gerando 75M+ visualizações orgânicas."
    • "Liderou sistema de tokens de design Figma multiplataforma adotado por 42 squads de engenharia."

🧠 O Motor Estético Nativo (Inteligência de Design Integrada)

A IA deve aplicar estas leis matemáticas de design a cada elemento:

1. Hierarquia Tipográfica e Ritmo Ótico

  • Títulos de Destaque (text-4xl a text-6xl md:text-7xl) :
    • A altura da linha deve ser justa (leading-[1.08] a leading-[1.12]). Entrelinhamento solto em fontes grandes parece amador.
    • O espaçamento entre letras deve ser comprimido (tracking-tight ou tracking-tighter).
    • Pesos de fonte: Negrito ou Extranegrito (font-bold / font-extrabold) para técnico; Médio ou Seminegrito (font-medium / font-semibold) para serifa editorial.
  • Corpo de Texto (text-base a text-lg) :
    • A altura da linha deve ser generosa (leading-relaxed ou leading-7) para garantir legibilidade.
    • Comprimento da linha (Medida): Limite a largura do texto do corpo usando max-w-xl ou max-w-2xl (45–75 caracteres por linha). Nunca deixe parágrafos se estenderem por toda a largura da tela.
    • Alinhamento do Texto: Nunca centralize mais de 3 linhas consecutivas de texto do corpo. Alinhe à esquerda para ergonomia de leitura humana.
  • Pares de Fontes Curadas:
    • Tech Moderno: Inter ou Geist Sans + JetBrains Mono para tags e código.
    • Criativo de Alto Impacto: Plus Jakarta Sans ou Syne + Inter.
    • Editorial e Luxo: Cormorant Garamond (serifa para exibição) + Inter (sans para corpo).

2. Ritmo Espacial e a Grade Matemática de 8pt

  • Preenchimento de Seção: Espaço de respiro vertical generoso (py-20 md:py-28). Seções apertadas sufocam o design.
  • Pilha de Layout: O espaçamento vertical entre as seções principais deve usar space-y-24 ou space-y-28.
  • Grades de Cartões: Padronize com gap-6 ou gap-8.
  • Contêineres de Largura de Conteúdo:
    • Editorial / Minimalista: max-w-4xl mx-auto px-6
    • Bento de Desenvolvedor: max-w-5xl mx-auto px-4 sm:px-6
    • Showreel de Mídia: max-w-6xl mx-auto px-4 sm:px-6

3. Elevação de Superfície e Ciência das Bordas Finas

  • Camada 0 (Tela): #09090b (Escuro) / #fafaf9 ou #ffffff (Claro).
  • Camada 1 (Base do Cartão): #121215 / bg-white dark:bg-zinc-900/60 com backdrop-blur-md.
  • Camada 2 (Bordas Finas): border border-zinc-200/80 dark:border-zinc-800/80 ou border border-white/[0.08]. Nunca use sombras projetadas pesadas e turvas.
  • Camada 3 (Micro-Hover): Holofote radial que segue o cursor (rgba(255,255,255,0.06)), ou clareamento sutil da borda hover:border-zinc-400 dark:hover:border-zinc-700, além de leve elevação hover:-translate-y-0.5 transition-all duration-300.

4. Detalhes Interativos e Acabamento

  • Indicador de Status Ao Vivo:
    <div class="inline-flex items-center gap-2 px-3 py-1.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border border-emerald-500/20">
      <span class="w-2 h-2 rounded-full bg-emerald-500 animate-pulse"></span>
      <span>Disponível para Oportunidades no Q1 2026</span>
    </div>
    
  • Pílula de Cópia de E-mail com Um Clique (com feedback visual) : Forneça cópia instantânea para a área de transferência com uma transição de dica de ferramenta confirmando "Copiado!".
  • Alternador de Tema de Modo Dual: Inclua sempre um alternador de tema funcional (Escuro / Claro) com morfismo de ícone e persistência em localStorage.

📦 Arsenal de Componentes Verificados (Acesso Direto)

A habilidade inclui primitivas TSX verificadas e prontas para produção e catálogos completos:

1. Heróis de Assinatura (components-library/heroes/):

  • ImageStreamHero.tsx: Trilhos de streaming de ponto de fuga com profundidade (criadores e editores de vídeo).
  • PerspectiveTunnelHero.tsx: Perspectiva espacial 3D de eixo Z com métricas ao vivo (engenheiros e arquitetos).
  • ProductRailGallery.tsx: Cabideiro interativo com física de balanço (e-commerce e moda).
  • TiltedGridHero.tsx: Stream de imagem 3D curvado em direção ao visualizador (designers de UI/UX e fotógrafos).
  • PrismHero.tsx: Estética de shader de refração de cristal cromático (diretores de arte e portfólios de luxo).
  • TigerTearRevealHero.tsx: Efeito de rasgo interativo revelando slogan (criativos de alto impacto).
  • AgencyHero01.tsx: Herói de alta confiança para agências com avatares sociais e badges de avaliação (freelancers e agências).
  • ResponsiveHeroBanner.tsx: Banner cinematográfico com navegação glassmórfica (fundadores e líderes).
  • CenteredImageFanHero.tsx: Título em destaque com colagem de 3 imagens em leque (designers de produto).

2. Primitivas Interativas Autônomas (components-library/):

  • Fundos: backgrounds/AuroraBackground.tsx (ondas sutis de esmeralda/ciano/ardósia, sem neon roxo).
  • Cartões Interativos: cards/SpotlightCard.tsx (brilho que segue o mouse), cards/Card3D.tsx (inclinação de perspectiva), cards/BorderBeam.tsx (feixe de borda fina animado), cards/Meteors.tsx (partículas de estrelas cadentes).
  • Seções e Layouts: sections/BentoGrid.tsx (grade responsiva assimétrica), sections/InfiniteMarquee.tsx (ticker contínuo de tecnologia/logos), sections/BeforeAfterSlider.tsx (comparação interativa de imagem/vídeo), sections/VideoModal.tsx (pop-up de vídeo cinematográfico), sections/TerminalWidget.tsx (CLI interativa simulada).
  • Controles de UI: ui/FloatingNav.tsx (barra de navegação flutuante em pílula glassmórfica), ui/ShimmerButton.tsx (botão de ação cintilante), ui/TextGenerateEffect.tsx (revelação escalonada de palavras), ui/CopyEmailButton.tsx (pílula de cópia com um clique), ui/ThemeToggle.tsx (alternador de tema escuro/claro).

3. Índice Mestre de Componentes:

  • Acesse o Catálogo Mestre 21st.dev completo em components-library/catalog/INDEX.md contendo 11.750+ componentes categorizados em 22 categorias (Botões, Heróis, Galerias, Recursos, Preços, Rodapés, FAQs, etc.).

4. Servidor MCP shadcn Oficial (Chave de API Zero):

  • A IA usa o servidor shadcn MCP oficial (npx shadcn@latest mcp) que é 100% gratuito, open-source e não requer chaves de API.
  • Qualquer componente do catálogo pode ser instalado via:
    npx shadcn@latest add "https://21st.dev/r/<autor>/<nome-do-componente>"
    
  • Nenhum MCP pago 21st.dev ou chave de API é necessário.

5. Inspirações Premium de Template e Design de Movimento:

A IA pode ativamente extrair padrões arquitetônicos, movimento cinético e layouts de alta conversão dos ecossistemas de design mais premium do mundo:

  • VibeUI (vibeui.dev): Composições modernas de componentes, pilhas de cartões táteis, badges interativos, pílulas de controle flutuantes e primitivas de layout estético.
  • Trical (trical.so): Templates de portfólio ultra-limpos e de alta conversão, tipografia de nível de revista, linhas divisórias sutis e estudos de caso editoriais de projeto.
  • Motion Site (motion.site.ai): Micro-animações fluidas, revelações cinéticas de títulos, física de mola e curvas de transição orgânicas.
  • 21st.dev & Aceternity UI: Catálogo mestre de 11.750+ componentes compatíveis com shadcn e primitivas de interação espacial 3D.

⚡ Modos de Entrega Dupla

A IA suporta dois formatos de entrega flexíveis, dependendo das necessidades do usuário:

Modo A: Base de Código React + Vite + Tailwind (TypeScript) Completa (Padrão)

Gera uma estrutura de projeto modular e de nível empresarial completa:

meu-portfolio/
├── package.json
├── vite.config.ts
├── tailwind.config.js
├── postcss.config.js
├── tsconfig.json
├── index.html
└── src/
    ├── main.tsx
    ├── App.tsx
    ├── index.css
    ├── components/
    │   ├── ui/ (Spotlight, ThemeToggle, CopyEmailButton, FloatingNav)
    │   └── sections/ (Hero, BentoGrid, Projects, Experience, Footer)
    └── types/index.ts

Modo B: Arquivo Único HTML/Tailwind/Lucide/JS Independente e Instantâneo

Quando o usuário quer configuração zero, pré-visualização imediata no navegador local ou hospedagem instantânea (ex.: GitHub Pages):

  • Gera um único index.html lindamente formatado e autocontido.
  • Inclui CDN do Tailwind CSS, Google Fonts, CDN do Lucide Icons e JS vanilla para alternância de tema, feedback de cópia, pop-ups modais e interações de hover.
  • Veja implementações de referência de produção em templates/developer-bento/index.html, templates/creative-minimalist/index.html, e templates/video-editor-showreel/index.html.

🛠️ Fluxo de Trabalho de Execução Passo a Passo

┌────────────────────────────────────────────────────────┐
│  PASSO 1: COLETA E EXTRAÇÃO DE CURRÍCULO              │
│  Extrair métricas, funções, projetos, stack de tecnologia│
│  (Ou executar questionário de fallback de 3 lotes)     │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  PASSO 2: ALINHAMENTO INTERATIVO OBRIGATÓRIO          │
│  Perguntar: Estética, Modo de Tema, Herói e Componentes│
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  PASSO 3: SELEÇÃO DE COMPONENTES E ARQUITETURA       │
│  Montar primitivas 21st.dev de components-library/    │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  PASSO 4: GERAÇÃO DO CÓDIGO DE PRODUÇÃO               │
│  Gerar React + Vite (padrão) ou HTML Independente     │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  PASSO 5: AUDITORIA E INSTRUÇÕES DE EXECUÇÃO          │
│  Verificar regras anti-slop, validar build, fornecer comandos│
└────────────────────────────────────────────────────────┘

Passo 1: Protocolo de Coleta

  1. Se o usuário fornecer um currículo ou resumo do LinkedIn: Analise métricas reais, linha do tempo da carreira, principais 3-4 projetos e competências técnicas.
  2. Se nenhum currículo for fornecido: Nunca alucine credenciais. Execute o questionário de 3 lotes de references/questionnaire.md:
    • Lote 1: Identidade e Função Alvo
    • Lote 2: Principais 2-3 Projetos e Números Concretos
    • Lote 3: Links Sociais e de Contato

Passo 2: Alinhamento Interativo Obrigatório (NÃO PULE)

A menos que o usuário tenha especificado explicitamente seu estilo visual e componentes antecipadamente, pause e apresente o alinhamento interativo:

"Antes de eu gerar seu portfólio, vamos personalizar o design visual e os componentes interativos:

  1. Estilo Visual / Estética:
    • Tech Elegante / Dark Bento (Estilo Linear / 21st.dev — tela obsidiana, cartões com hover spotlight, bordas finas).
    • Minimalista Limpo / Suíço Moderno (Estilo Dieter Rams / Apple — espaços em branco generosos, tipografia refinada, linhas sutis).
    • Editorial de Alto Contraste (Títulos com serifa, estética de estúdio, estudos de caso em estilo revista).
    • Criador Cinematográfico / Movimento (Tela escura profunda, incorporação de showreels de vídeo ricos, badges de visualizações).
    • Neo-Brutalismo

...

(conteúdo truncado para tradução)

Habilidades Relacionadas