analyzing-research-papers — Claude Code skill: how to install
Structured framework for reviewing research papers from PDFs, DOIs, or arXiv links. Extracts core contributions, tests reproducibility, and spots methodological flaws.
npx skills add seabbs/skills --skill analyzing-research-papers -a claude-codeWhat analyzing-research-papers does
This skill guides an AI agent through a systematic review of academic papers. It processes local files in PDF or Markdown, paper DOIs, and direct links to arXiv, bioRxiv, or medRxiv. When a paper is locked behind a paywall, the skill instructs the assistant to pull the public abstract and metadata while explicitly noting access boundaries.
The workflow starts by classifying the work into theoretical, methodological, empirical, or review categories. From there, it isolates the main thesis, experimental baseline, metrics, and dataset properties. The assessment flags whether researchers shared code, seeds, and hyperparameters, or left out critical implementation details.
If a paper lacks open datasets or hides parameters behind brevity claims, the analysis logs low reproducibility directly rather than filling gaps with guesswork.
What it helps with
- extract key contributions and statistical results from papers
- evaluate research methodology and stated assumptions
- audit code availability and experiment reproducibility
- summarize academic papers from DOI or arXiv URLs
Example prompts for the agent
- Analyze the paper at
https://arxiv.org/pdf/2301.12345.pdfand list its main methodological limitations - Review
./papers/smith2024.pdfand check its reproducibility based on shared code and parameters - Extract key claims and statistical evidence from DOI
10.1234/journal.2024.12345
How to install analyzing-research-papers
1Skills CLI (Vercel)
npx skills add seabbs/skills --skill analyzing-research-papers -a claude-code2Manually: put the files in place
~/.claude/skills/analyzing-research-papers/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/analyzing-research-papers/
1Skills CLI (Vercel)
npx skills add seabbs/skills --skill analyzing-research-papers -a codex2Manually: put the files in place
.agents/skills/analyzing-research-papers/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add seabbs/skills --skill analyzing-research-papers -a cursor2Manually: put the files in place
.cursor/skills/analyzing-research-papers/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install seabbs/skills analyzing-research-papers2Manually: put the files in place
.github/skills/analyzing-research-papers/SKILL.md1Skills CLI (Vercel)
npx skills add seabbs/skills --skill analyzing-research-papers -a gemini-cli2Platform CLI
gemini skills install https://github.com/seabbs/skills --path plugins/research-academic/skills/analyzing-research-papersManually: put the files in place
.devin/skills/analyzing-research-papers/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add seabbs/skills --skill analyzing-research-papers -a opencodeClaude.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 analyzing-research-papers
How to install analyzing-research-papers in Claude Code?
Run npx skills add seabbs/skills --skill analyzing-research-papers -a claude-code. This installs the skill file to ~/.claude/skills/analyzing-research-papers/SKILL.md.
What does analyzing-research-papers do?
It gives your coding agent a structured framework to categorize papers, extract claims, and evaluate experimental validity alongside reproducibility indicators.
How does the skill handle paywalled papers?
It extracts public metadata and abstracts, marks the limitations in the summary report, and suggests searching for open-access alternatives.
Source text
SKILL.md · MIT
---
name: analyzing-research-papers
description: Expert methodology for analyzing and summarizing research papers, extracting key contributions, methodological details, and contextualizing findings. Use when reading papers from PDFs, DOIs, or URLs to create structured summaries for researchers.
---
# Analyzing Research Papers
This skill provides expertise in systematically analyzing research papers to extract key insights, evaluate methodological rigour, and contextualize findings for researchers.
## Paper Access Methods
### Input Formats Accepted
**Local files:**
- Absolute paths: `/path/to/paper.pdf`
- Relative paths: `./papers/smith2024.pdf`
- Markdown files: `paper.md`
**DOIs:**
- Standard format: `10.1234/journal.2024.12345`
- With prefix: `doi:10.1234/journal.2024.12345`
- Resolve using: `https://doi.org/{doi}`
**URLs:**
- ArXiv: `https://arxiv.org/pdf/2301.12345.pdf`
- Journal websites: Direct PDF or HTML links
- Preprint servers: bioRxiv, medRxiv, etc.
### Handling Access Issues
**Paywalled content:**
- Work with available abstract and metadata
- Extract what's publicly accessible
- Note limitations in summary
- Suggest open access alternatives
**PDF reading failures:**
- Request text version if available
- Try alternative formats (HTML, arXiv)
- Extract from DOI metadata
## Analysis Framework
### Initial Scan
**Identify paper structure:**
- Abstract and key claims
- Section organization (IMRaD vs custom)
- Figures and tables overview
- Reference density and key citations
**Classify paper type:**
- Theory: Proofs, mathematical foundations, formal results
- Methods: New algorithms, techniques, computational approaches
- Application: Domain-specific use cases, case studies
- Review: Surveys, systematic reviews, meta-analyses
- Empirical: Experimental results, observations, measurements
### Content Extraction Priorities
**Must extract:**
1. Main contribution(s) and claims
2. Methodological approach and assumptions
3. Key results with statistical evidence
4. Limitations acknowledged
5. Related work positioning
**Important to capture:**
- Experimental setup and validation
- Implementation details
- Performance metrics and comparisons
- Dataset characteristics
- Reproducibility information
**Nice to have:**
- Future work suggestions
- Broader implications
- Alternative approaches considered
- Failure modes discussed
## Quality Assessment Criteria
### Methodological Rigour
**Strong indicators:**
- Clear research questions
- Appropriate methodology for questions
- Controlled comparisons
- Statistical significance properly assessed
- Limitations openly discussed
- Assumptions explicitly stated
**Weak indicators:**
- Vague objectives
- Methodology not justified
- Cherry-picked results
- Over-claiming based on limited evidence
- Ignoring contrary evidence
- Unacknowledged assumptions
### Reproducibility Assessment
**High reproducibility:**
- Code publicly available
- Data accessible or well-described
- Implementation details complete
- Hyperparameters specified
- Random seeds provided
- Environment documented
**Low reproducibility:**
- "Implementation details omitted for brevity"
- No code or data shared
- Vague parameter descriptions
- Critical details missing
- Non-standard methods without explanation
### Impact Potential
**High impact indicators:**
- Addresses important problem
- Novel approach or insight
- Strong empirical results
- Generalizable beyond specific case
- Clear practical applications
- Challenges existing assumptions
**Limited impact indicators:**
- Incremental improvement
- Narrow applicability
- Limited novelty
- Weak empirical support
- Unclear practical value
## Analysis Structure
### Overview Section
**Synthesize (2-3 paragraphs):**
- What problem does this address?
- What's the main contribution?
- What's the key finding or result?
- Why does this matter?
### Highlights (Bullet Points)
**Extract:**
- Most important findings
- Key methodological innovations
- Surprising or counter-intuitive results
- Practical implications
- Limitations to be aware of
### Strengths Assessment
**Methodological strengths:**
- Rigorous experimental design
- Appropriate statistical analysis
- Comprehensive evaluation
- Clear presentation
**Impact strengths:**
- Novel contributions
- Practical applicability
- Theoretical insights
- Reproducibility support
### Weaknesses Assessment
**Be specific and fair:**
- Methodological limitations
- Scope constraints
- Unclear explanations
- Missing comparisons
- Reproducibility concerns
- Over-claims not supported by evidence
**Distinguish:**
- Fundamental flaws (invalidate conclusions)
- Important limitations (affect interpretation)
- Minor issues (don't affect main findings)
## Section-by-Section Analysis
### Introduction
**Extract:**
- Problem motivation and importance
- Research gap being addressed
- Main research questions
- Contributions claimed
- Paper organization
**Assess:**
- Is motivation convincing?
- Is gap clearly identified?
- Are claims appropriately scoped?
### Methods/Approach
**Extract:**
- Core methodology or algorithm
- Key design decisions and rationale
- Assumptions made (explicit and implicit)
- Implementation details
- Parameters and configurations
**Assess:**
- Is approach well-justified?
- Are assumptions reasonable?
- Is description complete enough to reproduce?
- Are limitations acknowledged?
### Results/Experiments
**Extract:**
- Experimental setup
- Datasets or scenarios used
- Metrics and evaluation criteria
- Main findings with numbers
- Statistical significance
- Comparison with baselines
**Assess:**
- Are experiments well-designed?
- Are comparisons fair?
- Are results presented clearly?
- Is statistical analysis appropriate?
- Are claims supported by evidence?
### Discussion/Conclusion
**Extract:**
- Interpretation of results
- Broader implications
- Limitations discussed
- Future work suggested
- Take-home messages
**Assess:**
- Are interpretations justified?
- Are limitations honestly addressed?
- Are broader claims supported?
## Technical Detail Extraction
### For Methods Papers
**Capture:**
- Algorithm pseudocode or description
- Computational complexity
- Key equations and formulations
- Implementation strategies
- Performance characteristics
### For Theory Papers
**Capture:**
- Main theorems and proofs structure
- Assumptions and their necessity
- Formal definitions
- Theoretical guarantees
- Connections to prior work
### For Application Papers
**Capture:**
- Domain context and requirements
- Data characteristics
- Specific challenges addressed
- Real-world constraints
- Practical validation
### For Review Papers
**Capture:**
- Taxonomy or classification used
- Coverage scope
- Trends identified
- Gaps in literature
- Research directions suggested
## Related Work Contextualization
### Positioning
**Identify:**
- Key related papers cited
- How this work differs
- What gaps it fills
- Which results it extends
- Where it fits in research trajectory
**Assess:**
- Is related work coverage adequate?
- Are comparisons fair?
- Are important works cited?
- Is novelty clearly established?
## Output Format Template
```markdown
# Paper Summary: [Title]
**Authors**: [All authors]
**Year**: [Year]
**Venue**: [Journal/Conference]
**DOI/URL**: [Link]
## Overview
[2-3 paragraph synthesis]
## Highlights
- [Finding 1]
- [Finding 2]
- [Finding 3]
## Strengths
- [Strength 1]
- [Strength 2]
## Weaknesses
- [Limitation 1]
- [Concern 2]
## Detailed Summary
### Introduction
[Problem, gap, contributions]
### Methods
[Approach, algorithms, assumptions]
### Results
[Findings, metrics, comparisons]
### Discussion
[Interpretation, implications]
## Technical Details
[Implementation specifics, equations, parameters]
## Related Work Context
[How this fits in the literature]
## Potential Applications
[Practical uses]
## Reproducibility Notes
[Code, data, reproducibility assessment]
```
## Special Considerations by Field
### Machine Learning/AI
- Architecture details and hyperparameters
- Training procedures and convergence
- Dataset characteristics and splits
- Ablation studies
- Computational requirements
- Generalization evidence
### Statistics/Biostatistics
- Model specification and assumptions
- Prior choices and justification
- Identifiability and inference
- Sensitivity analyses
- Missing data handling
- Validation approach
### Epidemiology/Public Health
- Study design and population
- Exposure and outcome definitions
- Confounding adjustment
- Causal interpretation
- Generalizability
- Public health implications
### Computational Biology
- Biological context and motivation
- Data sources and preprocessing
- Validation with known biology
- Biological interpretation
- Reproducibility with data/code
## When to Use This Skill
Apply this analysis approach when:
- Reading papers for literature review
- Evaluating methods for adoption
- Assessing novelty for research direction
- Extracting technical details for implementation
- Preparing paper summaries for team
- Reviewing papers for journal/conference
- Building bibliography with annotations
Extract insights efficiently whilst maintaining critical assessment.
Provide researchers with actionable understanding of papers' contributions and relevance.
© seabbs · MIT · seabbs/skills