Agent skill

Academic Search and Citation Router

by Yuan1z0825 in Yuan1z0825/nature-skills

Finds papers across literature sources, verifies and converts citations, builds MeSH strategies and audits independent citations of a paper.

Apache-2.0Auto-check passedResearch & Science

Install Academic Search and Citation Router

skills CLI
$ npx skills add Yuan1z0825/nature-skills --skill nature-academic-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Yuan1z0825/nature-skills nature-academic-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Yuan1z0825/nature-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nature-academic-search .claude/skills/nature-academic-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nature-academic-search
GitHub stars
47k
Token cost
~884 tokens
SKILL.md length
399 words
Files
60 (incl. scripts, references)
Skills in repo
23
Repo updated
First seen
Licence
Apache-2.0

At a glance

Finds papers across literature sources, verifies and converts citations, builds MeSH strategies and audits independent citations of a paper.

  • Works in 5 steps: Load the manifest and the core layer → Detect the workflow → Load the matching workflow fragment(s) → …
  • Finding papers on a topic across several literature sources
  • Runs Python and Shell scripts from its folder
  • Checking that the references in a manuscript are real and correct

What it does

This skill acts as a router for academic search work. It reads a manifest, loads the core tool and routing notes, works out which of six workflows your request needs and states them in one line, and then loads only the matching workflow file instead of everything.

The workflows are multi-source literature search, verification of citations pulled from a document, MeSH and PubMed search strategy, conversion of .nbib, .ris and .bib files, reference management such as BibTeX, related-article discovery and ID conversion, and a strict independent-citation audit that builds article-level citation tables and finds high-profile citers and how they cited the paper.

Source retrieval goes through an MCP server bundled with the skill, using a tiered fallback chain across sources. Converting local citation files whose records are already complete works offline and skips source setup. The skill does not translate papers or draft manuscript text.

When your agent uses it

  • Finding papers on a topic across several literature sources
  • Checking that the references in a manuscript are real and correct
  • Building a MeSH-based PubMed search strategy
  • Converting between .nbib, .ris and .bib citation files
  • Auditing who independently cited a published paper

Example prompts

  • “Search arXiv and PubMed for recent work on single-cell foundation models.”
  • “Verify every reference in ./draft/references.md and flag any that do not resolve.”
  • “Convert exports.ris to BibTeX and remove duplicate records.”
  • “Build a MeSH search strategy for sleep apnea and cardiovascular outcomes.”

Requirements

  • Python environment for the bundled MCP server
  • Network access to the literature sources, except for offline file conversion

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Load the manifest and the core layer
  2. Detect the workflow
  3. Load the matching workflow fragment(s)
  4. Run the workflow using the loaded material
  5. Reach for references only when needed

What it can do on your machine

Read from SKILL.md and the folder at commit e605b35. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python and Shell, from the files we listed), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Academic Search and Citation Router loads about 884 tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 399 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~884
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Yuan1z0825/nature-skills at commit e605b35, republished under its Apache-2.0 licence (© Yuan1z0825). 399 words, ~884 tokens.

Download SKILL.mdSave it as .claude/skills/nature-academic-search/SKILL.md (or your agent's skills folder). This skill also uses 59 other files; get the full folder from GitHub.
name
nature-academic-search
description
Search literature across sources, verify or manage citations, and build MeSH strategies or citation-impact audits. Use for 文献检索、引文核对、参考文献管理、严格他引 and evidence-backed citer profiles; not for translating a paper or drafting manuscript prose.

Academic Search — Router

Routing protocol

For local citation-file conversion with complete supplied records, load references/workflows/wf4-citation-file-mgmt.md and its format reference directly. Source lookup, API setup, and network preflight apply only when retrieval or verification is needed; do not require them for a requested offline conversion.

For a new task, load the core and matching resources below. Reuse already loaded guidance on follow-ups; load more only when the task needs it.

1. Load the manifest and the core layer

Read manifest.yaml. It declares the workflow axis, the allowed values, and the file paths each value maps to.

Also read every file listed under always_load:

  • static/core/tools.md — the MCP tool inventory (core search, extended search, PubMed utilities) and the shared-module map.
  • static/core/routing-and-ops.md — the T1→T2→T3 source routing quick guide, environment setup, error handling, and limitations.
2. Detect the workflow

Map the user's need to one or more workflow values:

  • multi-source-search — find literature across sources.
  • citation-verification — verify citations extracted from a document.
  • mesh-strategy — build a MeSH/PubMed search strategy.
  • citation-file-mgmt — convert/manage .nbib/.ris/.bib files.
  • reference-mgmt — BibTeX, related-article discovery, ID conversion.
  • strict-other-citation-impact-audit — determine strict independent other-citations, build article-level citation metric tables, identify high-profile citers (academy members, presidents/deans, talent-award holders, fellows, field leaders), and extract how they cited the target paper.

A combined request (for example search then export) may need more than one. State the detected workflow(s) in one short line before proceeding.

Show full SKILL.md (175 more words)Show less
3. Load the matching workflow fragment(s)

Read the file mapped for each detected workflow (under references/workflows/). Do not read every workflow. Each workflow file links to the shared modules it needs.

4. Run the workflow using the loaded material

Apply the loaded material in this order:

  1. Core tools and routing (core/tools.md, core/routing-and-ops.md) — which MCP tool for which need, and the T1→T2→T3 fallback chain for source retrieval.
  2. The workflow fragment — its specific steps.
  3. Shared modules and scripts on demand (dedup, citation parser, search strategy, RIS/BibTeX format, format converter).

Report specific tool failures and continue with remaining tools; broaden terms when there are no results; fall back to manual generation from MCP-fetched metadata if a script fails twice.

5. Reach for references only when needed

The files under references/ (and scripts/) are deep references, not defaults. Open them on demand per the references.on_demand table in the manifest — for example references/source-tiers.md for the full reliability classification, references/dedup-engine.md / references/citation-parser.md / references/search-strategy.md / references/ris-bibtex-format.md for the shared modules, and scripts/academic_search.py (no-MCP fallback discovery search) / scripts/format-converter.py / scripts/preflight.py for the tooling.

© Yuan1z0825, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 59 other files (scripts, references) in skills/nature-academic-search of Yuan1z0825/nature-skills.

  • SKILL.md
  • README.md
  • README_EN.md
  • agents/openai.yaml
  • config/mcp-snippet.json
  • config/settings-snippet.json
  • config/triggers-academic-search.toml
  • install.sh
  • manifest.yaml
  • mcp-server/README.md
  • mcp-server/academic_search_server.py
  • mcp-server/config.toml
  • mcp-server/requirements.txt
  • mcp-server/sources/__init__.py
  • mcp-server/sources/arxiv.py
  • mcp-server/sources/crossref.py
  • mcp-server/sources/elsevier_common.py
  • … and 43 more

Open the folder on GitHubat commit e605b35

Compare with similar skills

Academic Search and Citation Router next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Academic Search and Citation Router compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Academic Search and Citation Router this skillYuan1z0825/nature-skills47k—~884Automated safety check: PassApache-2.0
Nature Academic Searchaiskillstore/marketplace433—~1.1kAutomated safety check: PassNone
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Arxiv MCP Serverblazickjp/arxiv-mcp-server3.2k—~353Automated safety check: PassApache-2.0
Nature Academic Searchjing1312/nature-figure-skill171—~1.3kAutomated safety check: NotesMIT
Literature ReviewK-Dense-AI/scientific-agent-skills48k1 repos~3.2kAutomated safety check: NotesMIT

Similar skills

  • Nature Academic Search

    aiskillstore/marketplace

    Multi-source literature search, citation verification, MeSH search strategy, citation file management (.nbib/.ris/.bib conversion), and reference management (BibTeX, related articles, ID conversion)…

    433 GitHub stars~1.1k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 20 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Arxiv MCP Server

    blazickjp/arxiv-mcp-server

    A skill your agent uses when finding, comparing, reading, or monitoring arXiv papers, including requests for abstracts, citation graphs, original LaTeX, section-level technical details, or…

    3.2k GitHub stars~353 tokensUpdated 2 days ago
    Research & ScienceAuto-check passed
  • Nature Academic Search

    jing1312/nature-figure-skill

    Multi-source literature search, citation verification, MeSH search strategy, citation file management (.nbib/.ris/.bib conversion), and reference management (BibTeX, related articles, ID conversion)…

    171 GitHub stars~1.3k tokensUpdated 1 mo ago
    Research & ScienceAuto-check: notes
  • Literature Review

    K-Dense-AI/scientific-agent-skills

    Runs systematic, scoping or narrative literature reviews across PubMed, arXiv, bioRxiv and Semantic Scholar, with citation checks and Markdown or PDF output.

    48k GitHub starsUsed in 1 repo~3.2k tokens
    Research & ScienceAuto-check: notes
  • Literature Review

    Norman-bury/research-writing-skill

    A skill your agent uses when writing literature review sections - guides searching, organizing, and synthesizing academic sources

    3.4k GitHub stars~2.2k tokensUpdated 4 mo ago
    Research & ScienceAuto-check: notes

More from Yuan1z0825/nature-skills

All 23 skills in this repo
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed
  • Nature-Style Scientific Figures

    Yuan1z0825/nature-skills

    Creates, revises, audits and exports manuscript-ready scientific figures in Python or R, and routes AI-generated graphical abstracts to a separate workflow.

    47k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Paper to Chinese Patent Drafter

    Yuan1z0825/nature-skills

    Drafts Chinese invention patent applications and technical disclosures from research papers or inventor materials, tying each claim feature to source evidence.

    47k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Researchwrite Proposal Pipeline

    Yuan1z0825/nature-skills

    Composes, revises or audits research proposals and opening reports through an evidence-first state machine with argument maps, section contracts and dynamic expert reviewers.

    47k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Nature Literature Downloader

    Yuan1z0825/nature-skills

    Routes literature requests to lawful full-text sources: open access, publisher APIs, CNKI and institutional browser access, with a supporting-information gate.

    47k GitHub starsUsed in 2 repos~6k tokens
    Auto-check passed
  • Image to Editable PPTX

    Yuan1z0825/nature-skills

    Rebuilds slide images, screenshots, scanned PDFs or image-only PPTX files as PowerPoint with editable objects, using a local CLI with per-page manifests and QA.

    47k GitHub stars~2.5k tokensUpdated today
    Auto-check passed

Questions about Academic Search and Citation Router

What does Academic Search and Citation Router do?

Finds papers across literature sources, verifies and converts citations, builds MeSH strategies and audits independent citations of a paper. This skill acts as a router for academic search work. It reads a manifest, loads the core tool and routing notes, works out which of six workflows your request needs and states them in one line, and then loads only the matching workflow file instead of everything.

When should I use Academic Search and Citation Router?

Academic Search and Citation Router fits situations like: finding papers on a topic across several literature sources; checking that the references in a manuscript are real and correct; building a MeSH-based PubMed search strategy; converting between .nbib, .ris and .bib citation files.

How do I install Academic Search and Citation Router in Claude Code?

Run `npx skills add Yuan1z0825/nature-skills --skill nature-academic-search -a claude-code`. Or copy the skill folder (skills/nature-academic-search in Yuan1z0825/nature-skills) into .claude/skills/nature-academic-search in your project. Claude Code loads it when a task matches its description.

How do I install Academic Search and Citation Router in Codex?

Run `npx skills add Yuan1z0825/nature-skills --skill nature-academic-search -a codex`. Or copy the skill folder (skills/nature-academic-search in Yuan1z0825/nature-skills) into .agents/skills/nature-academic-search in your project. Codex loads it when a task matches its description.

Can I use Academic Search and Citation Router in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Yuan1z0825/nature-skills --skill nature-academic-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nature-academic-search, .gemini/skills/nature-academic-search, .github/skills/nature-academic-search and .opencode/skills/nature-academic-search in your project.

What does Academic Search and Citation Router need to run?

Going by SKILL.md and its folder, Academic Search and Citation Router needs Python and a shell for the scripts in its folder. Our summary lists: Python environment for the bundled MCP server; Network access to the literature sources, except for offline file conversion.

Does Academic Search and Citation Router access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Academic Search and Citation Router safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Academic Search and Citation Router use?

Academic Search and Citation Router is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Academic Search and Citation Router use?

About 884 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 13k tokens, read only when the agent opens those files.

What are the alternatives to Academic Search and Citation Router?

Skills that share tags, products or a category with Academic Search and Citation Router: Nature Academic Search (aiskillstore/marketplace, 433 stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars), Arxiv MCP Server (blazickjp/arxiv-mcp-server, 3.2k stars) and Nature Academic Search (jing1312/nature-figure-skill, 171 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Search and Citation Router?

Yuan1z0825 (a GitHub user) maintains it in Yuan1z0825/nature-skills, which has 47,222 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 11, 2026.

Source: Yuan1z0825/nature-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.