Agent skill

Research Literature Search

by huangwb8 in huangwb8/ChineseResearchLaTeX

当用户需要检索候选论文、建立可审计文献池或为下游证据任务准备候选文献时使用。也适用于 research-literature-review 的检索依赖。

MITAuto-check passedResearch & Science

Install Research Literature Search

skills CLI
$ npx skills add huangwb8/ChineseResearchLaTeX --skill research-literature-search -a claude-code

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

GitHub CLI
$ gh skill install huangwb8/ChineseResearchLaTeX research-literature-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/huangwb8/ChineseResearchLaTeX.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-literature-search .claude/skills/research-literature-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
research-literature-search
GitHub stars
2.9k
Token cost
~940 tokens
SKILL.md length
168 words
Files
21 (incl. scripts, references)
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

当用户需要检索候选论文、建立可审计文献池或为下游证据任务准备候选文献时使用。也适用于 research-literature-review 的检索依赖。

  • Tasks that involve Literature review
  • SKILL.md covers 目标, 流程 and 约束
  • Runs Python scripts from its folder; calls python3

What it does

Research Literature Search is an agent skill from huangwb8/ChineseResearchLaTeX. 当用户需要检索候选论文、建立可审计文献池或为下游证据任务准备候选文献时使用。也适用于 research-literature-review 的检索依赖。

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. The skill folder holds 23 other files, including scripts and reference files (for example `CHANGELOG.md`, `README.md` and `config.yaml`).

It sits in Research & Science, covering Literature review. The licence is MIT.

When your agent uses it

  • Tasks that involve Literature review

Example prompts

  • “/research-literature-search”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit b8b4142. 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 10 files in scripts/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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

Research Literature Search loads about 940 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 26 tokens; SKILL.md has 168 words of instructions outside code blocks.

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

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 huangwb8/ChineseResearchLaTeX at commit b8b4142, republished under its MIT licence (© huangwb8). 168 words, ~940 tokens.

Download SKILL.mdSave it as .claude/skills/research-literature-search/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.
name
research-literature-search
description
当用户需要检索候选论文、建立可审计文献池或为下游证据任务准备候选文献时使用。也适用于 research-literature-review 的检索依赖。
metadata.author
Bensz Conan

目标

将主题和 5–25 条查询转换为可复核的候选文献 bundle。负责召回、字段规范化、canonical 去重、来源审计和可选摘要补全;不负责评分、纳入/排除、子主题、配额、综述写作、BibTeX 或 PDF/Word 导出。research-literature-review 必须消费本 Skill 的 manifest 和 canonical 候选,不得复制 provider 或重做去重。

流程

输入
  • 必需:topic 与显式查询 JSON(--query-file/--queries);支持 {"queries": [...]}、对象数组或字符串数组。
  • 空查询剔除;有效查询默认 5–25 条,不满足即 fail-closed。
  • 可选:domain、年份/文献类型/预印本过滤、provider 顺序、每查询/总量上限、scope_root。
  • 输出必须位于调用方 scope_root 内;拒绝路径穿越和 manifest 外部绝对路径。
执行步骤
bash
python3 skills/research-literature-search/scripts/search_runner.py run --topic "HER2 antibody-drug conjugates in breast cancer" --query-file ./queries.json --output-dir ./.bensz-api/search-bundle
python3 skills/research-literature-search/scripts/search_runner.py enrich-abstracts --input selected_papers.jsonl --output selected_papers_enriched.jsonl
python3 skills/research-literature-search/scripts/search_runner.py validate --bundle ./.bensz-api/search-bundle

run 默认不补全全量摘要;选文后按需执行 enrich-abstracts。provider 按 provider_priority 执行 priority-fallback-topup,达到约 70% 阈值即停止,不承诺全 provider union;mcp/duckduckgo 在纯 Python runner 中记为 skipped/host tool required。每次尝试写入 attempts、Search Log、retrieval_strategy 和 topup_threshold。

输出

manifest.json 是唯一入口,每次运行使用独立目录:

text
manifest.json
candidates_raw.jsonl          # 脱敏的最小 provider 信封
candidates_normalized.jsonl  # rls.paper.v1,去重前
candidates_deduped.jsonl     # canonical 候选池
provenance.jsonl              # provider/query/rank 映射
dedupe_map.json               # 合并边与选择依据
search_log.json               # 可读审计日志

候选必须符合 rls.paper.v1:非空 title、字符串数组 authors、identifiers、abstract_status、publication、sources、query_matches、quality_warnings,并保留旧扁平字段;缺失值只能用 null/[]。manifest status 仅为 success、partial_success、failed;review 只接受前两者并校验 hash、schema、数量。

输出管理

临时产物写入任务工作区,正式交付物按项目约定保存;未经授权不覆盖、删除或远程写入已有文件。所有路径必须限制在授权项目内。

校验

运行 Skill 已有的静态检查、脚本验证或人工复核,并记录通过标准。manifest 保存查询 SHA-256、provider policy、attempts、截断、去重参数、缓存模式、版本和 artifact hash。

失败与恢复

provider 返回 null、非对象或嵌套 source 为 null 时跳过/保留并记录计数或 warning;无合法候选返回 no_valid_candidates,不得静默丢弃。preprint 按领域 profile(auto→computer_science/mathematics/biology/medicine/general)标记并审计,搜索层不认证结论。旧 title/year/id 仅经显式 legacy adapter 并附 legacy_adapted warning;新增 provider/union 策略需升级 contract。

约束

  • JSON 使用 UTF-8、稳定排序和确定性序列化;同夹具/配置下顺序可比较。
  • 不写入 API key、Cookie、完整响应或其它凭据;不得将未验证信息伪装为确定结论。
<!-- BEGIN COMMON CONSTRAINTS -->
<!-- Source-Hash: sha256:15120201e9e0c7569517261d57ecefb63ac279c26ed13876f8e95b6dc35854d3 -->
<!-- Template-ID: skill-common-constraints; Template-Version: 1; Sync-Policy: exact-block -->
公共硬约束

本块由 docs/templates/skill-common-constraints.md 统一维护;每个 SKILL.md 的 ## 约束 必须逐字同步本块,不得在副本中改写公共规则。

  • 任务需要落盘时,使用唯一的 ./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/ 根目录;共享材料放入 shared/,Skill 专属材料放入该 Skill 的 input/、output/、log/。
  • 正式交付物、源代码和正式计划按项目约定保存,不写入任务工作区;未经授权不覆盖、删除、迁移或远程写入。
  • 项目维护变更检查 BAC 可用性并记录需求、AI 产出、工具结果、文件改动和验证摘要;BAC 只做过程审计,不替代署名、责任或合规判断。
  • 不记录 API Key、访问令牌、密码、Cookie、环境/凭据文件、私有 Prompt、身份信息、本地用户名、主机名或不必要的大体积原始数据。
  • 文件路径必须规范化并限制在授权项目范围内;外部 URL、子进程和网络访问遵循最小权限,防止路径穿越、SSRF 和命令注入。
  • Skill 版本唯一记录在自身 config.yaml:skill_info.version;公开 API、协议、目录或配置变更同步文档与 CHANGELOG.md。
  • bensz-collect-bugs 是一个 Agent Skill;仅将 Bensz Agent Skill 或 Bensz 基础设施本身的设计缺陷交给它。先脱敏写入 ~/.bensz-skills/bugs/,当前任务不中断,只有用户明确要求才公开上报,禁止直接修改用户已安装的 Skill 源码。
<!-- End of canonical common constraints. -->
<!-- END COMMON CONSTRAINTS -->
Skill 专属约束

不得超出本 Skill description 和上方流程所声明的范围;不将未验证的信息伪装成确定结论。

© huangwb8, 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 20 other files (scripts, references) in skills/research-literature-search of huangwb8/ChineseResearchLaTeX.

  • SKILL.md
  • CHANGELOG.md
  • README.md
  • config.yaml
  • references/bundle-schema.md
  • references/paper-schema.md
  • references/provider-guide.md
  • requirements.txt
  • scripts/candidate_schema.py
  • scripts/dedupe_papers.py
  • scripts/manifest.py
  • scripts/multi_source_abstract.py
  • scripts/normalize_papers.py
  • scripts/providers/__init__.py
  • scripts/providers/crossref.py
  • scripts/providers/openalex.py
  • scripts/providers/semantic_scholar.py
  • scripts/query_contract.py
  • … and 3 more

Open the folder on GitHubat commit b8b4142

Compare with similar skills

Research Literature 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.

Research Literature Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Literature Search this skillhuangwb8/ChineseResearchLaTeX2.9k—~940Automated safety check: PassMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Systematic Review ScreenerImbad0202/academic-research-skills51k—~8.4kAutomated safety check: PassCustom licence
Literature Reviewneflibata-feng/MyArxiv-Agent12620 repos~5.9kAutomated safety check: NotesMIT
Preprint Search on bioRxivLigphiDonk/Oh-my--paper73912 repos~3.7kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence

Similar skills

  • 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
    Research & ScienceAuto-check passed
  • Systematic Review Screener

    Imbad0202/academic-research-skills

    Screens records for systematic, scoping and rapid reviews against fixed eligibility rules, using two blinded AI reviewers and a third adjudicator, with traceable PRISMA counts.

    51k GitHub stars~8.4k 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
  • Preprint Search on bioRxiv

    LigphiDonk/Oh-my--paper

    Searches bioRxiv life sciences preprints by keyword, author, date range or category with a Python script, returning JSON metadata and optional PDF downloads.

    739 GitHub starsUsed in 12 repos~3.7k tokens
    Research & ScienceAuto-check passed
  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Deep Research Workflow

    TokenRhythm/opensquilla

    Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.

    7.1k GitHub stars~1.3k tokensUpdated yesterday
    Research & ScienceAuto-check passed

More from huangwb8/ChineseResearchLaTeX

All 27 skills in this repo
  • NSFC Grant Rationale Writer

    huangwb8/ChineseResearchLaTeX

    Writes, restructures, reviews and polishes the rationale section of NSFC research grant applications in LaTeX, with backups and a diff before every write.

    2.9k GitHub stars~945 tokensUpdated 7 days ago
    Auto-check passed
  • LaTeX Example Content Generator

    huangwb8/ChineseResearchLaTeX

    Fills an existing LaTeX project with sample sections, tables and figure narratives, protecting the template structure and previewing before writing.

    2.9k GitHub starsUsed in 1 repo~744 tokens
    Auto-check passed
  • Journal Selector for Manuscripts

    huangwb8/ChineseResearchLaTeX

    Recommends journals for a manuscript by filtering a bundled impact-factor catalog, verifying scope and quality online, and writing a ranked Markdown report.

    2.9k GitHub stars~1.7k tokensUpdated 7 days ago
    Auto-check passed
  • NSFC Abstract Writer

    huangwb8/ChineseResearchLaTeX

    Writes Chinese and English abstracts for NSFC grant applications, with a recommended title and five alternatives, within set character limits.

    2.9k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • NSFC Budget Justification Writer

    huangwb8/ChineseResearchLaTeX

    Writes a submission-ready NSFC budget justification as a LaTeX project and renders budget.pdf from your grant proposal text and supporting materials.

    2.9k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • NSFC Application Code Recommender

    huangwb8/ChineseResearchLaTeX

    Recommends five pairs of NSFC application codes, primary and secondary, from a grant proposal's text and writes the reasons to a Markdown report.

    2.9k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed

Questions about Research Literature Search

What does Research Literature Search do?

当用户需要检索候选论文、建立可审计文献池或为下游证据任务准备候选文献时使用。也适用于 research-literature-review 的检索依赖。. Research Literature Search is an agent skill from huangwb8/ChineseResearchLaTeX.

When should I use Research Literature Search?

Research Literature Search fits situations like: tasks that involve Literature review.

How do I install Research Literature Search in Claude Code?

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

How do I install Research Literature Search in Codex?

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

Can I use Research Literature 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 huangwb8/ChineseResearchLaTeX --skill research-literature-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/research-literature-search, .gemini/skills/research-literature-search, .github/skills/research-literature-search and .opencode/skills/research-literature-search in your project.

What does Research Literature Search need to run?

Going by SKILL.md and its folder, Research Literature Search needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

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

Research Literature Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Research Literature Search use?

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

What are the alternatives to Research Literature Search?

Skills that share tags, products or a category with Research Literature Search: Nature Paper Card (Yuan1z0825/nature-skills, 47k stars), Systematic Review Screener (Imbad0202/academic-research-skills, 51k stars), Literature Review (neflibata-feng/MyArxiv-Agent, 126 stars) and Preprint Search on bioRxiv (LigphiDonk/Oh-my--paper, 739 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Literature Search?

huangwb8 (a GitHub user) maintains it in huangwb8/ChineseResearchLaTeX, which has 2,880 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on October 4, 2026.

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