Communitygithub.com

oliverarick/claude_skills

Executa a avaliação semestral do portfólio tecnológico de uma equipe de desenvolvimento.

O que é claude_skills?

Este skill automatiza o processo de avaliação semestral de portfólios tecnológicos de equipes de desenvolvimento. Ele processa arquivos de entrada individuais dos membros da equipe, que contêm tabelas de produtos com critérios ponderados (Resultado, Arquitetura, Padrões, Inovação e Colaboração), pontuações e observações. A partir desses dados, o skill gera dois entregáveis principais: um relatório executivo do portfólio completo (incluindo semáforo, ranking, análise por responsável, padrões recorrentes e backlog) e fichas de feedback individuais para cada membro da equipe. O skill segue um fluxo de trabalho de seis etapas: validação das entradas, cálculo de pontuações por produto (usando uma fórmula específica de soma ponderada), cálculo das médias e notas como responsável, geração do relatório executivo, geração das fichas individuais e verificação de consistência. Ele suporta plataformas como Claude Code, Cursor e Codex, e é acionado por comandos como 'avalie o semestre' ou 'gere o relatório de avaliação'. É útil para líderes técnicos e gerentes que precisam realizar avaliações de desempenho baseadas em portfólio de forma padronizada e eficiente, identificando riscos, forças e áreas de melhoria.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/olverarick/claude_skills/tree/HEAD/plugins/evaluador-portafolio/skills/evaluador-portafolio

Perguntar na sua IA favorita

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

Documentação

Avaliador de Portfólio Tecnológico

O que este skill produz

A partir de arquivos de entrada por pessoa, gera dois tipos de entregas:

  1. relatorio-avaliacao-semestral.md — Relatório executivo do portfólio completo com semáforo, ranking, análise por responsável, padrões recorrentes, radar de maturidade e backlog institucional.

  2. ficha-[nome-sobrenome].md para cada membro — Documento em primeira pessoa com suas pontuações, pontos fortes, áreas de melhoria, citações da sessão e plano de desenvolvimento para o próximo semestre.


Formato de entrada

Antes de começar, verifique se o usuário forneceu informações para cada pessoa. O formato mínimo esperado por pessoa:

# [Nome Sobrenome] — Média: [XX] ([Nível])

## Período: [1º/2º Semestre AAAA]

| # | Produto | R | A | E | I | C | Observações |
|---|---|---|---|---|---|---|---|
| 1 | Nome do produto | 25 | 20 | NA | 15 | 10 | Descrição do resultado alcançado |
| 2 | Outro produto       | 25 | NA | 20 | NA | NA | Descrição do resultado |

## Evidência oral (Sessão de Avanços)
Citações textuais ou paráfrases do que a pessoa disse durante a apresentação.

## Nota como responsável: [XX] ([Nível])
[Narrativa de avaliação do responsável — opcional, você pode gerá-la]

Colunas de critérios:

  • R = Resultado (peso base 25)
  • A = Arquitetura (peso base 25)
  • E = Padrões (peso base 20)
  • I = Inovação (peso base 15)
  • C = Colaboração (peso base 15)

Valores possíveis na tabela:

  • Número ≤ peso base: conquista efetiva (igual ao base = completo; menor = parcial)
  • 0: critério se aplica mas não foi alcançado
  • NA: critério não se aplica a este produto (excluído do cálculo)

Se os arquivos não tiverem tudo, pergunte ao usuário o que está faltando antes de prosseguir. Leia referencias/modelo-entrada.md para ver o formato completo com exemplos.


Fluxo de trabalho

Passo 1 — Ler e validar entradas

Leia todos os arquivos fornecidos. Para cada pessoa, verifique:

  • Lista de produtos com tabela de critérios
  • Pelo menos observações básicas por produto
  • Evidência oral (se não existir, você pode omitir essa seção nas fichas ou pedi-la ao usuário)

Se houver ambiguidade nos valores da tabela (por exemplo, uma coluna deslocada), pergunte antes de calcular.

Passo 2 — Calcular pontuações por produto

Leia referencias/metodologia.md antes de calcular. O resumo:

Score = Σ(valor_criterio) / Σ(peso_base_criterio_aplicavel) × 100

Exemplo: produto com R=25, A=20, E=NA, I=NA, C=0 → Numerador: 25 + 20 + 0 = 45 → Denominador: 25 + 25 + 15 = 65 (R+A+C, porque E e I são NA) → Score: 45/65 × 100 = 69.2 → 69 (Aceitável 🟠)

Escala de níveis:

FaixaNívelSemáforo
97–100Excepcional🟢
92–96Excelente🟢
85–91Muito Bom🟢
75–84Bom🟡
65–74Aceitável🟠
50–64Precisa Melhorar🔴
0–49Crítico🔴

Passo 3 — Calcular médias e nota como responsável

Média do portfólio individual: média aritmética de todas as pontuações dos produtos do responsável.

Nota como responsável: pode ajustar ±5 pontos da média considerando:

  • Padrão de colaboração e transferência de conhecimento (se for baixo, reduz)
  • Risco de concentração de conhecimento (se for alto, pode reduzir)
  • Execução diante de bloqueios (se escalou a tempo, mantém; se não, pode reduzir)
  • Qualidade da reflexão e maturidade profissional (se for alta, pode aumentar)

Se você não tiver critério suficiente para ajustar, use a média diretamente.

Passo 4 — Gerar o relatório executivo

Produza relatorio-avaliacao-semestral.md. Leia referencias/estrutura-relatorio.md para a estrutura completa com modelos de cada seção.

O relatório tem estas seções em ordem:

  1. Resumo Executivo
  2. Índice de Carga por Responsável
  3. Metodologia de Avaliação
  4. Avaliação por Responsável
  5. Análise do Portfólio
  6. Radar de Maturidade do Portfólio
  7. Semáforo Consolidado
  8. Ranking
  9. Padrões e Recomendações
  10. Backlog Institucional
  11. Modalidade de Trabalho
  12. Compromissos e Plano Próximo Semestre

Passo 5 — Gerar fichas individuais

Produza ficha-[nome-sobrenome].md para cada pessoa. Leia referencias/estrutura-ficha.md para o modelo com exemplos.

Características principais das fichas:

  • Tom: primeira pessoa, direto ("seu portfólio", "o que você precisa trabalhar")
  • Pontos fortes: reconhecimento genuíno, com evidência específica
  • Áreas de melhoria: nomeie o padrão, não apenas o sintoma
  • Plano de desenvolvimento: compromissos com métrica e prazo, não genéricos
  • Citações: use as citações textuais da evidência oral quando estiverem disponíveis

Passo 6 — Verificar consistência antes de entregar

  • Se o total de produtos no resumo executivo coincide com a soma por responsável
  • Se a distribuição de semáforos no resumo coincide com o semáforo consolidado
  • Se as médias individuais coincidem com os dados do índice de carga
  • Se produtos compartilhados entre responsáveis aparecem em ambas as tabelas

Notas para o avaliador

A pontuação é avaliativa, não automática. Os valores na tabela de critérios são o julgamento do avaliador sobre a conquista em cada dimensão. A fórmula mecaniza o cálculo, mas a entrada vem de uma avaliação especializada. Se o usuário fornecer os valores, aplique a fórmula. Se ele pedir que você avalie, baseie seu julgamento nas observações e evidências disponíveis.

NA ≠ 0. NA significa que o critério não se aplica (não penaliza). 0 significa que se aplica mas não foi alcançado (penaliza). A diferença muda significativamente a pontuação.

As fichas não são relatórios de RH. São documentos de desenvolvimento profissional. O plano de cada ficha deve ter compromissos específicos e mensuráveis, não frases genéricas. Evite "melhorar a comunicação" — escreva "estabelecer revisão quinzenal de avanços com o líder antes de julho de 2026".

Produtos críticos puxam a média para baixo. Um responsável com muitos produtos pode ter uma boa média geral e ainda assim ter um produto crítico que requer ação. O semáforo individual por produto é mais importante do que a média para identificar riscos.

Habilidades Relacionadas