Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add aliildan/arxiv-toolkit --skill literature-reviewgit clone --depth 1 https://github.com/aliildan/arxiv-toolkitWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/aliildan/arxiv-toolkit/literature-review)<a href="https://agentmods.dev/skills/aliildan/arxiv-toolkit/literature-review"><img src="https://agentmods.dev/badge/skills/aliildan/arxiv-toolkit/literature-review/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/aliildan/arxiv-toolkit/literature-review"><img src="https://agentmods.dev/badge/skills/aliildan/arxiv-toolkit/literature-review.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00068 | $0.01044 |
| Opus 5.5 | $0.00027 | $0.00418 |
| Sonnet 5.5 | $0.00014 | $0.00209 |
| Haiku 4.5 | $0.00007 | $0.00104 |
Grade A, and why
literature-review scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 59 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Literature Review (arXiv)
Overview
Turn a research topic into a synthesized, cited review: search arXiv, read a focused set of key papers in chunks, and organize findings by theme. Built on the arxiv-toolkit (arxiv-mcp tools, or the arxiv CLI as a fallback).
Core principle: narrow and synthesize. Read a right-sized set of papers well, organized by theme — not a paper-by-paper dump, and not 80 tool calls.
When to use
- "Review the literature on X" / "survey of X" / "related work for X"
- "What's the state of the art / recent advances in X?"
- Orienting in a new area, or drafting a related-work section.
Prerequisite: the arxiv-mcp server is registered (the five tools below), or the arxiv CLI is installed.
Workflow
1. Scope first — do not skip. Before any search, settle: the key terms, the likely arXiv categories (e.g. cs.CL, cs.LG — see references/arxiv-query-syntax.md), the time window, and the depth. If the request is broad, ask ONE scoping question: a quick orientation (~5 papers), a standard review (~8–12), or exhaustive? Diving in without this wastes dozens of calls.
2. Discover. arxiv_search with field scoping (category, title, abstract) and the right sort — relevance for foundational work, submittedDate for the recent frontier. Run 2–3 complementary searches (broad terms; a title-scoped pass for surveys; a recent-sorted pass). If total is large or hints fire, narrow by category/date — never blind-paginate with start.
3. Triage. arxiv_get_metadata(ids, bibtex: true) on the candidates. Rank by fit + recency. Pick a deep-read set sized to the scope (default 5–8); list the rest as "also relevant."
4. Read — targeted, not exhaustive. For each chosen paper, read the abstract, then only the sections that matter (usually method + results) via arxiv_read_paper(section=…), or maxChars + nextCursor to walk a long section. After each paper, distill to 3–5 notes (contribution, method, result, limitation) and drop the raw text. Don't read every section of every paper.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2mo ago First seen · 59 lines · 68 tokens per session scan A a63ec3e2c9c6
literature-review is a skill published in the GitHub repository aliildan/arxiv-toolkit (2 stars, last pushed 4mo ago), licensed MIT. It adds 68 tokens to every session and 1,044 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
literature-review compared with skills from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| literature-reviewaliildan/arxiv-toolkit | Skill | 2 | 4mo ago | MIT | A | 68 | Claude Code, Codex |
| instrument-data-to-allotropeanthropics/knowledge-work-plugins | Skill | 35k | 3d ago | Apache-2.0 | A | 123 | Claude Code |
| exploratory-data-analysisK-Dense-AI/scientific-agent-skills | Skill | 56k | 4d ago | MIT | A | 83 | Claude Code |
| matlabK-Dense-AI/scientific-agent-skills | Skill | 56k | 4d ago | MIT | A | 44 | Claude Code |
| phylogeneticsK-Dense-AI/scientific-agent-skills | Skill | 56k | 4d ago | MIT | A | 71 | Claude Code, Codex |
| research-engineerdavila7/claude-code-templates | Skill | 33k | yesterday | MIT | A | 43 | Claude Code, Codex |
| mapping-to-snomedmaziyarpanahi/openmed | Skill | 5.8k | yesterday | Apache-2.0 | A | 205 | Claude Code |