affaan-m/scholar-evaluation

O que scholar-evaluation faz?

Avaliação estruturada de trabalhos acadêmicos para artigos, propostas, revisões de literatura, seções de métodos, qualidade de evidências, suporte de citações e feedback de escrita científica.

Visão Geral

Esta skill fornece um framework sistemático para avaliação crítica de produções acadêmicas. Ela analisa a coerência argumentativa, a adequação metodológica, a relevância das evidências e a precisão das citações, gerando relatórios detalhados e objetivos.

Plataformas Suportadas

• Claude Code (via MCP)
• Cursor (via extensão)
• Codex CLI (via skill)
• Qualquer agente que suporte a execução de skills a partir de repositórios git

Como Usar

Uso Básico

1. Instalação: Adicione o repositório affaan-m/scholar-evaluation ao seu agente ou configure-o como uma skill no seu ambiente de desenvolvimento.
2. Entrada de Dados: Forneça o texto acadêmico que deseja avaliar, seja diretamente via prompt, seja carregando um arquivo (.md, .txt, .pdf, .docx).
3. Execução: Invoque a skill com o comando:

agent run skill affaan-m/scholar-evaluation --input path/to/document.md

Ou, se o agente suportar MCP:

mcp run affaan-m/scholar-evaluation --args '{"text": "..."}'

Parâmetros de Avaliação

Você pode personalizar a avaliação definindo critérios específicos:

• --criteria: Lista de critérios a serem avaliados (ex.: clareza,metodologia,evidencias)
• --output-format: Formato do relatório (markdown, json, html)
• --language: Idioma do relatório (pt, en, es)

Exemplo de Entrada

# Título do Artigo

## Introdução
Este estudo investiga o impacto da inteligência artificial na educação superior...

## Metodologia
Utilizamos uma abordagem mista com questionários e entrevistas semiestruturadas...

## Resultados
Os dados indicam que...

Exemplo de Saída (Trecho)

# Relatório de Avaliação Acadêmica

## Pontos Fortes
- Introdução clara e contextualizada
- Metodologia descrita com detalhes suficientes
- Citações bem integradas ao texto

## Pontos a Melhorar
- Seção de resultados carece de análise estatística
- Revisão de literatura não cobre estudos recentes (pós-2020)
- Ausência de discussão sobre limitações

## Pontuação Geral: 7.5/10

Funcionalidades

• Avaliação Multi-critério: Analisa aspectos como clareza, originalidade, rigor metodológico, qualidade das evidências e suporte de citações.
• Feedback Estruturado: Gera relatórios com seções claras e recomendações acionáveis.
• Suporte Multi-formato: Aceita entrada em Markdown, texto puro, PDF e DOCX.
• Personalizável: Permite definir critérios e formato de saída.

Contribuição

Contribuições são bem-vindas! Por favor, veja o repositório original em https://github.com/affaan-m/scholar-evaluation para mais detalhes.

Licença

Esta skill é distribuída sob a licença MIT. Consulte o arquivo LICENSE para mais informações.