paper-analysis — Claude Code skill for critical paper reading
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.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill paper-analysis -a claude-codeWhat paper-analysis 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.
What it helps with
- 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 for the agent
- Analyze this paper: 10.1038/s41586-026-00000-0
- Critically read
paper.pdfand give me the strengths and weaknesses - Deep dive into this study — assess the methodology and controls
How to install paper-analysis
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-analysis -a claude-code2Manually: put the files in place
~/.claude/skills/paper-analysis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/paper-analysis/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-analysis -a codex2Manually: put the files in place
.agents/skills/paper-analysis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-analysis -a cursor2Manually: put the files in place
.cursor/skills/paper-analysis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills review-revise/paper-analysis/SKILL.md2Manually: put the files in place
.github/skills/paper-analysis/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-analysis -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/paper-analysisManually: put the files in place
.devin/skills/paper-analysis/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about paper-analysis
How do I install paper-analysis in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill paper-analysis -a claude-code. The skill file lands at ~/.claude/skills/paper-analysis/SKILL.md.
What does the paper-analysis skill do?
It guides a critical read of a single research paper through the 7-step Cornwell framework: it extracts the research question, grades methodology on six dimensions, and reconciles the authors' conclusions against your own reading. The output is a structured summary table.
How is paper-analysis different from peer-review or lit-review?
paper-analysis targets personal critical reading of one paper. The author routes formal journal peer reviews to peer-review and multi-paper synthesis to lit-review.