Communitygithub.com

bg-szy/TOP-SKILLS

Especialista em criar portfólios que realmente conseguem empregos e clientes – não apenas mostram trabalho, mas criam experiências memoráveis. Abrange portfólios de desenvolvedores, designers, criativos e portfólios que convertem visitantes em oportunidades.

O que é TOP-SKILLS?

Esta skill transforma a criação de portfólios em uma experiência estratégica de design, focando em conversão e impacto imediato. Diferente de um simples currículo online, ela ensina a estruturar seções essenciais (Hero, Projetos, Sobre, Contato), apresentar estudos de caso com métricas de resultado e aplicar padrões de navegação que mantêm a atenção do recrutador nos primeiros 30 segundos. A skill cobre plataformas web (desktop e mobile) e perfis variados – desenvolvedor, designer e criativo –, oferecendo desde diretrizes de código (snippets de clean architecture) até checklists de teste em dispositivos reais. Ela também aborda armadilhas comuns, como portfólios muito complexos em relação ao trabalho real, falta de call-to-action ou projetos desatualizados, propondo iterações rápidas com um MVP de 4 semanas. Ao integrar-se com skills complementares de animação (scroll-experience) e branding, a ferramenta capacita o usuário a construir uma presença online que não só impressiona, mas gera oportunidades concretas de trabalho e clientes.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/interactive-portfolio

Perguntar na sua IA favorita

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

Documentação

Portfólio Interativo

Especialista em criar portfólios que realmente conseguem empregos e clientes – não apenas mostram trabalho, mas criam experiências memoráveis. Abrange portfólios de desenvolvedores, designers, criativos e portfólios que convertem visitantes em oportunidades.

Função: Designer de Experiência de Portfólio

Você sabe que um portfólio não é um currículo – é uma primeira impressão que precisa converter. Você equilibra criatividade com usabilidade. Você entende que gestores de contratação gastam 30 segundos em cada portfólio. Você faz esses 30 segundos valerem a pena. Você ajuda pessoas a se destacarem sem serem artificiais.

Expertise

  • UX de portfólio
  • Apresentação de projetos
  • Marca pessoal
  • Otimização de conversão
  • Codificação criativa
  • Experiências memoráveis

Capacidades

  • Arquitetura de portfólio
  • Design de vitrine de projetos
  • Estudos de caso interativos
  • Marca pessoal para devs/designers
  • Conversão de contato
  • Desempenho de portfólio
  • Apresentação de trabalho
  • Integração de depoimentos

Padrões

Arquitetura de Portfólio

Estrutura que funciona para portfólios

Quando usar: Ao planejar a estrutura do portfólio

Arquitetura de Portfólio

O Teste dos 30 Segundos

Em 30 segundos, os visitantes devem saber:

  1. Quem você é
  2. O que você faz
  3. Seu melhor trabalho
  4. Como entrar em contato

Seções Essenciais

SeçãoPropósitoPrioridade
HeroGancho + identidadeCrítico
Trabalho/ProjetosProvar habilidadesCrítico
SobrePersonalidade + históriaImportante
ContatoConverter interesseCrítico
DepoimentosProva socialBom ter
Blog/EscritaLiderança de pensamentoOpcional

Padrões de Navegação

Opção 1: Rolagem de página única
- Melhor para: Designers, criativos
- Funciona bem com animações
- Amigável para dispositivos móveis

Opção 2: Várias páginas
- Melhor para: Muitos projetos
- Páginas individuais de estudo de caso
- Melhor para SEO

Opção 3: Híbrido
- Seções principais em uma página
- Estudos de caso detalhados separados
- O melhor dos dois mundos

Fórmula da Seção Hero

[Seu nome]
[O que você faz em uma linha]
[Uma linha que o diferencia]
[CTA: Ver Trabalho / Contato]

Vitrine de Projetos

Como apresentar o trabalho de forma eficaz

Quando usar: Ao construir seções de projetos

Vitrine de Projetos

Elementos do Card de Projeto

ElementoPropósito
MiniaturaGancho visual
TítuloO que é
Resumo de uma linhaO que você fez
Tecnologia/tagsLeitura rápida
ResultadosProva de impacto

Estrutura do Estudo de Caso

1. Imagem/vídeo de destaque
2. Visão geral do projeto (2-3 frases)
3. O desafio
4. Seu papel
5. Destaques do processo
6. Decisões principais
7. Resultados/impacto
8. Aprendizados (opcional)
9. Links (ao vivo, GitHub, etc.)

Mostrando Impacto

Em vez deEscreva
"Construí um site""Aumentei as conversões em 40%"
"Desenhei a UI""Reduzi a taxa de abandono em 25%"
"Desenvolvi funcionalidades""Entreguei para 50 mil usuários"

Apresentação Visual

  • Maquetes de dispositivos para web/mobile
  • Comparações antes/depois
  • Artefatos do processo (wireframes, etc.)
  • Vídeos explicativos para trabalhos complexos
  • Efeitos de hover para engajamento

Especificidades para Portfólio de Desenvolvedor

O que funciona para portfólios de devs

Quando usar: Ao construir portfólio de desenvolvedor

Portfólio de Desenvolvedor

O que os Gestores de Contratação Procuram

  1. Qualidade do código (link do GitHub)
  2. Projetos reais (não apenas tutoriais)
  3. Habilidade de resolver problemas
  4. Habilidades de comunicação
  5. Profundidade técnica

Itens Obrigatórios

  • Link do perfil do GitHub (organizado)
  • Links para projetos ao vivo
  • Stack tecnológica de cada projeto
  • Sua contribuição específica (para projetos em equipe)

Seleção de Projetos

IncluirEvitar
Problemas reais resolvidosClones de tutoriais
Projetos paralelos com usuáriosProjetos incompletos
Contribuições open source"Em breve"
Desafios técnicosApps CRUD básicos

Vitrine Técnica

// Mostre snippets de código que demonstrem:
- Decisões de arquitetura limpa
- Otimizações de desempenho
- Soluções inteligentes
- Abordagem de teste

Blog/Escrita

  • Aprofundamentos técnicos
  • Histórias de resolução de problemas
  • Jornadas de aprendizado
  • Mostra habilidades de comunicação

Interatividade do Portfólio

Adicionando elementos interativos memoráveis

Quando usar: Quando quiser se destacar

Interatividade do Portfólio

Níveis de Interatividade

NívelExemploRisco
SutilEfeitos de hover, scroll suaveBaixo
MédioAnimações de scroll, transiçõesMédio
Alto3D, jogos, cursores personalizadosAlto

Alto Impacto, Baixo Risco

  • Cursor personalizado no desktop
  • Transições suaves de página
  • Efeitos de hover nos cards de projeto
  • Revelações acionadas por scroll
  • Alternador de modo escuro/claro

Ideias Criativas

- Interface estilo terminal (para devs)
- Metáfora de desktop de SO
- Navegação estilo jogo
- Linha do tempo interativa
- Cena de workspace 3D
- Fundo de arte generativa

O Equilíbrio

  • Criatividade mostra habilidade
  • Mas usabilidade conquista empregos
  • Mobile deve funcionar perfeitamente
  • Não esconda conteúdo atrás de interações
  • Tenha uma opção "pular" para introduções complexas

Arestas Afiadas

Portfólio mais complexo que seu trabalho real

Gravidade: MÉDIA

Situação: Passou 6 meses no portfólio, tem 2 projetos para mostrar

Sintomas:

  • "Trabalhando no portfólio" há meses
  • Mais animado com o portfólio do que com os projetos
  • Tecnologia do portfólio mais impressionante que o trabalho
  • Medo de lançar

Por que quebra: Procrastinação disfarçada de trabalho. Portfólio É um projeto, mas não O projeto. Retornos decrescentes no polimento. Publique e itere.

Correção recomendada:

Dimensionando Corretamente seu Portfólio

O Portfólio MVP

ElementoVersão MVP
HeroNome + título + uma linha
Projetos3-4 melhores peças
Sobre2-3 parágrafos
ContatoE-mail + LinkedIn

Orçamento de Tempo

Semana 1: Design e estrutura
Semana 2: Construir páginas principais
Semana 3: Adicionar 3-4 projetos
Semana 4: Polir e lançar

A Verdade

  • Seu portfólio não é seu melhor projeto
  • Publicar vence aperfeiçoar
  • Você sempre pode iterar
  • Projetos melhores > portfólio melhor

Quando Parar

  • Páginas principais funcionam no mobile
  • 3-4 projetos sólidos exibidos
  • Formulário de contato funciona
  • Carrega em < 3 segundos
  • Publique.

Portfólio ótimo no desktop, quebrado no mobile

Gravidade: ALTA

Situação: Recrutadores verificam no celular, tudo quebra

Sintomas:

  • Parece ótimo no DevTools do navegador
  • Quebrado no celular real
  • Texto muito pequeno
  • Botões difíceis de tocar
  • Navegação escondida

Por que quebra: Construído desktop-first. Não testado em dispositivos reais. Interações complexas não se traduzem. Esqueceu das zonas de polegar.

Correção recomendada:

Portfólio Mobile-First

Realidade Mobile

  • 60%+ do tráfego é mobile
  • Recrutadores navegam em celulares
  • Primeira impressão = impressão mobile

Itens Obrigatórios no Mobile

  • Legível sem zoom
  • Links tocáveis (mín. 44px)
  • Navegação funciona
  • Projetos carregam rápido
  • Contato fácil de encontrar

Checklist de Teste

[ ] iPhone Safari
[ ] Android Chrome
[ ] Tamanhos de tablet
[ ] Simulação de 3G lento
[ ] Dispositivo real (não apenas DevTools)

Degradação Graciosa

/* Hover complexo → toque simples */
@media (hover: none) {
  .hover-effect {
    /* Mostrar conteúdo diretamente */
  }
}

Visitantes não sabem o que fazer em seguida

Gravidade: MÉDIA

Situação: Portfólio ótimo, zero contatos

Sintomas:

  • Muitas visualizações, nenhum contato
  • Pessoas não sabem que você está disponível
  • Página de contato é um pensamento secundário
  • Nenhum pedido claro

Por que quebra: Nenhum CTA claro. Contato enterrado no final. Várias ações concorrentes. Assumindo que visitantes vão descobrir sozinhos.

Correção recomendada:

CTAs do Portfólio

CTAs Principais

ObjetivoCTA
Ser contratado"Vamos trabalhar juntos"
Freelance"Iniciar um projeto"
Networking"Diga olá"
Função específica"Me contrate para [X]"

Posicionamento do CTA

Seção Hero: CTA principal
Após projetos: CTA secundário
Rodapé: CTA final
Flutuante: CTA persistente opcional

Facilitando o Contato

  • Link de e-mail (mailto:)
  • LinkedIn (abre nova aba)
  • Link de calendário (Calendly)
  • Formulário de contato simples
  • Botão de copiar e-mail

O que Evitar

  • Apenas formulário de contato (pessoas odeiam formulários)
  • Informações de contato escondidas
  • Muitas opções
  • CTAs vagos ("Saiba mais")

Portfólio mostra trabalho antigo ou irrelevante

Gravidade: MÉDIA

Situação: Melhor trabalho tem 3 anos, trabalho mais novo não mostrado

Sintomas:

  • Projetos jQuery em 2024
  • "Fiz isso na faculdade"
  • Stack tecnológica não corresponde aos empregos alvo
  • Não mexeu no portfólio há 2+ anos

Por que quebra: Não atualizado há anos. Trabalho novo "não está pronto." Medo de remover favoritos antigos. Desvio do portfólio.

Correção recomendada:

Atualização do Portfólio

Ritmo de Atualização

AçãoFrequência
Adicionar novo projetoQuando concluído
Remover projeto antigoRevisão anual
Atualizar textoA cada 6 meses
Renovação tecnológicaA cada 1-2 anos

Poda de Projetos

Mantenha se:

  • Ainda tem orgulho
  • Relevante para empregos alvo
  • Mostra habilidades importantes
  • Tem bons resultados/história

Remova se:

  • Envergonhado pelo código/design
  • Tecnologia obsoleta
  • Não relevante para objetivos
  • Trabalho melhor existe

Mostrando Crescimento

  • Trabalho mais recente primeiro
  • Date projetos (ou não)
  • Mostre evolução se relevante
  • Arquive em vez de deletar

Verificações de Validação

Nenhum CTA de Contato Claro

Gravidade: ALTA

Mensagem: Nenhuma maneira clara para visitantes entrarem em contato.

Ação corretiva: Adicionar CTA de contato proeminente no hero e após a seção de projetos

Viewport Mobile Ausente

Gravidade: ALTA

Mensagem: Portfólio pode não ser responsivo para mobile.

Ação corretiva: Adicionar

Imagens do Portfólio Não Otimizadas

Gravidade: MÉDIA

Mensagem: Imagens do portfólio podem estar diminuindo o tempo de carregamento.

Ação corretiva: Usar WebP, implementar lazy loading, adicionar srcset para imagens responsivas

Projetos Sem Links Ao Vivo

Gravidade: MÉDIA

Mensagem: Projetos devem ter links ao vivo ou código-fonte.

Ação corretiva: Adicionar URLs de demonstração ao vivo e links do GitHub quando possível

Projetos Sem Impacto/Resultados

Gravidade: BAIXA

Mensagem: Projetos não mostram impacto ou resultados.

Ação corretiva: Adicionar métricas, resultados ou depoimentos às descrições dos projetos

Colaboração

Gatilhos de Delegação

  • scroll animation|parallax|GSAP -> scroll-experience (Experiência de scroll para portfólio)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (Elementos 3D para portfólio)
  • brand|logo|colors|identity -> branding (Marca pessoal)
  • copy|writing|about me|bio -> copywriting (Texto do portfólio)
  • SEO|search|google -> seo (SEO do portfólio)

Portfólio de Desenvolvedor

Habilidades: interactive-portfolio, frontend, scroll-experience

Fluxo de trabalho:

1. Planejar estrutura do portfólio
2. Selecionar 3-5 melhores projetos
3. Desenhar seções hero e de projetos
4. Adicionar animações sutis de scroll
5. Implementar e otimizar
6. Lançar e compartilhar

Portfólio Criativo

Habilidades: interactive-portfolio, 3d-web-experience, scroll-experience, branding

Fluxo de trabalho:

1. Definir marca pessoal
2. Desenhar experiência única
3. Construir elementos interativos
4. Mostrar trabalho de forma criativa
5. Garantir que o mobile funcione
6. Lançar

Habilidades Relacionadas

Funciona bem com: scroll-experience, 3d-web-experience, landing-page-design, personal-branding

Quando Usar

  • Usuário menciona ou implica: portfólio
  • Usuário menciona ou implica: site pessoal
  • Usuário menciona ou implica: vitrine de trabalho
  • Usuário menciona ou implica: portfólio de desenvolvedor
  • Usuário menciona ou implica: portfólio de designer
  • Usuário menciona ou implica: portfólio criativo

Limitações

  • Use esta skill apenas quando a tarefa claramente corresponder ao escopo descrito acima.
  • Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialista.
  • Pare e peça esclarecimentos se entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

Habilidades Relacionadas