evaluation-methodology
Ajuda seu agente a entender como a qualidade de um plugin é medida. É útil para melhorar o desempenho de um plugin ou definir padrões de qualidade.
O que ela faz
Esta ferramenta avalia a qualidade de 'skills' (ferramentas de IA) usando diferentes métodos. Ela verifica se a skill funciona bem, se responde corretamente e se está bem organizada, dando uma nota final.
Quando usar
- ✓Para entender como a qualidade de uma skill é medida.
- ✓Quando uma skill tem uma nota baixa e você quer saber o motivo.
- ✓Para melhorar a precisão de como uma skill é ativada ou sua organização.
Exemplo do que pedir para a IA
“Como posso saber se minha skill está funcionando corretamente?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta usa verificações automáticas (como um 'lint' para código) e também pede para modelos de inteligência artificial avaliarem a skill. Ela combina os resultados para dar uma nota geral.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add wshobson/agents --skill evaluation-methodologyOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/plugin-eval/skills/evaluation-methodology/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Metodologia de avaliação
O PluginEval pontua uma habilidade ou plugin de 0 a 100 combinando até três camadas. A camada
estática é um lint. É rápida e determinística, e é útil para verificar a estrutura. As camadas
de juiz LLM e Monte Carlo são experimentais, não validadas contra rótulos humanos, então trate
seus números como sinais aproximados. Para o programa de avaliação baseado em rastreamento,
veja evals/README.md na raiz do repositório.
As âncoras da rubrica do juiz estão em references/rubrics.md. Correções para cada anti-padrão e dicas para cada dimensão estão em references/improving-scores.md.
Profundidades de avaliação
| Profundidade | Camadas | Rótulo de confiança |
|---|---|---|
quick |
estática | Estimado |
standard (padrão para score) |
estática e juiz | Avaliado |
deep (usado por certify) |
estática, juiz e Monte Carlo com 50 execuções | Certificado |
thorough |
estática, juiz e Monte Carlo com 100 execuções | Certificado+ |
O rótulo nomeia a profundidade que foi executada, não uma verificação contra o julgamento humano. Um diretório de plugin recebe apenas a camada estática, qualquer que seja a profundidade solicitada.
Camada estática (lint)
A camada estática lê o SKILL.md e não faz chamadas de modelo. Ela calcula sete subpontuações, e as seis primeiras alimentam dimensões compostas:
frontmatter_quality(alimentatriggering_accuracy)orchestration_wiring(alimentaorchestration_fitness)progressive_disclosure,structural_completeness,token_efficiency,ecosystem_coherenceharness_portability
harness_portability não se mapeia a nenhuma dimensão, então não altera a pontuação composta de uma habilidade.
Ela carrega 6% da própria pontuação da camada estática. A pontuação de um plugin é construída a partir dessa pontuação de camada,
então descobertas de portabilidade podem diminuir um pouco a pontuação de um plugin. Suas descobertas não são contadas como
anti-padrões.
A camada estática sinaliza seis anti-padrões: OVER_CONSTRAINED, EMPTY_DESCRIPTION,
MISSING_TRIGGER, BLOATED_SKILL, ORPHAN_REFERENCE e DEAD_CROSS_REF. Cada sinalização corta a
pontuação em 5%, até um piso de 50%:
penalty = max(0.5, 1.0 - 0.05 * anti_pattern_count)
O relatório imprime uma severidade para cada sinalização, mas a penalidade conta as sinalizações e ignora a severidade.
Camada de juiz LLM (experimental)
A camada de juiz faz quatro chamadas de modelo e retorna quatro pontuações holísticas de 0 a 1:
triggering_accuracy: Haiku lê a descrição e escreve 10 prompts de teste, 5 que devem acionar e 5 que não devem. Ele prevê o resultado para cada prompt e relata seu próprio F1. Nada verifica essas previsões contra o acionamento real.orchestration_fitnessescope_calibration: Sonnet avalia a habilidade em uma rubrica de cinco pontos.output_quality: Sonnet imagina três tarefas e avalia a saída que ele espera.
As três chamadas do Sonnet veem apenas os primeiros 3.000 caracteres do SKILL.md. Apenas um juiz é executado,
porque nada lê a configuração judges.
Camada Monte Carlo (experimental)
Haiku escreve 15 prompts que devem acionar a habilidade, e a camada os repete para atingir 50
execuções (100 em thorough). Cada execução envia o texto do SKILL.md e um prompt para o modelo, e a
camada registra quatro medidas:
- Taxa de ativação é a proporção de execuções com qualquer resposta não vazia, então mostra se o modelo respondeu, não se a habilidade deveria ter disparado.
- Qualidade da saída é o comprimento da resposta dividido por 500, limitado a 1,0.
- Taxa de falha é a proporção de execuções que deram erro.
- Eficiência de token é
1 - median_tokens / 8000.
Cada prompt é um que deveria acionar, então a camada nunca verifica se a habilidade permanece fora de
solicitações não relacionadas. O JSON da camada inclui intervalos de Wilson, bootstrap e Clopper-Pearson
para suas próprias medidas. Os campos compostos ci_lower e ci_upper são sempre nulos.
Pontuação composta
Primeiro, para cada dimensão, o motor combina as pontuações das camadas existentes e renormaliza os pesos da combinação sobre essas camadas. Segundo, ele soma as pontuações das dimensões ponderadas e renormaliza os pesos das dimensões sobre as dimensões que têm uma pontuação. Terceiro, ele multiplica a soma por 100 e pela penalidade de anti-padrão.
| Dimensão | Peso | Estática | Juiz | Monte Carlo |
|---|---|---|---|---|
triggering_accuracy |
0.25 | 0.15 | 0.25 | 0.60 |
orchestration_fitness |
0.20 | 0.10 | 0.70 | nenhum |
output_quality |
0.15 | nenhum | 0.40 | 0.60 |
scope_calibration |
0.12 | nenhum | 0.55 | nenhum |
progressive_disclosure |
0.10 | 0.80 | nenhum | nenhum |
token_efficiency |
0.06 | 0.40 | nenhum | 0.50 |
…
Perguntas frequentes
O que são as 'camadas' (layers)?
São diferentes métodos de avaliação: a camada 'estática' verifica a estrutura, a camada 'juiz' usa IA para julgar a qualidade, e a camada 'Monte Carlo' testa a skill com muitas simulações.
O que são 'anti-padrões'?
São erros comuns na estrutura ou descrição da skill que diminuem a nota. Exemplos incluem descrições vazias ou falta de gatilhos para a skill.
O que significam as notas e 'badges' (selos)?
A nota final vai de 0 a 100. 'Badges' como Platina, Ouro, Prata e Bronze são dados com base em faixas de notas para indicar a qualidade geral da skill.
Detalhes
Descrição original do autor
PluginEval quality methodology, covering dimensions, rubrics, and scoring formulas. Use this skill when understanding how plugin quality is measured, when interpreting a low score on a specific dimension, when deciding how to improve a skill's triggering accuracy or orchestration fitness, when setting score thresholds for your marketplace, or when explaining quality badges to external partners lik
repo: wshobson/agents
Popularidade
- Estrelas no GitHub
- 41 mil
- Posição no ranking
- #4915
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
screen-reader-testing
Faz seu agente testar sites usando leitores de tela para garantir que sejam acessíveis.
wshobson/agents
wcag-audit-patterns
Ajuda seu agente a auditar sites para acessibilidade e corrigir problemas de acordo com as diretrizes WCAG.
wshobson/agents
multi-reviewer-patterns
Faz seu agente coordenar revisões de código paralelas, deduplicando achados e consolidando relatórios.
wshobson/agents
parallel-debugging
Permite ao agente depurar problemas complexos com investigações paralelas e análise de causa raiz.
wshobson/agents
Skills parecidas
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC