| name | Research Pack |
| description | Use when the user wants papers, arXiv, citations, literature review, or Semantic Scholar—not general creator or product discovery. |
| version | 1.0.0 |
| category | bundled |
| primary-tools | ["web_fetch","write_file"] |
| tags | ["research","papers","citations","academic","arxiv","semantic-scholar","literature"] |
| triggers | ["arxiv","paper","citation","semantic scholar","literature review","academic","research paper","who cited","references","web_fetch","write_file"] |
Tool contract (read first)
| Step | Tool |
|---|
| Fetch arXiv / Semantic Scholar APIs | web_fetch on documented GET URLs |
| Persist bibliography / notes | write_file under work/ or projects/ |
| Present report to user | artifact_present — artifact-delivery |
| Open-web entity discovery | defer to open-web-research |
Non-negotiable: Scholarly APIs only — not creator/product discovery. On 429, back off once; avoid fan-out.
When to Use
- Scholarly workflows: papers, arXiv, Semantic Scholar, citations, literature review.
- User shares arXiv links, DOIs, or asks for related work / reference lists.
- Not for general open-web discovery (people, products, creators)—use
open-web-research.
Relation to other skills
- Open-web entity lists:
open-web-research. Delivery: artifact-delivery.
Procedure
Use web_fetch for HTTP GET. Respect rate limits (cache results; batch sparingly).
Search (Atom feed):
GET https://export.arxiv.org/api/query?search_query=all:KEYWORD&start=0&max_results=5
Replace KEYWORD — spaces → + or %20. Parse XML in the fetched text; entries contain <title>, <summary>, <id> (abs URL).
By id:
From an arxiv:YYMM.NNNNN or /abs/ URL derive id YYMM.NNNNN (or arch-ive/YYMM.NNNNNvN).
GET https://export.arxiv.org/api/query?id_list=YYMM.NNNNN
Semantic Scholar (Graph API)
Base: https://api.semanticscholar.org/graph/v1
Paper search:
GET https://api.semanticscholar.org/graph/v1/paper/search?query=QUERY&limit=5&fields=title,authors,year,url,abstract
Citations for a paper id (S2 id or DOI hash — use paperId from search results):
GET https://api.semanticscholar.org/graph/v1/paper/{paperId}/citations?limit=10&fields=title,year
References:
GET https://api.semanticscholar.org/graph/v1/paper/{paperId}/references?limit=10&fields=title,year
If 429 appears, back off and retry once with a longer delay; avoid fan-out.
Response Discipline
- Summarize papers in your own words; quote short phrases only with attribution.
- Prefer primary links (arXiv abs, publisher DOI) from API fields when present.
Pitfalls
- Fan-out on Semantic Scholar without backoff after
429.
- Conflating creator discovery with paper search.
Anti-patterns
- Using training-memory citations without fetching API results.
- Calling
open-web-research workflows for DOI/arXiv tasks.
