Literature Overview SOP
Layer Rules
- Layer: sop — wraps MCP tools directly
- Called by: Any tactic or strategy requiring a quick literature landscape scan
- Calls: alphaxiv MCP tools, semantic-scholar MCP tools (never calls other SOPs)
Purpose
Fast landscape scan. Understand what papers exist on a topic, who the key authors are, and rough citation counts. No full-text reading. This skill is for orientation — getting a bird's-eye view before committing to deeper reading.
Use this when you need to:
- Quickly assess how much literature exists on a topic
- Identify key papers and authors in a field
- Get citation counts to gauge paper impact
- Decide which papers deserve deeper reading (via literature-search or literature-research)
Tools
| Tool |
Purpose |
Returns |
alphaxiv.discover_papers |
Semantic search for arXiv papers |
Ranked paper list with title, abstract snippet, arXiv ID |
ss.relevanceSearch |
Keyword search across all venues |
Title, abstract, authors, year, citationCount, paperId |
Tool Roles
- alphaxiv.discover_papers = primary search for arXiv-covered fields (CS, math, physics, stats, EE, quant-bio/finance)
- ss.relevanceSearch = supplementary search for non-arXiv papers (biomedical, clinical, social science, humanities)
HARD-GATE
Do NOT draw conclusions about:
- Methodology details
- Experimental results
- Specific contributions or findings
- Comparative analysis between papers
Abstracts are for ORIENTATION — identifying what exists and what looks promising.
For any substantive analysis, escalate to:
literature-search — read AI-summarized reports (medium depth)
literature-research — read raw full text (deep)
Treating abstracts as sufficient for research conclusions is PROHIBITED.
Workflow
Step 1: Search arXiv via alphaxiv
alphaxiv.discover_papers(
keywords: ["keyword1", "keyword2", "keyword3"],
question: "Detailed semantic description of desired papers",
difficulty: 3
)
Parameters:
keywords: 3-4 concise terms (method names, acronyms, authors)
question: Detailed description of what papers you're looking for
difficulty: 1-10 (use 3 for overview, higher = more retrieval effort)
Step 2: Supplement with semantic-scholar
ss.relevanceSearch(
query: "search terms",
limit: 20,
year: "2022-2024",
fields_of_study: "Computer Science"
)
Parameters:
query: keyword search string
limit: max results (default 10, max 100)
year: year range filter (e.g., "2023-2024", "2020-")
fields_of_study: field filter (optional)
min_citation_count: citation threshold (optional)
open_access_only: boolean (optional)
Step 3: Merge and Deduplicate
- Combine results from both sources
- Deduplicate by title similarity or matching arXiv IDs
- Sort by citation count (descending) as default ranking
Step 4: Return Structured Results
For each paper, present:
- Title
- Authors (first author + et al. for brevity)
- Year
- Citation Count (from ss if available)
- Abstract Snippet (first 2-3 sentences)
- Source (alphaxiv / semantic-scholar / both)
Tool-Specific Notes
alphaxiv.discover_papers
- Covers: computer science, mathematics, physics, statistics, quantitative biology/finance, electrical engineering
- Does NOT cover: biomedical, clinical, life science (PubMed, Cell, Nature)
- Returns: paper ID, title, authors, publication date, abstract snippet
difficulty parameter: 1-3 for quick scans, 5-7 for thorough discovery, 8-10 for exhaustive
ss.relevanceSearch
- Covers: all academic venues (broader than arXiv)
- Returns: title, abstract, authors, year, citationCount, paperId, externalIds
- ID formats in results: S2 ID, arXiv ID, DOI, PMID
- Rate limit: 1 req/s without API key, 100 req/s with SS_API_KEY
Example
Quick scan: "graph neural networks for drug discovery"
# Step 1: arXiv search
alphaxiv.discover_papers(
keywords: ["GNN", "drug discovery", "molecular"],
question: "Papers applying graph neural networks to drug discovery and molecular property prediction",
difficulty: 3
)
# Step 2: Supplement
ss.relevanceSearch(
query: "graph neural network drug discovery",
limit: 15,
year: "2022-2024",
min_citation_count: 50
)
# Step 3-4: Merge, deduplicate, return sorted list
Expected output: A list of 15-30 papers with titles, authors, years, and citation counts — enough to understand the landscape and pick papers for deeper reading.
Available SOPs
Optional, no fixed order; the final leaf is always a sop.
| SOP |
When to use |
| literature-research |
Deep literature research — raw full text reading and targeted PDF queries for rigorous analysis |
| literature-search |
Medium-depth literature search — read AI-summarized reports for every paper analyzed |
1---2name: literature-overview3description: Quick landscape scan — discover papers on a topic without full-text reading4---56# Literature Overview SOP78## Layer Rules9- **Layer**: sop — wraps MCP tools directly10- **Called by**: Any tactic or strategy requiring a quick literature landscape scan11- **Calls**: alphaxiv MCP tools, semantic-scholar MCP tools (never calls other SOPs)1213## Purpose1415Fast landscape scan. Understand what papers exist on a topic, who the key authors are, and rough citation counts. **No full-text reading.** This skill is for orientation — getting a bird's-eye view before committing to deeper reading.1617Use this when you need to:18- Quickly assess how much literature exists on a topic19- Identify key papers and authors in a field20- Get citation counts to gauge paper impact21- Decide which papers deserve deeper reading (via literature-search or literature-research)2223## Tools2425| Tool | Purpose | Returns |26|------|---------|---------|27| `alphaxiv.discover_papers` | Semantic search for arXiv papers | Ranked paper list with title, abstract snippet, arXiv ID |28| `ss.relevanceSearch` | Keyword search across all venues | Title, abstract, authors, year, citationCount, paperId |2930### Tool Roles31- **alphaxiv.discover_papers** = primary search for arXiv-covered fields (CS, math, physics, stats, EE, quant-bio/finance)32- **ss.relevanceSearch** = supplementary search for non-arXiv papers (biomedical, clinical, social science, humanities)3334## HARD-GATE3536<HARD-GATE>37**This skill returns abstracts and metadata ONLY.**3839Do NOT draw conclusions about:40- Methodology details41- Experimental results42- Specific contributions or findings43- Comparative analysis between papers4445Abstracts are for ORIENTATION — identifying what exists and what looks promising.4647**For any substantive analysis, escalate to:**48- `literature-search` — read AI-summarized reports (medium depth)49- `literature-research` — read raw full text (deep)5051**Treating abstracts as sufficient for research conclusions is PROHIBITED.**52</HARD-GATE>5354## Workflow5556### Step 1: Search arXiv via alphaxiv5758```59alphaxiv.discover_papers(60 keywords: ["keyword1", "keyword2", "keyword3"],61 question: "Detailed semantic description of desired papers",62 difficulty: 363)64```6566**Parameters:**67- `keywords`: 3-4 concise terms (method names, acronyms, authors)68- `question`: Detailed description of what papers you're looking for69- `difficulty`: 1-10 (use 3 for overview, higher = more retrieval effort)7071### Step 2: Supplement with semantic-scholar7273```74ss.relevanceSearch(75 query: "search terms",76 limit: 20,77 year: "2022-2024",78 fields_of_study: "Computer Science"79)80```8182**Parameters:**83- `query`: keyword search string84- `limit`: max results (default 10, max 100)85- `year`: year range filter (e.g., "2023-2024", "2020-")86- `fields_of_study`: field filter (optional)87- `min_citation_count`: citation threshold (optional)88- `open_access_only`: boolean (optional)8990### Step 3: Merge and Deduplicate9192- Combine results from both sources93- Deduplicate by title similarity or matching arXiv IDs94- Sort by citation count (descending) as default ranking9596### Step 4: Return Structured Results9798For each paper, present:99- **Title**100- **Authors** (first author + et al. for brevity)101- **Year**102- **Citation Count** (from ss if available)103- **Abstract Snippet** (first 2-3 sentences)104- **Source** (alphaxiv / semantic-scholar / both)105106## Tool-Specific Notes107108### alphaxiv.discover_papers109- Covers: computer science, mathematics, physics, statistics, quantitative biology/finance, electrical engineering110- Does NOT cover: biomedical, clinical, life science (PubMed, Cell, Nature)111- Returns: paper ID, title, authors, publication date, abstract snippet112- `difficulty` parameter: 1-3 for quick scans, 5-7 for thorough discovery, 8-10 for exhaustive113114### ss.relevanceSearch115- Covers: all academic venues (broader than arXiv)116- Returns: title, abstract, authors, year, citationCount, paperId, externalIds117- ID formats in results: S2 ID, arXiv ID, DOI, PMID118- Rate limit: 1 req/s without API key, 100 req/s with SS_API_KEY119120## Example121122**Quick scan: "graph neural networks for drug discovery"**123124```125# Step 1: arXiv search126alphaxiv.discover_papers(127 keywords: ["GNN", "drug discovery", "molecular"],128 question: "Papers applying graph neural networks to drug discovery and molecular property prediction",129 difficulty: 3130)131132# Step 2: Supplement133ss.relevanceSearch(134 query: "graph neural network drug discovery",135 limit: 15,136 year: "2022-2024",137 min_citation_count: 50138)139140# Step 3-4: Merge, deduplicate, return sorted list141```142143**Expected output:** A list of 15-30 papers with titles, authors, years, and citation counts — enough to understand the landscape and pick papers for deeper reading.144145<!-- BEGIN available-tables (generated) -->146147## Available SOPs148149Optional, no fixed order; the final leaf is always a sop.150151| SOP | When to use |152| --- | --- |153| literature-research | Deep literature research — raw full text reading and targeted PDF queries for rigorous analysis |154| literature-search | Medium-depth literature search — read AI-summarized reports for every paper analyzed |155156<!-- END available-tables (generated) -->