# paper-analysis

paper-analysis — a skill that walks you through a critical reading of a research paper using the 7-step Cornwell framework. Give it a DOI, a URL, or a local PDF and get a structured appraisal back.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/review-revise/paper-analysis/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/paper-analysis

## What it does

The analysis runs in three phases. First an aerial view: what kind of paper it is, the exact research question, the knowledge gap it fills. Then the interrogation: a methodology table rating tools, sample size, controls, data quality, code availability and reproducibility as Strong / Adequate / Weak / Unclear, plus an independent conclusion drawn from the results before reading the authors' discussion. Finally the verdict: how far the authors' claims match the data, and a list of alternative explanations or confounders.

Input handling is split two ways. A URL or DOI is fetched via `firecrawl-scrape` or `WebFetch`, falling back to `mcp__tavily__tavily-search` for a cached copy. A local `.pdf` path is parsed through the `pdf` skill. If none of those tools are wired up, feeding it a link will stall — a local PDF is the safer bet.

The author scopes it to single papers and personal study: formal journal-style reviews go to `peer-review`, multi-paper synthesis to `lit-review`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-analysis -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/paper-analysis/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/paper-analysis/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-analysis -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/paper-analysis/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-analysis -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/paper-analysis/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills review-revise/paper-analysis/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/paper-analysis/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-analysis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/paper-analysis
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/paper-analysis/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/review-revise/paper-analysis/SKILL.md

## When to use it
- rate a paper's methodology across six dimensions
- form your own conclusion before the authors frame theirs
- check whether the discussion overstates the results
- list confounding factors the study left unaddressed
- prep a critical appraisal for a journal club or seminar

## Example prompts
- Analyze this paper: 10.1038/s41586-026-00000-0
- Critically read `paper.pdf` and give me the strengths and weaknesses
- Deep dive into this study — assess the methodology and controls

## Similar
- [nature-paper-card](https://affpapa.org/en/nevibecode/skills/nature-paper-card.md) — skill · 12000 installs
- [nature-paper-xray](https://affpapa.org/en/nevibecode/skills/nature-paper-xray.md) — skill · 3100 installs
- [academic-paper-review](https://affpapa.org/en/nevibecode/skills/academic-paper-review.md) — skill · 2800 installs
- [paper-compilation](https://affpapa.org/en/nevibecode/skills/paper-compilation.md) — skill · 1700 installs
- [paper-figure](https://affpapa.org/en/nevibecode/skills/paper-figure.md) — skill · 687 installs
- [paper-writing](https://affpapa.org/en/nevibecode/skills/paper-writing.md) — skill · 619 installs

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
