Communitygithub.com

infinyte/gerador-de-portfolio-showcase

Transforme projetos técnicos em peças de portfólio atraentes com resumos executivos, análises técnicas aprofundadas, diagramas de arquitetura, métricas de impacto e páginas GitHub Pages prontas para demonstração. Analisa repositórios GitHub e descrições de projetos para gerar materiais de showcase específicos para cada público.

O que é gerador-de-portfolio-showcase?

O skill 'infinyte/gerador-de-portfolio-showcase' é uma ferramenta poderosa para desenvolvedores que desejam transformar seus projetos técnicos em materiais de portfólio profissionais e impactantes. Ele é útil porque automatiza a adaptação do conteúdo para diferentes públicos (recrutadores, gerentes de contratação, arquitetos, líderes técnicos) e formatos (resumos executivos, análises técnicas aprofundadas, diagramas de arquitetura Mermaid, métricas quantificadas, histórias STAR para entrevistas e sites completos em GitHub Pages). O skill funciona recebendo como entrada um repositório GitHub, notas do projeto, especificações técnicas ou conversação natural, analisa a estrutura do código, padrões arquiteturais e métricas de impacto, e gera os artefatos solicitados seguindo estruturas predefinidas para cada público. Suporta múltiplas plataformas (CLI do Claude, Cursor, Codex, etc.) e é ideal para candidatos a vagas, preparação para entrevistas e construção de portfólios online.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add infinyte/portfolio-showcase-generator

Perguntar na sua IA favorita

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

Documentação

Gerador de Portfolio Showcase

Uma skill abrangente para transformar projetos técnicos em peças de portfólio profissionais otimizadas para diferentes públicos (recrutadores, gerentes de contratação, arquitetos, líderes técnicos).

Capacidades Principais

  1. Análise de Código - Analisar estrutura de repositórios GitHub, pilha tecnológica, padrões arquiteturais
  2. Adaptação de Público - Gerar conteúdo para executivos, arquitetos e equipes técnicas
  3. Visualização de Arquitetura - Criar diagramas de sistema, fluxo de dados e implantação
  4. Quantificação de Impacto - Extrair e apresentar métricas de negócio e realizações técnicas
  5. Saída Multi-Formato - Resumos executivos, análises técnicas aprofundadas, histórias para entrevistas, páginas GitHub Pages

Quando Usar Esta Skill

Use esta skill quando o usuário quiser:

  • Transformar um projeto técnico em materiais de portfólio
  • Criar estudos de caso atraentes a partir de seu trabalho
  • Gerar materiais de preparação para entrevistas (histórias no formato STAR)
  • Construir uma página profissional no GitHub Pages
  • Extrair impacto de negócio a partir de realizações técnicas
  • Criar resumos de projeto específicos para cada público

Formatos de Entrada

A skill aceita vários formatos de entrada:

1. Repositório GitHub

  • URL do repositório ou caminho local
  • Analisa: estrutura de arquivos, padrões de código, pilha tecnológica, dependências, documentação
  • Extrai: padrões arquiteturais (DDD, microsserviços, etc.), frameworks, serviços em nuvem

2. Contexto do Projeto (qualquer combinação)

  • Notas/índices brutos - Capturas rápidas de realizações e detalhes
  • Especificações técnicas - Documentos de arquitetura, documentos de design
  • Conversacional - Usuário descreve o projeto naturalmente
  • Documentação existente - Arquivos README, wikis, ADRs

3. Contexto de Negócio

  • Metas e objetivos do projeto
  • Problemas resolvidos
  • Partes interessadas e usuários
  • Cronograma e tamanho da equipe
  • Restrições e desafios

Geração de Saída

1. Resumo Executivo (Para Gerentes de Contratação/Recrutadores)

Propósito: Visão geral rápida e de alto impacto focada no valor de negócio e resultados.

Estrutura:

  • Visão Geral do Projeto (2-3 frases): O que é, por que é importante
  • Principais Realizações (3-5 itens): Impacto de negócio quantificado
  • Destaques Técnicos (breve): Tecnologias/abordagens notáveis
  • Cronograma e Escopo: Duração, tamanho da equipe, função
  • Métricas de Impacto: Ganhos de desempenho, economia de custos, métricas de usuário

Tom: Profissional, confiante, focado em resultados. Minimize jargões. Lide com resultados.

Comprimento: 150-250 palavras (leitura de 30-60 segundos)

2. Análise Técnica Aprofundada (Para Arquitetos/Líderes Técnicos)

Propósito: Demonstrar pensamento arquitetural, profundidade técnica e julgamento de engenharia.

Estrutura:

  • Contexto e Restrições: Requisitos, restrições, sistemas existentes
  • Decisões Arquiteturais: Principais escolhas de design com justificativa
  • Implementação Técnica:
    • Arquitetura do sistema
    • Pilha tecnológica e por quê
    • Padrões aplicados (DDD, CQRS, event sourcing, etc.)
    • Pontos de integração
  • Desafios e Soluções: Problemas técnicos e como você os resolveu
  • Escala e Desempenho: Métricas, estratégias de otimização
  • Segurança e Qualidade: Testes, observabilidade, medidas de segurança
  • Trade-offs: O que você otimizou, o que sacrificou, por quê

Tom: Técnico, mas acessível. Explique o raciocínio, não apenas as escolhas. Mostre julgamento.

Comprimento: 800-1500 palavras (leitura de 4-6 minutos)

3. Diagramas de Arquitetura (Mermaid)

Gere diagramas relevantes com base no tipo de projeto:

Diagrama de Arquitetura do Sistema:

graph TB
    Client[Aplicação Cliente]
    API[Gateway de API]
    Service1[Nome do Serviço]
    Service2[Nome do Serviço]
    DB[(Banco de Dados)]
    Cache[(Cache)]
    
    Client --> API
    API --> Service1
    API --> Service2
    Service1 --> DB
    Service1 --> Cache

Diagrama de Fluxo de Dados:

flowchart LR
    Source[Fonte de Dados] --> Ingestion[Camada de Ingestão]
    Ingestion --> Processing[Processamento]
    Processing --> Storage[(Armazenamento)]
    Storage --> API[Camada de API]
    API --> Consumer[Consumidor]

Diagrama de Implantação:

graph TB
    subgraph Azure
        subgraph VNet
            AppService[App Service]
            Function[Azure Functions]
        end
        DB[(Banco SQL)]
        Storage[(Armazenamento Blob)]
    end
    
    AppService --> DB
    Function --> Storage

Diretrizes:

  • Use o tipo de diagrama apropriado para o conteúdo
  • Mantenha os diagramas focados (5-12 nós no máximo)
  • Use rótulos claros e descritivos
  • Inclua legenda se necessário para cores/formas
  • Gere vários diagramas se o projeto for complexo

4. Métricas e Análise de Impacto

Extraia e apresente realizações quantificáveis:

Métricas Técnicas:

  • Melhorias de desempenho (tempo de resposta, throughput, etc.)
  • Realizações de escalabilidade (usuários suportados, transações/segundo)
  • Qualidade de código (cobertura de testes, redução de defeitos)
  • Confiabilidade (tempo de atividade, MTTR, taxas de erro)
  • Melhorias de segurança (vulnerabilidades abordadas, conformidade alcançada)

Métricas de Negócio:

  • Economia de custos (infraestrutura, tempo de desenvolvimento)
  • Impacto na receita (novas capacidades, expansão de mercado)
  • Ganhos de eficiência (automação, redução de trabalho manual)
  • Satisfação do usuário (NPS, taxas de adoção)
  • Tempo de mercado (velocidade de entrega, frequência de lançamento)

Formato: Apresente como números concretos com contexto:

  • "Reduziu o tempo de resposta da API em 60% (450ms → 180ms)"
  • "Reduziu custos de nuvem em $24K/ano através de otimização de recursos"
  • "Permitiu escala de 10x de 1K → 10K usuários simultâneos"

5. Preparação para Entrevistas (Formato STAR)

Gere 2-4 histórias convincentes no formato STAR:

Estrutura:

  • Situação: Contexto, problema, restrições (2-3 frases)
  • Tarefa: Sua responsabilidade específica (1-2 frases)
  • Ação: O que você fez, decisões técnicas, implementação (3-5 frases)
  • Resultado: Resultados, métricas, impacto (2-3 frases)

Comprimento: Cada história deve ter 90-120 segundos quando falada

Foco: Histórias diferentes devem destacar:

  • Resolução de problemas técnicos
  • Tomada de decisão arquitetural
  • Liderança/influência
  • Lidar com restrições/trade-offs

6. Site GitHub Pages

Gere uma estrutura de site estático completa:

Página Inicial (index.html):

  • Seção hero com nome do projeto e slogan
  • Estatísticas rápidas (pilha tecnológica, cronograma, métricas de impacto)
  • Navegação para seções
  • Captura de tela/demo se disponível

Página de Arquitetura (architecture.html):

  • Visão geral do sistema
  • Diagramas de arquitetura (Mermaid embutido)
  • Detalhes da pilha tecnológica
  • Decisões de design

Página de Impacto (impact.html):

  • Resultados de negócio
  • Realizações técnicas
  • Visualização de métricas
  • Comparações antes/depois

Página de Demonstração (demo.html - se aplicável):

  • Demonstração interativa ou passo a passo
  • Capturas de tela com anotações
  • Cenários de uso
  • Incorporação de vídeo se disponível

Estilização:

  • Design limpo e profissional
  • Responsivo para celular
  • Carregamento rápido (dependências mínimas)
  • Acessível (conforme WCAG)
  • Opcional: Use Primer CSS do GitHub ou CDN Tailwind

Fluxo de Trabalho

Passo 1: Coletar Entrada

  1. Perguntar pela fonte do projeto:

    • URL/caminho do repositório GitHub
    • Documentação existente
    • Notas do projeto
  2. Entender o contexto:

    • Que problema isso resolveu?
    • Para quem foi?
    • Qual foi sua função?
    • O que tornou isso desafiador?
    • Quais foram os resultados?
  3. Esclarecer saídas:

    • Quais entregáveis eles precisam?
    • Algum requisito específico (comprimento, áreas de foco)?
    • Detalhes do público-alvo?

Passo 2: Analisar (se repositório GitHub fornecido)

Use ferramentas bash/visualização para analisar o repositório:

# Analisar estrutura do repositório
find /caminho/para/repo -type f -name "*.cs" -o -name "*.csproj" | head -20
find /caminho/para/repo -type f -name "*.yml" -o -name "*.yaml"

# Verificar documentos de arquitetura
find /caminho/para/repo -type f -name "*.md" | grep -i "architecture\|design\|adr"

# Analisar dependências
cat /caminho/para/repo/*.csproj
cat /caminho/para/repo/package.json
cat /caminho/para/repo/requirements.txt

# Verificar configuração
find /caminho/para/repo -name "appsettings*.json" -o -name "*.config"

Extrair:

  • Pilha tecnológica: Linguagens, frameworks, bancos de dados, serviços em nuvem
  • Padrões: DDD, microsserviços, orientado a eventos, CQRS, etc.
  • Arquitetura: Monolito, microsserviços, serverless, etc.
  • Infraestrutura: Provedor de nuvem, estratégia de implantação
  • Práticas de qualidade: Testes, CI/CD, monitoramento

Passo 3: Gerar Conteúdo

Gere cada tipo de saída solicitada seguindo as estruturas acima.

Princípios-chave:

  • Público em primeiro lugar: Combine profundidade e jargão com o público
  • Baseado em evidências: Fundamente afirmações em código/documentos quando possível
  • Quantificar: Sempre tente incluir números e métricas
  • Orientado por histórias: Enfatize desafios → soluções → impacto
  • Honesto: Reconheça restrições e trade-offs

Passo 4: Criar Artefatos

Para documentos (resumos, análises aprofundadas):

  • Use formato markdown
  • Inclua seções claras com cabeçalhos
  • Adicione trechos de código quando relevante
  • Incorpore diagramas

Para GitHub Pages:

  • Gere arquivos HTML completos
  • Inclua CSS inline ou referencie CDN
  • Garanta capacidade de resposta para celular
  • Adicione meta tags para SEO

Para diagramas:

  • Use ferramenta Mermaid Chart para renderizar
  • Forneça tanto o código-fonte Mermaid quanto a imagem renderizada
  • Garanta que os diagramas sejam autoexplicativos

Passo 5: Empacotar Entregáveis

Organize as saídas com base nas necessidades do usuário:

Para candidaturas a empregos:

  • Resumo executivo (pronto para copiar/colar)
  • 2-3 histórias STAR
  • Lista de métricas-chave

Para site de portfólio:

  • Estrutura completa do GitHub Pages
  • Todos os ativos organizados
  • Instruções de implantação

Para entrevistas:

  • Histórias STAR (impressas/PDF)
  • Diagrama de arquitetura (para referência de whiteboard)
  • Folha de dicas de métricas

Considerações Especiais

Projetos .NET/Azure

  • Destaque: Padrões DDD, princípios SOLID, padrões async/await
  • Enfatize: Zero Trust, conformidade InfoSec, padrões empresariais
  • Pilha tecnológica: Versão .NET, serviços Azure usados, padrões de design

Projetos de Machine Learning/Visão Computacional

  • Foco: Formulação do problema, justificativa da seleção do modelo, métricas de desempenho
  • Destaque: Abordagem de treinamento, pipeline de dados, otimização de inferência
  • Métricas: Acurácia, precisão, recall, F1, latência de inferência

Projetos de Integração

  • Enfatize: Design de API, tratamento de erros, consistência de dados
  • Destaque: Integrações de terceiros, limitação de taxa, padrões de resiliência
  • Métricas: Confiabilidade (tempo de atividade), precisão de dados, throughput

Projetos Empresariais/Em Grande Escala

  • Contexto: Escala, requisitos de conformidade, restrições legadas
  • Destaque: Estratégias de migração, compatibilidade reversa, mitigação de riscos
  • Métricas: Números de escala, desempenho sob carga, otimização de custos

Formato de Saída

Ao gerar múltiplas saídas, organize da seguinte forma:

# Portfolio Showcase: [Nome do Projeto]

## Referência Rápida
- **Pilha Tecnológica**: [Lista]
- **Duração**: [Cronograma]
- **Função**: [Sua função]
- **Impacto**: [Top 1-2 métricas]

## Saídas Geradas

### 1. Resumo Executivo
[Conteúdo]

### 2. Análise Técnica Aprofundada
[Conteúdo]

### 3. Histórias STAR
#### História 1: [Título]
[Conteúdo]

#### História 2: [Título]
[Conteúdo]

### 4. Diagramas de Arquitetura
[Diagramas com explicações]

### 5. Painel de Métricas
[Métricas formatadas]

### 6. Arquivos GitHub Pages
[Estrutura de arquivos e conteúdos]

Lista de Verificação de Qualidade

Antes de entregar, garanta:

  • Todas as métricas são específicas e quantificadas
  • Termos técnicos são explicados ou justificados para o público
  • Diagramas são claros e devidamente rotulados
  • Histórias STAR estão completas (todos os 4 elementos)
  • Resumo executivo passa no teste do "elevator pitch"
  • Análise técnica aprofundada demonstra pensamento arquitetural
  • Páginas GitHub Pages são responsivas para celular e acessíveis
  • Nenhum erro gramatical ou digitação
  • Terminologia consistente em todo o texto
  • Realizações são enquadradas como impacto, não apenas tarefas

Exemplos de Prompts

Simples: "Crie um portfolio showcase para meu projeto DocFlow no GitHub"

Detalhado: "Construí um painel de status de voo usando .NET 8, DDD e Azure. Foi o primeiro aplicativo implantado em nosso ambiente Zero Trust. Preciso de um resumo executivo para recrutadores e uma análise técnica aprofundada para a entrevista, além de diagramas de arquitetura."

Conversacional: "Quero mostrar meu projeto de scanner de documentos com IA. Ele usa visão computacional para extrair dados de quadros brancos e se integra com vários sistemas. Você pode me ajudar a criar materiais para meu site de portfólio?"

Dicas para Usuários

Para obter os melhores resultados:

  1. Forneça acesso ao GitHub, se possível (fonte de informação mais rica)
  2. Compartilhe o "porquê" por trás do projeto (contexto de negócio é importante)
  3. Inclua quaisquer métricas que você acompanhou (mesmo informais)
  4. Mencione desafios que você superou (eles geram ótimas histórias)
  5. Especifique seu público-alvo (a profundidade técnica varia muito)
  6. Note o que te deixou orgulhoso ou o que você aprendeu (detalhes autênticos ressoam)

Erros comuns a evitar:

  • Ser muito humilde (portfólio não é lugar para modéstia)
  • Listar tarefas em vez de realizações ("Construí API" vs "Projetei API que reduziu latência em 40%")
  • Usar jargões sem contexto para públicos não técnicos
  • Esquecer de quantificar o impacto
  • Fazer parecer um relatório de equipe em vez de sua contribuição

Habilidades Relacionadas