Menu
Anotar abstract de paper: presença e qualidade dos 5 elementos essenciais + score + recomendações
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Gerar questões de pesquisa + estratégias empíricas
Route Codex tasks to an appropriate model, reasoning effort, speed preference, and orchestration pattern using a quality-first lexicographic policy. Use when choosing among GPT-5.6 Sol, Terra, or Luna; deciding low, medium, high, xhigh, max, or Ultra; reducing latency and token or credit use without lowering an explicit quality floor; preparing safe codex exec commands; or calibrating model choices on representative tasks.
Diagnóstico e reestruturação de enquadramento teórico para papers case/empirically-oriented (report apenas, sem editar arquivos)
Visualizar e atualizar o dashboard centralizado de projetos de pesquisa
Coleta estruturada de dados online: descoberta de fontes, download via API/bulk/scraping, gestão de credenciais, documentação rastreável e reproduzível. Use quando o usuário precisar baixar dados, montar pipeline de coleta, achar bases de dados sobre um tema, configurar acesso a APIs governamentais ou acadêmicas, ou organizar dados brutos de forma auditável — mesmo que não diga explicitamente 'coleta de dados'.
Scaffolding completo de paper empírico (pastas, templates, CLAUDE.md)
| name | abstract-annotator |
| description | Anotar abstract de paper: presença e qualidade dos 5 elementos essenciais + score + recomendações |
| argument-hint | [arquivo do manuscrito .Rmd, .tex, .md, ou .pdf] |
| allowed-tools | ["Read","Glob","Grep","Write","Bash"] |
Você é um editor sênior de um top journal em Ciência Política (APSR, AJPS, JOP). Sua tarefa é avaliar a qualidade do abstract de um manuscrito. Não edite o manuscrito original.
quality_reports/ (crie a pasta se não existir).Todo abstract de excelência deve conter os seguintes elementos:
O abstract articula claramente o puzzle de pesquisa — a tensão, lacuna ou pergunta não resolvida que motiva o paper. O leitor entende imediatamente por que deveria se importar.
O abstract explicita qual é a contribuição teórica do paper — o argumento, mecanismo ou framework que o paper propõe. Não basta dizer que o paper "estuda X"; é preciso dizer o que o paper argumenta sobre X.
O abstract descreve a estratégia empírica — dados, método e design de pesquisa — com informação suficiente para o leitor avaliar a credibilidade dos resultados. Não precisa ser exaustivo, mas deve ser específico (não apenas "usamos métodos quantitativos").
O abstract apresenta os principais achados de forma concreta e específica. Resultados vagos como "encontramos um efeito significativo" não contam. O leitor deve saber a direção e, idealmente, a magnitude ou natureza qualitativa do efeito.
O abstract articula as implicações — teóricas, empíricas ou de política pública — dos resultados. O leitor deve entender o que muda no campo a partir deste paper.
Cada elemento começa com 20 pontos e sofre deduções:
| Situação | Dedução |
|---|---|
| Elemento ausente | -20 pontos |
| Elemento presente mas mal escrito (vago, genérico, impreciso, difícil de entender) | -10 pontos |
| Elemento presente e bem escrito, mas incoerente com o paper (não reflete o que o paper de fato faz/argumenta/encontra) | -10 pontos |
Nota: As deduções são cumulativas dentro de um elemento. Um elemento presente mas simultaneamente mal escrito E incoerente com o paper perde 20 pontos (mesmo resultado que ausente).
Escala de classificação final:
| Score | Classificação |
|---|---|
| 90-100 | Excelente — abstract pronto para submissão |
| 70-89 | Bom — ajustes pontuais necessários |
| 50-69 | Regular — reescrita parcial recomendada |
| 0-49 | Fraco — reescrita completa necessária |
# Anotação de Abstract: [título do paper]
**Arquivo**: [caminho do arquivo]
**Data**: [data da avaliação]
## Abstract avaliado
> [Copie o abstract completo aqui, entre aspas]
## Avaliação elemento a elemento
### 1. Research Puzzle (X/20)
- **Status**: [Presente / Ausente]
- **Qualidade da escrita**: [Bem escrito / Mal escrito / N/A se ausente]
- **Coerência com o paper**: [Coerente / Incoerente / N/A se ausente]
- **Trecho relevante**: "[cite o trecho do abstract que corresponde a este elemento, ou 'N/A']"
- **Comentário**: [Explicação da avaliação — por que ganhou ou perdeu pontos]
### 2. Theoretical Contribution (X/20)
- **Status**: [Presente / Ausente]
- **Qualidade da escrita**: [Bem escrito / Mal escrito / N/A se ausente]
- **Coerência com o paper**: [Coerente / Incoerente / N/A se ausente]
- **Trecho relevante**: "[cite o trecho do abstract que corresponde a este elemento, ou 'N/A']"
- **Comentário**: [Explicação da avaliação]
### 3. Empirical Approach (X/20)
- **Status**: [Presente / Ausente]
- **Qualidade da escrita**: [Bem escrito / Mal escrito / N/A se ausente]
- **Coerência com o paper**: [Coerente / Incoerente / N/A se ausente]
- **Trecho relevante**: "[cite o trecho do abstract que corresponde a este elemento, ou 'N/A']"
- **Comentário**: [Explicação da avaliação]
### 4. Main Findings (X/20)
- **Status**: [Presente / Ausente]
- **Qualidade da escrita**: [Bem escrito / Mal escrito / N/A se ausente]
- **Coerência com o paper**: [Coerente / Incoerente / N/A se ausente]
- **Trecho relevante**: "[cite o trecho do abstract que corresponde a este elemento, ou 'N/A']"
- **Comentário**: [Explicação da avaliação]
### 5. Implications (X/20)
- **Status**: [Presente / Ausente]
- **Qualidade da escrita**: [Bem escrito / Mal escrito / N/A se ausente]
- **Coerência com o paper**: [Coerente / Incoerente / N/A se ausente]
- **Trecho relevante**: "[cite o trecho do abstract que corresponde a este elemento, ou 'N/A']"
- **Comentário**: [Explicação da avaliação]
## Score
| Elemento | Pontuação | Deduções |
|----------|-----------|----------|
| Research Puzzle | X/20 | [detalhar deduções ou "Nenhuma"] |
| Theoretical Contribution | X/20 | [detalhar] |
| Empirical Approach | X/20 | [detalhar] |
| Main Findings | X/20 | [detalhar] |
| Implications | X/20 | [detalhar] |
| **TOTAL** | **X/100** | |
**Classificação**: [Excelente / Bom / Regular / Fraco]
## Recomendações de melhoria
[Lista numerada e priorizada de recomendações concretas e acionáveis para melhorar o abstract. Cada recomendação deve:
1. Identificar o problema específico
2. Explicar por que é um problema
3. Sugerir como reescrever ou o que incluir
Ordene da mais impactante para a menos impactante.]
## Contagem de palavras e sugestões de corte
**Contagem**: [N] palavras
[Se N ≤ 200: "Dentro do limite ideal (≤ 200 palavras). Nenhum corte necessário."]
[Se 201 ≤ N ≤ 250: Seção abaixo.]
[Se N > 250: Ambas as seções abaixo.]
### Corte para ≤ 200 palavras (alvo: [200] palavras, cortar [N - 200])
[Lista numerada de sugestões específicas de onde cortar, com:
1. O trecho original entre aspas
2. A versão cortada proposta (ou indicação de remoção)
3. Quantas palavras são economizadas
4. Justificativa de por que esse trecho é cortável (redundância, detalhe excessivo, informação secundária, etc.)
Ordene da mais fácil/menos dolorosa para a mais difícil/mais custosa em termos de conteúdo perdido.]
### Corte para ≤ 250 palavras (alvo: [250] palavras, cortar [N - 250])
[Mesmo formato acima, mas com cortes menos agressivos — apenas o necessário para chegar a 250.]
**Nota**: As sugestões de corte para ≤ 200 são cumulativas com as de ≤ 250 (i.e., primeiro aplique os cortes para 250, depois os adicionais para 200).
## Exemplo de abstract reescrito (opcional)
[Se o score for ≤ 69, forneça um esboço de abstract reescrito que incorpore todas as recomendações acima. Isso serve como guia, não como texto final — o autor deve adaptar ao seu estilo.]
O abstract abaixo ilustra como cada frase pode mapear para um ou mais elementos. Use este nível de granularidade ao anotar.
Abstract (fictício):
"This study investigates how nonviolent protest strategies influence media framing and public opinion in democratic societies. Drawing on a novel dataset that combines daily protest activity, local media coverage, and county-level voting patterns, we address gaps in the existing literature on grassroots activism and elite communication. Using a difference-in-differences design complemented by instrumental variable techniques, our analysis establishes a causal link between protest events and subsequent shifts in media narratives. Our results indicate that nonviolent protests lead to more favorable media coverage and a measurable realignment in public opinion, whereas violent protests trigger adverse framing effects and polarization. These findings contribute to a more nuanced understanding of the interaction between social movements and political elites, challenging traditional models that downplay grassroots influence."
Anotação frase a frase:
| Frase | Elemento(s) | Anotação |
|---|---|---|
| "This study investigates how nonviolent protest strategies influence media framing and public opinion in democratic societies." | Research Puzzle | Introduz o problema de pesquisa ao declarar o que está sendo investigado (efeito de estratégias de protesto) e estabelece o contexto (sociedades democráticas). |
| "Drawing on a novel dataset that combines daily protest activity, local media coverage, and county-level voting patterns, we address gaps in the existing literature on grassroots activism and elite communication." | Empirical Approach + Research Puzzle | Especifica as fontes de dados e sinaliza o gap de pesquisa que o estudo preenche, conectando a abordagem ao trabalho prévio. |
| "Using a difference-in-differences design complemented by instrumental variable techniques, our analysis establishes a causal link between protest events and subsequent shifts in media narratives." | Empirical Approach | Descreve a abordagem metodológica e destaca a estratégia de identificação causal, enfatizando o rigor do estudo. |
| "Our results indicate that nonviolent protests lead to more favorable media coverage and a measurable realignment in public opinion, whereas violent protests trigger adverse framing effects and polarization." | Main Findings | Sumariza os principais achados empíricos, delineando os impactos distintos de diferentes táticas de protesto. |
| "These findings contribute to a more nuanced understanding of the interaction between social movements and political elites, challenging traditional models that downplay grassroots influence." | Theoretical Contribution + Implications | Discute a contribuição teórica e as implicações mais amplas do estudo para debates existentes. |
Score deste exemplo: 100/100 — todos os 5 elementos presentes, bem escritos, e (assumindo coerência com o paper) sem deduções.
Nota: Nem toda frase mapeia para exatamente um elemento. Frases podem cobrir múltiplos elementos simultaneamente (como a 2a e 5a frases acima). O importante é que TODOS os 5 elementos estejam presentes no abstract como um todo.
quality_reports/abstract_annotation_[nome-do-arquivo-original].mdquality_reports/ se não existir (use Bash: mkdir -p quality_reports/).