К основному содержанию
скилл CX Codex

review-paper-light — скилл Claude Code для проверки научной статьи

Скилл review-paper-light для Claude Code проверяет экономическую статью перед отправкой в журнал: оценивает вклад, идентификацию и причинные выводы за минуту.

MIT ★ 579 обновлён 2026-10-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add claesbackman/AI-research-feedback --skill review-paper-light -a claude-code
Открыть на GitHub

Что делает review-paper-light

Скилл запускает две независимые проверки параллельно. Первый агент оценивает научный вклад статьи, определяет, как авторы опознают свой результат, и выясняет, есть ли критические лакуны в анализе — всё в логике редактора топ-журнала. Второй следит за переговорами: флагит каждое место, где авторы выдают корреляцию за причину, выдают гипотезу за факт или обобщают выводы за пределы данных.

Скилл автоматически находит основной .tex файл проекта, собирает полный граф включений (все подключённые через \input{}, \include{}, \subfile{}), и пропускает только его — игнорирует черновики, письма редакторам, слайды и старые версии. Результат — приоритизированный отчёт с конкретными вопросами авторам и рекомендацией (отправить рецензентам, доработать или отклонить сразу).

Какие задачи решает

  • проверить научный вклад статьи перед отправкой
  • выявить причинные переговоры и неподкреплённые заявления
  • найти недостающие анализы, которые блокируют публикацию
  • получить список конкретных вопросов для авторов

Примеры запросов агенту

  • Проверь вклад и идентификацию основной статьи
  • Запусти быструю проверку файла paper/main.tex перед сдачей в журнал
  • Сделай предварительную оценку статьи: есть ли причинные переговоры и что не хватает

Как установить review-paper-light

1Через Skills CLI (Vercel)

npx skills add claesbackman/AI-research-feedback --skill review-paper-light -a claude-code

2Вручную: положить файлы

~/.claude/skills/review-paper-light/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/review-paper-light/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о review-paper-light

Как установить review-paper-light в Claude Code?

Выполни npx skills add claesbackman/AI-research-feedback --skill review-paper-light -a claude-code, затем открой ~/.claude/skills/review-paper-light/SKILL.md.

Что делает review-paper-light?

Запускает две агентские проверки параллельно: одна оценивает научный вклад и идентификацию, вторая ловит причинные переговоры и преувеличения. На выходе — отчёт с рекомендацией отправить в рецензию, доработать или отклонить.

Какой файл нужно передать скиллу?

Опционально путь к основному .tex файлу. Если не указать, скилл сам найдёт его по \documentclass или \begin{document} и соберёт весь граф включений.

Исходный текст

SKILL.md · MIT
---
name: review-paper-light
description: Run a fast 2-agent pre-submission check for an economics paper — focuses on contribution, identification, and causal overclaiming. Completes in ~1 minute.
argument-hint: [optional: path/to/main.tex]
allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Agent
disable-model-invocation: true
---

You are coordinating a fast pre-submission check of an economics paper. You will run 2 agents in parallel and consolidate their output into a short, prioritized report.

## Phase 1: Discover the Paper

If a file path is provided in `$ARGUMENTS`, use it as the main LaTeX file. Otherwise, auto-detect:

1. Use Glob with pattern `**/*.tex` to list all .tex files (exclude `_minted-*`, `build/`, `output/`).
2. Identify the main document among the .tex files containing `\documentclass` or `\begin{document}`. If several candidates match, discard beamer slides and files whose name or folder suggests an old draft or a response letter (`response*`, `letter*`, `slides*`, `old*`, `archive/`, etc.), then choose the candidate with the largest include-graph. If still ambiguous, ask the user.
3. Read the main file and extract all `\input{}`, `\include{}`, and `\subfile{}` references (recursively) to build the paper's include-graph.
4. Read all component .tex files. **The file list passed to the agents is exactly the main file plus its include-graph** — do not pass .tex files the paper does not include (old drafts, response letters, slides, notes).
5. Use Glob to find table files: `**/Tables/**/*.tex`, `**/tables/**/*.tex`, root-level `*table*.tex`. Keep only tables that are `\input{}`/`\include{}`d from the include-graph.

Record:
- Full path of each .tex file
- Paper title, authors, and abstract

## Phase 2: Launch 2 Agents in Parallel

In a **single message**, launch both agents using the Agent tool with `subagent_type: "general-purpose"`.

**Scope guard — prepend the following block verbatim to both agents' prompts:**

> Review ONLY the files listed at the end of this prompt. Do not use Glob, Grep, or directory listings to discover other files, and do not open any file that is not on the list. In particular, ignore any previous review reports (`QUICK_REVIEW_*.md`, `PRE_SUBMISSION_REVIEW_*.md`, anything in a `reviews/` folder), referee reports, response letters, notes, README files, and old drafts — none of these may influence your review. Within the listed .tex files, treat `%`-commented-out lines and `\todo{}` content as if they do not exist: review only the live text of the paper.

---

### AGENT A — Contribution, Identification & Required Analyses

You are a demanding associate editor at a top economics journal. Read all .tex files completely. Produce a focused evaluation of whether this paper is worth sending to referees.

**Part 1 — The Central Contribution**

- State in one sentence what the paper claims to contribute, in the authors' own framing.
- Classify the contribution type(s) — more than one may apply: new question, new data, new method, new setting, or new answer to an old question.
- From the paper's own bibliography and literature review, identify the 2–3 closest prior papers. For each, state in one sentence what this paper adds beyond it, grounded in what the results actually deliver. Do not rely on your general knowledge of the literature to assert what does or does not exist. If you draw on knowledge beyond the paper's bibliography, label the claim `[UNVERIFIED — authors must confirm]` and never invent citation details.
- Does the framing overstate? Does the introduction promise more than the results deliver?
- Rate the contribution: [Transformative | Significant | Incremental | Insufficient for a top field journal]
- Justify in 2–3 sentences, noting that novelty relative to uncited literature is not verified.

**Part 2 — Identification and Credibility**

- What variation does the paper use to identify its main result?
- Is this variation plausibly exogenous? What are the main threats?
- Does the paper adequately address these threats?
- Is the main finding causal, correlational, or descriptive? Does the paper claim the right thing?
- What would a skeptical econometrician at a seminar say?

**Part 3 — Required Analyses**

List up to 5 analyses whose absence is a blocker for acceptance. For each: state what it is, why its absence undermines credibility, and what a positive result would do for your view. If nothing is missing, write "None — the paper adequately addresses the main concerns."

Tag each required analysis `[CRITICAL]`.

**Part 4 — Pointed Questions to the Authors**

Write 3–5 specific, pointed questions that get at the paper's weakest points. Frame them as a referee would.

**Part 5 — Preliminary Recommendation**

Based on Parts 1–3, state exactly one of: [Send to referees | Revise before sending to referees | Desk reject], with one sentence of justification.

**Output format:**

```
## Agent A: Contribution & Identification

### Part 1 — Central Contribution
[assessment + rating]

### Part 2 — Identification and Credibility
[assessment]

### Part 3 — Required Analyses
[numbered list: [CRITICAL] Analysis | Why absence matters | What a positive result would do]

### Part 4 — Questions to the Authors
[numbered list of 3–5 questions]

### Part 5 — Preliminary Recommendation
[one of: Send to referees | Revise before sending to referees | Desk reject — with one sentence of justification]
```

The .tex files to review are: [LIST ALL TEX FILE PATHS HERE]

---

### AGENT B — Causal Overclaiming & Unsupported Claims

You are a skeptical econometrician enforcing "claim discipline." Read all .tex files and flag every place where the paper overstates its evidence.

**What to check:**

1. **Causal language without causal identification**: Flag every specific sentence where causal language ("causes", "leads to", "drives", "determines", "because of", "due to", "results in") is applied to the main findings without genuine causal identification. Quote the exact sentence and explain why the language exceeds what the identification supports.

2. **Mechanism claims stated as facts**: When the paper explains *why* a result holds, flag every instance where a proposed mechanism is asserted rather than framed as a hypothesis.

3. **Generalization beyond the sample**: Claims that extend findings beyond the data's scope without adequate caveats (e.g., claiming broad policy implications from a single country; claiming current relevance for historical results without acknowledging context changes).

4. **Missing caveats**: Places where a reader would naturally ask "but what about...?" and the paper doesn't address it. Focus on the most obvious threats to internal validity for the specific research design: selection, reverse causality, measurement error, omitted variables.

5. **Statistical vs. economic significance**: Places where statistical significance is reported but economic significance is not discussed, or where "significant" is used as if it means "important."

6. **Unverified priority assertions**: "No prior study has examined X" or "We are the first to show Y" — flag every such claim. Authors must verify before submission.

Tag every issue `[CRITICAL]`, `[MAJOR]`, or `[MINOR]`.

**Output format:**

```
## Agent B: Causal Overclaiming & Unsupported Claims

### Causal Overclaiming
[numbered list: [CRITICAL] or [MAJOR] Section | "Exact quoted text" | Why it overclaims | Fix]

### Mechanism Claims Stated as Facts
[numbered list: [MAJOR] or [MINOR] same format]

### Missing Caveats
[numbered list: [CRITICAL] or [MAJOR] Topic | Where to address it | Suggested fix]

### Other Issues
[numbered list: [MAJOR] or [MINOR] same format]
```

The .tex files to review are: [LIST ALL TEX FILE PATHS HERE]

---

## Phase 3: Consolidate and Save

After both agents return, consolidate into a single report.

Save the report inside a `reviews/` subfolder of the paper's directory (create it if it does not exist) — keeping reports out of the paper's root directory prevents them from being picked up by future runs of this skill.

Check whether `reviews/QUICK_REVIEW_[YYYY-MM-DD].md` already exists. If so, append `-v2` (or `-v3`, etc.).

Save to: `reviews/QUICK_REVIEW_[YYYY-MM-DD].md`

**Report structure:**

```markdown
# Quick Pre-Submission Check

**Paper**: [Title]
**Authors**: [Authors]
**Date**: [Today's date]

---

## Overall Assessment

[2–3 sentences: (1) what the paper does; (2) contribution rating from Agent A; (3) the single most pressing issue from the Priority Items below.]

**Preliminary Recommendation**: [Copy exactly from Agent A Part 5 — do not paraphrase]

---

## 1. Contribution & Identification

[Agent A output]

---

## 2. Causal Overclaiming & Unsupported Claims

[Agent B output]

---

## Priority Action Items

Collect all tagged items and rank: `[CRITICAL]` first (identification and causal overclaiming items before others), then `[MAJOR]`, then `[MINOR]`.

**CRITICAL** (could cause desk rejection or major objections):
1. ...

**MAJOR** (will likely be raised by referees):
4. ...

**MINOR** (polish):
8. ...
```

After saving, report to the user:
1. Path to the saved report
2. Preliminary recommendation
3. Top 3 priority action items
4. Issue counts by severity

© claesbackman · MIT · claesbackman/AI-research-feedback

Похожие скиллы

Все скиллы по теме «Наука и исследования» →
paper-self-review Galaxy-Dawn Скилл paper-self-review для Claude Code проверяет структуру научной статьи, логику выводов и соответствие утверждений доказательствам. Включается при самопроверке перед отправкой в журнал или на конференцию. CX Codex +1 702установок review-paper-2 franklee16 Скилл review-paper-2 имитирует жёсткое рецензирование научной рукописи в стиле журналов по экономике перед отправкой в редакцию. Помогает найти слабые места в доказательствах и гипотезах. CX Codex +1 ★ 240звёзд репо academic-paper-writer Awesome Econ AI Community Скилл academic-paper-writer для Claude Code помогает оформлять научные статьи по экономике по структуре IMRAD. Он формирует шаблоны разделов и таблицы в формате LaTeX. CX Codex +1 522установок ccf-paper-reviewer mikubaka88 Скилл ccf-paper-reviewer для Claude Code проверяет научные рукописи, помогая оценить обоснованность утверждений, доказательства и качество текста перед публикацией. CX Codex +1 2 300установок research-writing-skill zLanqing Скилл research-writing-skill помогает писать и редактировать научные статьи, диссертации и ответы рецензентам на китайском и английском языках в Markdown и LaTeX. CX Codex +1 979установок pre-submission-reviewer HKUSTDial Скилл pre-submission-reviewer проверяет научную статью по пяти направлениям: логика, текст, грамматика, LaTeX, рисунки. Отдаёт список замечаний с приоритетами — пригодится за несколько дней до дедлайна. CX Codex +1 931установок

Из того же набора13

Весь набор →
audit-analysis Скилл audit-analysis запускает отдельного субагента, который враждебно проверяет изменённый код эмпирического анализа против базовой ветки и ищет ошибки до того, как их найдёт рецензент. CX Codex +1 ★ 579звёзд репо pdf-to-markdown Скилл pdf-to-markdown разбивает PDF на части и переводит документ в Markdown, убирая библиографию и приложения. CX Codex +1 ★ 579звёзд репо explain-diff Скилл explain-diff превращает разбор изменений кода в автономную HTML-страницу с викториной. Он пригодится, когда нужно объяснить diff и проверить, как он влияет на эмпирические результаты. CX Codex +1 ★ 579звёзд репо review-paper-code Скилл review-paper-code проверяет воспроизводимость расчётов в научных статьях на LaTeX с кодом на Stata, R или Python и сверяет эмпирические выводы с кодовой базой. CX Codex +1 ★ 579звёзд репо explorable-deck Скилл explorable-deck для Claude Code создаёт презентации Quarto на reveal.js: последовательный рассказ и наглядные сцены под управлением докладчика. Задачи — лекции, конференции и разбор научных статей. CX Codex +1 ★ 579звёзд репо explorable-beamer Скилл explorable-beamer собирает PDF-презентации Beamer в explorable-стиле Ники Кейс: одна мысль на кадр, живой пример, раскрывающиеся стадии TikZ и appendix с ответвлениями. CX Codex +1 ★ 579звёзд репо explorable-pptx Скилл explorable-pptx создаёт презентации PowerPoint в стиле объяснительных моделей с заметками к каждому слайду и проверкой скриншотов. CX Codex +1 ★ 579звёзд репо paper-version Скилл paper-version для Claude Code преобразует LaTeX-статью в краткую версию для широкой аудитории и готовит HTML-страницу. Объясняет результаты исследования без академического жаргона. CX Codex +1 ★ 579звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой