Agent skill

Academic Search

by ustc-ai4science in ustc-ai4science/academic-search

A skill your agent uses when the user asks to search or review academic papers, retrieve scholarly metadata or citation counts, validate or deduplicate scholarly records, find an author's…

MITAuto-check passedResearch & Science

Install Academic Search

skills CLI
$ npx skills add ustc-ai4science/academic-search --skill academic-search -a claude-code

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

GitHub CLI
$ gh skill install ustc-ai4science/academic-search 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).

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

Facts

Skill name
academic-search
GitHub stars
668
Token cost
~1.1k tokens
SKILL.md length
205 words
Files
77 (incl. scripts, references, assets)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user asks to search or review academic papers, retrieve scholarly metadata or citation counts, validate or deduplicate scholarly records, find an author's…

  • Works in 5 steps: 根据研究问题选择互补查询词、受控词表与文献类型。记录实际查询、筛选条件和检索时间;… → 轻量筛选可暂不拉完整摘要;完整元数据任务应继续补齐已要求的字段。论文表明确区分搜索… → 按 metadata-schema 输出。需要交付或复用 JSON 记录时,按… → …
  • The user asks to search
  • SKILL.md covers 任务范围与完成标准, 学科路由与来源, 检索与核验 and 浏览器、全文与导出, plus 1 more section
  • Calls node and bash

What it does

Academic Search is an agent skill from ustc-ai4science/academic-search. Use when the user asks to search or review academic papers, retrieve scholarly metadata or citation counts, validate or deduplicate scholarly records, find an author's publications, export BibTeX, or discover and download open-access full text. 适用于搜论文、文献综述、系统综述、引用分析、学术记录校验去重、DOI/arXiv 精确查找与开放 PDF 获取。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 81 other files, including scripts, reference files and assets (for example `README.en.md`, `README.md` and `agents/openai.yaml`).

It sits in Research & Science, covering Academic paper search and Citation management. It works with arXiv and LaTeX. The licence is MIT.

When your agent uses it

  • The user asks to search
  • Review academic papers
  • Retrieve scholarly metadata
  • Citation counts

Example prompts

  • “/academic-search”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 根据研究问题选择互补查询词、受控词表与文献类型。记录实际查询、筛选条件和检索时间;按相关性及用户目标排序。CCF 只用于适用的 CS 任务,其他学科遵循 profile;分级需注明来源和版本。
  2. 轻量筛选可暂不拉完整摘要;完整元数据任务应继续补齐已要求的字段。论文表明确区分搜索片段、摘要与全文证据。
  3. 按 metadata-schema 输出。需要交付或复用 JSON 记录时,按 academic-records 运行可执行校验与保守去重:DOI/arXiv/PMID 等精确标识可归组,规范化后标题完全相同只产生待核对候选。预印本与正式版本保留对应关系,勿静默合并不同研究。
  4. 引用数保留平台、数值、检索时间和来源;不同平台的计数分别保存,不求和、不把较大值当唯一真值。缺失字段用空值及原因,不补造。
  5. API 429 只说明当前请求被限流,不能确定会话配额永久耗尽。遵守有效的 Retry-After,无提示时有界退避;同一请求默认最多 2 次重试、总等待预算 30 秒,预算不足则停止该来源并记录限制。并行任务共享平台请求预算;参数详见 API cookbook 与 S2 经验。

What it can do on your machine

Read from SKILL.md and the folder at commit b9b692e. 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/, which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • bash

    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 loads about 1.1k tokens when it runs, and up to ~33k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 205 words of instructions outside code blocks.

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

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 ustc-ai4science/academic-search at commit b9b692e, republished under its MIT licence (© ustc-ai4science). 205 words, ~1,078 tokens.

Download SKILL.mdSave it as .claude/skills/academic-search/SKILL.md (or your agent's skills folder). This skill also uses 76 other files; get the full folder from GitHub.
name
academic-search
description
Use when the user asks to search or review academic papers, retrieve scholarly metadata or citation counts, validate or deduplicate scholarly records, find an author's publications, export BibTeX, or discover and download open-access full text. 适用于搜论文、文献综述、系统综述、引用分析、学术记录校验去重、DOI/arXiv 精确查找与开放 PDF 获取。
metadata.version
1.4.0

按用户要求检索、筛选并交付可追溯的学术资料。优先官方 API 和论文来源;浏览器用于动态页面、交互或当前 API 无法满足的字段。

任务范围与完成标准

从请求确定学科、论文范围、年份、数量和所需字段;只有影响结果且无法合理推断的缺项才询问。开放式选题可先轻量检索、筛选,再补充核心论文;用户已经要求完整元数据、摘要、BibTeX 或下载时,直接完成相应步骤,不因“两遍策略”再次要求确认。

完成标准是所需记录、字段和文件均已交付,或逐项说明未完成部分的证据与原因。工具返回成功、页面加载完成、URL 看起来像 PDF 都不能单独证明任务完成。

学科路由与来源

读取与任务对应的学科 profile,跨学科任务以核心学科为主,并用 OpenAlex / Crossref 等补充。

学科 / 任务优先来源按需参考
计算机 / AIarXiv、Semantic Scholar、ACM DL、IEEE、DBLPcomputer-science
医学 / 生命科学PubMed、PMC、Europe PMC、临床试验库biomedicine
物理 / 数学arXiv、NASA ADS、INSPIRE HEPphysics-math
化学 / 材料Crossref、OpenAlex、ChemRxiv、出版商chemistry-materials
经济 / 社科RePEc、NBER、SSRN、OSFeconomics-social-science
人文 / 法律学术搜索、图书馆目录、领域数据库humanities-law
精确论文 / 元数据DOI → Crossref / 出版商;arXiv ID → arXiv;S2 / OpenAlex 补全API cookbook
引用 / 作者论文S2 API;用户指定 Scholar 时使用浏览器S2、Scholar
中文文献CNKI 等中文数据库,按当前访问条件检索CNKI
OA PDF / 全文论文来源、开放仓储、OpenAlex、Unpaywall、PMC全文工作流

只使用 API 时不启动浏览器或执行 CDP 环境检查。调用参数、鉴权与分页见 API cookbook。代码链接优先核对论文或作者给出的仓库;第三方索引作为发现线索。

检索与核验

  1. 根据研究问题选择互补查询词、受控词表与文献类型。记录实际查询、筛选条件和检索时间;按相关性及用户目标排序。CCF 只用于适用的 CS 任务,其他学科遵循 profile;分级需注明来源和版本。
  2. 轻量筛选可暂不拉完整摘要;完整元数据任务应继续补齐已要求的字段。论文表明确区分搜索片段、摘要与全文证据。
  3. 按 metadata-schema 输出。需要交付或复用 JSON 记录时,按 academic-records 运行可执行校验与保守去重:DOI/arXiv/PMID 等精确标识可归组,规范化后标题完全相同只产生待核对候选。预印本与正式版本保留对应关系,勿静默合并不同研究。
  4. 引用数保留平台、数值、检索时间和来源;不同平台的计数分别保存,不求和、不把较大值当唯一真值。缺失字段用空值及原因,不补造。
  5. API 429 只说明当前请求被限流,不能确定会话配额永久耗尽。遵守有效的 Retry-After,无提示时有界退避;同一请求默认最多 2 次重试、总等待预算 30 秒,预算不足则停止该来源并记录限制。并行任务共享平台请求预算;参数详见 API cookbook 与 S2 经验。

多篇独立论文或不同来源可并行,依赖查询结果的详情获取顺序执行;各执行者返回结构化结果及来源,不共享同一页面的操作控制。

浏览器、全文与导出

  • 需要动态页面时,先读 browser-workflow 及对应域名经验。正文型页面优先调用 /readPage 获取带来源、提取方式和截断标记的结构化观察;交互前检查唯一目标、可见性、禁用状态与遮挡。动作返回的 status:"dispatched" 只表示已派发,outcome_verified:false 表示仍须等待并核验查询、筛选、保存或提交结果。空结果、挑战页、登录要求和超时分别处理。
  • 获取全文或开放 PDF 下载与 manifest 导出时,读 full-text-workflow。候选 URL、开放获取声明、实际文件验证、论文身份是不同证据;有 arXiv ID 不等于 PDF 已验证。HTML 响应不能证明没有 PDF,未找到 OA 匹配只能报告本次所查来源未发现。
  • 已获授权的开放 PDF 下载直接执行;未要求下载时交付元数据或清单即可。不得调用 Sci-Hub、LibGen 或绕过付费墙、验证码和机构访问限制;遇到限制记录原因并继续其他合法来源。
  • BibTeX 优先使用出版平台或 arXiv 导出,缺失时按 metadata-schema 从已核对字段生成,保留缺失项。
  • 系统综述与证据图谱读取 systematic-review,记录检索、去重、筛选与全文限制,按实际覆盖报告完成程度。

运行路径与站点经验

本文及 references 中的脚本路径均相对本 SKILL.md 所在目录。先将其绝对路径保存为 ACADEMIC_SEARCH_ROOT,再运行 bash "$ACADEMIC_SEARCH_ROOT/scripts/check-deps.sh"、node "$ACADEMIC_SEARCH_ROOT/scripts/academic-records.mjs" 或 node "$ACADEMIC_SEARCH_ROOT/scripts/oa-pdf-download.mjs";不要假定安装在某个宿主的固定目录。仅在使用 bundled CDP 运行时时执行第一条命令。默认自动启动本机 Chrome,使用独立持久 profile(~/.local/share/academic-search/chrome-profile),不发现或连接日常 Chrome;首次网站登录需在专用 profile 中完成,日常登录态不会复制。显式设置 ACADEMIC_CHROME_ENDPOINT 时只连接该已运行端点,失败不自动启动或回退;CDP_PROXY_PORT 仅指定代理端口,v1.4.0 默认仍为 3457(v1.3.1 从 3456 迁移);调用前核对新版代理身份,不接管旧端口服务。配置与协议见 cdp-api。

经验按“域名 → 操作 → 症状”按需读取。条目使用 unverified / verified / deprecated 状态,记录适用环境、前提、失败信号、回退和 last_verified。历史未复验条目保持 last_verified: null;只有实际观察到预期结果才能升级为 verified。选择器失效时以当前观察修正本次操作。仅在用户授权维护本 Skill 时更新内置经验;普通检索不自动改写 Skill 或全局个人记忆。

© ustc-ai4science, MIT. 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 76 other files (scripts, references, assets) in the repository root of ustc-ai4science/academic-search.

  • SKILL.md
  • .gitattributes
  • .gitignore
  • LICENSE
  • Makefile
  • README.en.md
  • README.md
  • agents/openai.yaml
  • assets/academic-search-framework.png
  • assets/logo.png
  • docs/multidisciplinary-improvement-analysis.md
  • docs/release-1.3.1.md
  • docs/release-1.3.md
  • docs/release-1.4.md
  • docs/skill-usage-comparison.md
  • docs/superpowers/plans/2026-09-05-academic-search-webmind-upgrade.md
  • … and 61 more

Open the folder on GitHubat commit b9b692e

Compare with similar skills

Academic Search 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Academic Search this skillustc-ai4science/academic-search668—~1.1kAutomated safety check: PassMIT
Citation Managementneflibata-feng/MyArxiv-Agent12619 repos~8.1kAutomated safety check: NotesMIT
Literature Review AgentAr9av/PaperOrchestra6791 repos~5.2kAutomated safety check: PassCustom licence
Arxiv MCP Serverblazickjp/arxiv-mcp-server3.2k—~353Automated safety check: PassApache-2.0
Arxiv Paper Writerappautomaton/latex-arxiv-SKILL458—~2.3kAutomated safety check: PassMIT
Citation AssistantZhangNy301/citation-assistant238—~1.1kAutomated safety check: NotesNone

Similar skills

  • Citation Management

    neflibata-feng/MyArxiv-Agent

    Comprehensive citation management for academic research. An agent skill from neflibata-feng/MyArxiv-Agent.

    126 GitHub starsUsed in 19 repos~8.1k tokens
    Research & ScienceAuto-check: notes
  • Literature Review Agent

    Ar9av/PaperOrchestra

    Step 3 of the PaperOrchestra pipeline (arXiv:2604.05018). An agent skill from Ar9av/PaperOrchestra.

    679 GitHub starsUsed in 1 repo~5.2k tokens
    Research & ScienceAuto-check passed
  • 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
  • Arxiv Paper Writer

    appautomaton/latex-arxiv-SKILL

    Write LaTeX ML/AI review articles for arXiv using the IEEEtran template and verified BibTeX citations.

    458 GitHub stars~2.3k tokensUpdated 27 days ago
    Research & ScienceAuto-check passed
  • Citation Assistant

    ZhangNy301/citation-assistant

    A skill your agent uses when the user needs academic citations, BibTeX, venue/author quality checks, or help filling [CITE] placeholders.

    238 GitHub stars~1.1k tokensUpdated 7 mo ago
    Research & ScienceAuto-check: notes
  • Arxiv Paper Writer

    yunshenwuchuxun/latex-paper-skills

    Writes ML/AI review and survey papers for arXiv using the IEEEtran LaTeX template with verified BibTeX citations.

    267 GitHub stars~3.2k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed

Works with

Questions about Academic Search

What does Academic Search do?

A skill your agent uses when the user asks to search or review academic papers, retrieve scholarly metadata or citation counts, validate or deduplicate scholarly records, find an author's…. Academic Search is an agent skill from ustc-ai4science/academic-search. Use when the user asks to search or review academic papers, retrieve scholarly metadata or citation counts, validate or deduplicate scholarly records, find an author's publications, export BibTeX, or discover and download open-access full text.

When should I use Academic Search?

Academic Search fits situations like: the user asks to search; review academic papers; retrieve scholarly metadata; citation counts.

How do I install Academic Search in Claude Code?

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

How do I install Academic Search in Codex?

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

Can I use Academic Search 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 ustc-ai4science/academic-search --skill 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/academic-search, .gemini/skills/academic-search, .github/skills/academic-search and .opencode/skills/academic-search in your project.

What does Academic Search need to run?

Going by SKILL.md and its folder, Academic Search needs the command-line tools its instructions call (node and bash).

Does Academic Search 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 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 use?

Academic Search is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Academic Search use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 31k tokens, read only when the agent opens those files.

What are the alternatives to Academic Search?

Skills that share tags, products or a category with Academic Search: Citation Management (neflibata-feng/MyArxiv-Agent, 126 stars), Literature Review Agent (Ar9av/PaperOrchestra, 679 stars), Arxiv MCP Server (blazickjp/arxiv-mcp-server, 3.2k stars) and Arxiv Paper Writer (appautomaton/latex-arxiv-SKILL, 458 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Search?

ustc-ai4science (a GitHub organization) maintains it in ustc-ai4science/academic-search, which has 668 GitHub stars. The repository was last updated on September 5, 2026.

Source: ustc-ai4science/academic-search on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.