Menu
Anotar abstract de paper: presença e qualidade dos 5 elementos essenciais + score + recomendações
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
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/).