Pular para o conteúdo
Skillpedia
Agentes41 mil · #4915

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

https://github.com/wshobson/agents/blob/main/plugins/plugin-eval/skills/evaluation-methodology/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/wshobson/agents/blob/main/plugins/plugin-eval/skills/evaluation-methodology/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
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-methodology

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/wshobson/agents/main/plugins/plugin-eval/skills/evaluation-methodology/SKILL.md -o SKILL.md
Conteú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 (alimenta triggering_accuracy)
  • orchestration_wiring (alimenta orchestration_fitness)
  • progressive_disclosure, structural_completeness, token_efficiency, ecosystem_coherence
  • harness_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_fitness e scope_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

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas