Subagent-Driven Literature Review
Use parallel subagents for large-scale paper screening and deep dive analysis
Install / Use
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill subagent-driven-reviewInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of Subagent-Driven Literature Review
Subagent-Driven Literature Review scores 92/100 on our quality scale, 392nd of 2,569 Development & Engineering skills we index (top 16%).
Its SKILL.md is 18 KB long, well organised into 43 sections with 24 code examples: a thorough specification that gives an agent plenty to work with.
With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 3 days ago, so Subagent-Driven Literature Review is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-09-27. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
Subagent-Driven Literature Review compared with similar skills
All 4 of these similar skills score higher than Subagent-Driven Literature Review; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| Subagent-Driven Literature Review (this skill)by brycewang-stanford | 92 | 4.4k | 3d ago | SKILL.md |
| ai-job-searchby MadsLorentzen | 100 | 44.0k | 6d ago | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 41.7k | today | CLAUDE.md |
| algorithmic-artby anthropics | 100 | 177.9k | 4d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 4d ago | SKILL.md |
Frequently asked questions
- How do I install Subagent-Driven Literature Review?
- Run
npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill "Subagent-Driven Literature Review". The install tabs above show the steps for each supported agent. - Which AI agents does Subagent-Driven Literature Review work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is Subagent-Driven Literature Review safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is Subagent-Driven Literature Review still maintained?
- The repository was last updated 3 days ago, so Subagent-Driven Literature Review is actively maintained.
Skill content
View source on GitHubname: Subagent-Driven Literature Review description: Use parallel subagents for large-scale paper screening and deep dive analysis when_to_use: Large literature searches (50+ papers), parallel paper screening, deep dive analysis on multiple papers, citation network exploration, when main context is getting full version: 1.0.0
<!-- ╔══════════════════════════════════════════════════════════════╗ ║ 本文件为开源 Skill 原始文档,收录仅供学习与研究参考 ║ ║ CoPaper.AI 收集整理 | https://copaper.ai ║ ╚══════════════════════════════════════════════════════════════╝ 来源仓库: https://github.com/kthorn/research-superpower 项目名称: research-superpower 开源协议: MIT License 收录日期: 2026-04-02 声明: 本文件版权归原作者所有。此处收录旨在为社会科学实证研究者 提供 AI Agent Skills 的集中参考。如有侵权,请联系删除。 -->Subagent-Driven Literature Review
Overview
Core principle: Fresh subagent per batch + consolidation between batches = fast parallel screening with quality control
For large literature reviews (50+ papers), dispatching parallel or sequential subagents dramatically speeds up screening while maintaining quality through consolidation checkpoints.
When to Use
Use subagent-driven approach when:
- Large searches: 50+ papers to screen
- Parallelizable work: Papers are independent, can be screened separately
- Deep dive tasks: Multiple papers need detailed extraction (data tables, methods, datasets)
- Citation exploration: Following citation networks recursively
- Context management: Main context getting full, need fresh context
- Time pressure: Need results faster than sequential screening
Do NOT use when:
- Small searches (<20 papers) - overhead not worth it
- Need real-time user visibility into every paper
- Papers require cross-comparison during screening
- Simple, fast screening tasks
Use Cases
1. Parallel Paper Screening (Most Common)
Scenario: You have 100 papers from PubMed search to screen for relevance
Pattern:
Main agent:
1. Splits 100 papers into 5 batches of 20
2. Dispatches 5 subagents IN PARALLEL (single message, multiple Task calls)
3. Each subagent:
- Fetches abstracts for its batch
- Scores using rubric
- Returns JSON with results
4. Main agent consolidates results into papers-reviewed.json
Time savings: 5x faster than sequential!
Prompt template for subagent:
I need you to screen papers 1-20 from this PMID list for relevance to [QUERY].
PMIDs to screen: [PMID list]
Use the evaluating-paper-relevance skill to:
1. Fetch abstract for each PMID
2. Score 0-10 based on:
- Keywords: [list]
- Data types needed: [measurements, protocols, datasets, etc.]
3. Return JSON:
{
"screened_papers": [
{"pmid": "12345", "score": 8, "status": "relevant", "reason": "..."},
...
],
"stats": {"highly_relevant": 3, "relevant": 5, "not_relevant": 12}
}
Do NOT update papers-reviewed.json - return results only.
**Rate limiting (CRITICAL - PubMed limits are SHARED across all parallel subagents):**
- If you are the ONLY subagent running: Use 500ms delays (2 req/sec, safe)
- If running with OTHER parallel subagents: Use longer delays to share capacity
- You are 1 of 2 parallel: Use 1 second delays
- You are 1 of 3 parallel: Use 1.5 second delays
- You are 1 of 5 parallel: Use 2.5 second delays
- If you get HTTP 429 errors: Wait 5 seconds, then use 5-second delays for remaining requests
2. Deep Dive on Priority Papers
Scenario: Initial screening identified 15 highly relevant papers, need detailed data extraction from each
Pattern:
Main agent:
1. Creates TodoWrite with 15 tasks (one per paper)
2. For each paper, dispatches subagent to:
- Fetch full text (PMC, Unpaywall)
- Extract relevant data (tables, figures, methods)
- Identify key findings
- Return structured findings
3. Main agent consolidates into SUMMARY.md
4. Reviews and adds to papers-reviewed.json
Can dispatch in parallel (5 at a time) or sequentially
Prompt template for subagent:
Deep dive analysis for paper PMID [12345] / DOI [10.xxxx/yyyy]
Use evaluating-paper-relevance skill to:
1. Check for curated data sources (if applicable to domain)
2. Fetch full text (try PMC, then Unpaywall if paywalled)
3. Extract relevant data based on research domain:
- Data tables and measurements
- Methods and protocols
- Key results and findings
- Figures with relevant information
4. Return structured JSON:
{
"pmid": "12345",
"doi": "10.xxxx/yyyy",
"full_text_source": "PMC" or "Unpaywall" or "paywalled",
"data_sources": ["Table 1", "Figure 3", "Supplementary Data"],
"key_measurements": ["specific values or ranges found"],
"methods_summary": "Brief description of methods",
"key_findings": ["Finding 1", "Finding 2", ...],
"data_availability": "GEO: GSE12345" or "Code: github.com/..." or null
}
Do NOT update papers-reviewed.json - return findings only.
3. Citation Network Exploration
Scenario: Found one highly relevant paper, need to explore forward and backward citations
Pattern:
Main agent:
1. Dispatches two subagents IN PARALLEL:
- Subagent A: Fetch and screen forward citations
- Subagent B: Fetch and screen backward citations
2. Each returns list of promising PMIDs with scores
3. Main agent:
- Consolidates results
- Removes duplicates
- Adds to screening queue
- Updates papers-reviewed.json
Prompt template for subagent:
Find and screen forward citations for PMID [12345].
Use traversing-citations skill to:
1. Fetch forward citations from PubMed or OpenCitations
2. Screen abstracts for relevance to [QUERY]
3. Score each citation (0-10)
4. Return JSON with promising papers (score ≥7):
{
"seed_pmid": "12345",
"direction": "forward",
"citations_found": 45,
"relevant_citations": [
{"pmid": "67890", "score": 8, "title": "...", "reason": "..."},
...
]
}
Do NOT update papers-reviewed.json - return results only.
4. Domain-Specific Extraction
Examples by domain:
Genomics:
Subagent extracts:
- GEO/SRA/ENA accessions
- Sample sizes and conditions
- Sequencing methods (RNA-seq, WGS, etc.)
- Analysis pipelines
- Differential expression results
Computational methods:
Subagent extracts:
- Algorithm descriptions
- Code repositories (GitHub, GitLab, etc.)
- Benchmark datasets used
- Performance metrics
- Implementation details
Clinical research:
Subagent extracts:
- Study design (RCT, cohort, etc.)
- Sample size and demographics
- Intervention details
- Primary outcomes
- Statistical methods
Ecology/Environmental:
Subagent extracts:
- Study sites and coordinates
- Sampling methods
- Species/taxa studied
- Environmental measurements
- Data repositories
Workflow: Parallel Screening
Step 1: Plan and Split
Main agent tasks:
- Load PMID list from search results
- Decide on batch size (typically 15-25 papers per subagent)
- Create TodoWrite with batches
- Prepare subagent prompts
Example TodoWrite:
- Screen papers batch 1 (PMIDs 1-20)
- Screen papers batch 2 (PMIDs 21-40)
- Screen papers batch 3 (PMIDs 41-60)
- Screen papers batch 4 (PMIDs 61-80)
- Screen papers batch 5 (PMIDs 81-100)
- Consolidate all subagent results
- Generate SUMMARY.md from consolidated data
Step 2: Dispatch Subagents
CRITICAL: Dispatch all subagents in PARALLEL using single message with multiple Task calls
Example:
I'm dispatching 5 subagents in parallel to screen 100 papers.
[Uses Task tool 5 times in single message]
Why parallel: 5x speed improvement vs sequential!
Step 3: Collect Results
Main agent:
- Wait for all subagents to complete
- Collect JSON results from each
- Validate format and completeness
Check for:
- All PMIDs were screened
- Scoring rubric was applied consistently
- No papers missing
Step 4: Consolidate
Main agent:
- Merge all subagent results
- Remove duplicates (if any overlap between batches)
- Sort by relevance score
- Add ALL papers to papers-reviewed.json:
{
"10.1234/example.2023": {
"pmid": "12345",
"status": "highly_relevant",
"score": 9,
"source": "pubmed_search_batch1",
"screened_by": "subagent",
"timestamp": "2025-10-11T14:30:00Z",
"found_data": ["measurements", "methods", "datasets"]
}
}
Mark source as "subagent" or "pubmed_search_batch1" etc.
Step 5: Review Quality
Main agent checks:
- Scoring appears consistent across batches
- No batch has dramatically different hit rate (could indicate problem)
- Highly relevant papers make sense
- Any papers needing manual re-review?
Red flags:
- One batch found 10 relevant papers, others found 0-1 (inconsistent scoring?)
- Papers marked "highly relevant" don't match keywords
- Missing expected papers
If issues found: Re-screen problematic batch manually or with fresh subagent
Step 6: Generate Summary
Main agent:
- Create SUMMARY.md with all highly relevant and relevant papers
- Sort by score
- Add statistics
- Note which papers need deep dive
Step 7: Optional Deep Dive
For highly relevant papers (score ≥8):
Option A: Dispatch subagents sequentially
For each highly relevant paper:
- Dispatch one subagent per paper
- Subagent does deep dive extraction
- Main agent consolidates findings immediately
- Updates SUMMARY.md progressively
Option B: Dispatch subagents in parallel batches
Batch 1: Papers 1-5 (dispatch 5 subagents in parallel)
Wait for completion, consolidate
Batch 2: Papers 6-10 (dispatch 5 subagents in parallel)
Wait for completion, consolidate
...
Workflow: Citation Exploration
Step 1: Identify Seed Papers
Find 2-3 highly relevant papers from initial screening
Step 2: Dispatch Citation Subagents
For each seed paper, dispatch TWO subagents in parallel:
- Forward citations (who cited this paper?)
- Backward citations (what did this paper cite?)
Prompt each subagent with:
- Seed PMID
- Relevance criteria
- Return only papers scoring ≥7
Step 3: Consolidate Citations
Main agent:
- Collects all citation results
- Removes duplicates
- Removes papers already in papers-reviewed.json
- Creates new screening queue
Step 4: Screen New Papers
Option A: Dispatch new batch screening subagents for citation results Option B: Main agent screens smaller batch manually
Step 5: Iterate
If citation exploration found many new relevant papers:
- Consider exploring citations from those papers too
- Be careful of exponential growth!
- Set stopping criteria (e.g., max 3 levels deep, max 200 total papers)
Integration with Other Skills
Works with:
- evaluating-paper-relevance: Subagents use this for individual paper screening
- traversing-citations: Subagents use this for citation exploration
- finding-open-access-papers: Subagents check Unpaywall for paywalled papers
- checking-chembl: Subagents can check curated databases (when applicable)
Combines with:
- writing-plans: Create screening plan before dispatching subagents
- TodoWrite: Track batches and consolidation progress
Consolidation Patterns
Pattern 1: JSON Aggregation
Subagents return structured JSON, main agent merges:
# Pseudo-code for consolidation
all_results = []
for subagent_output in subagent_results:
results = parse_json(subagent_output)
all_results.extend(results['screened_papers'])
# Sort by score
all_results.sort(key=lambda x: x['score'], reverse=True)
# Update papers-reviewed.json
for paper in all_results:
papers_reviewed[paper['doi']] = {
'pmid': paper['pmid'],
'status': paper['status'],
'score': paper['score'],
'source': f"subagent_batch_{paper['batch_id']}",
'timestamp': now()
}
Pattern 2: Progressive Consolidation
**Consolidate after each subagent completes (sequential d
Truncated for display — read the full file on GitHub.
Related Skills
ai-job-search
44.0kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
41.7kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
