Agent skill

Research Gap

by ZimoLiao in ZimoLiao/scholaraio

A skill your agent uses when the user wants to identify research gaps, open questions, unexplored areas, cross-paper limitations, or future directions from workspace literature.

MITAuto-check passed

Install Research Gap

skills CLI
$ npx skills add ZimoLiao/scholaraio --skill research-gap -a claude-code

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

GitHub CLI
$ gh skill install ZimoLiao/scholaraio research-gap --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/ZimoLiao/scholaraio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/research-gap .claude/skills/research-gap && 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-gap
GitHub stars
577
Token cost
~636 tokens
SKILL.md length
145 words
Files
1
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to identify research gaps, open questions, unexplored areas, cross-paper limitations, or future directions from workspace literature.

  • Works in 4 steps: 全局扫描 → 多维度分析 → 输出报告 → …
  • The user wants to identify research gaps
  • SKILL.md covers 前提, 执行逻辑 and 示例
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Research Gap is an agent skill from ZimoLiao/scholaraio. Use when the user wants to identify research gaps, open questions, unexplored areas, cross-paper limitations, or future directions from workspace literature.

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Scholar All-In-One: A research infrastructure for AI agents. The licence is MIT.

When your agent uses it

  • The user wants to identify research gaps
  • Unexplored areas
  • Cross-paper limitations
  • Future directions from workspace literature

Example prompts

  • “/research-gap”

Requirements

  • Python 3

Workflow steps

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

  1. 全局扫描
  2. 多维度分析
  3. 输出报告
  4. 互动讨论

What it can do on your machine

Read from SKILL.md and the folder at commit 777628b. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are 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

Research Gap loads about 636 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 145 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~636

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZimoLiao/scholaraio at commit 777628b, republished under its MIT licence (© ZimoLiao). 145 words, ~636 tokens.

Download SKILL.mdSave it as .claude/skills/research-gap/SKILL.md (or your agent's skills folder).
name
research-gap
description
Use when the user wants to identify research gaps, open questions, unexplored areas, cross-paper limitations, or future directions from workspace literature.

研究空白识别

从工作区文献中系统性地发现研究空白和开放问题。

前提

用户必须指定一个 workspace(--ws NAME),且工作区中应有足够数量的论文(建议 10+ 篇)。 报告语言由用户指定(中文 / English)。

执行逻辑

1. 全局扫描
bash
scholaraio ws show <name>                    # 论文列表
scholaraio topics                             # 主题聚类(如已建模)

对工作区论文做 L2 扫描(标题 + 摘要),建立领域地图。show 命令会自动展示已有的 notes.md 历史笔记,优先复用已有发现。

2. 多维度分析
维度 1:主题覆盖度
bash
scholaraio topics                             # 全库主题分布
scholaraio topics --topic <ID>                # 各主题下的论文

工作区论文是否集中在某几个主题?哪些相关主题缺乏覆盖?

维度 2:时间趋势

按年份统计工作区论文分布,识别:

  • 哪些方向在近几年论文激增(热点)
  • 哪些方向论文渐少(可能已成熟或被放弃)
  • 哪些方向有早期工作但近年无跟进(潜在空白)

直接用 Python 读取 configured papers library 下的 */meta.json 做统计分析。

维度 3:方法论对比

扫描工作区论文的方法部分(L3-L4),绘制方法论矩阵:

bash
scholaraio show <paper-id> --layer 3          # 结论中通常提及方法
  • 哪些方法被广泛使用?
  • 哪些方法组合尚未被尝试?
  • 某方法在 A 问题上成功,是否可迁移到 B 问题?
维度 4:引用图谱空洞
bash
scholaraio shared-refs "<id1>" "<id2>"        # 共同引用
scholaraio refs "<id>"                        # 参考文献
scholaraio citing "<id>"                      # 被引论文
  • 哪些论文互相引用但观点矛盾?(未解决的争议)
  • 哪些论文被大量引用但缺乏后续验证/复现?
  • 哪些关键参考文献不在工作区中?(可能是盲区)
维度 5:论文自述的 Future Work

加载工作区中高引论文的 L3(结论),提取作者自己提出的未来方向:

bash
scholaraio show <paper-id> --layer 3

这些 future work 是否已有人做了?交叉搜索验证:

bash
scholaraio usearch "<future work 关键词>"
3. 输出报告

生成结构化的研究空白报告,保存到 workspace/<name>/research-gaps.md。

对每个发现的空白,按类型分类:

空白类型含义示例
知识空白某个现象/问题尚无人研究"高 Re 下的 X 效应尚未被测量"
方法空白已有结论但方法存在缺陷或局限"现有研究均为 RANS,缺乏 DNS 验证"
矛盾空白不同研究给出矛盾结论"A 组报告正效应,B 组报告负效应"
迁移空白某方法/发现尚未被推广到相关领域"该方法在 2D 有效,3D 尚未尝试"
规模空白只有小规模/受限条件的结果"仅低 Re 数据,工程 Re 下未验证"

报告结构:

  1. 领域现状概述(2-3 段)
  2. 已识别的研究空白(按优先级排序)
    • 空白类型 + 描述
    • 支撑证据(哪些论文暗示了这个空白)
    • 潜在研究问题
    • 可行性评估(数据/方法/资源是否可及)
  3. 未解决的争议(如有)
  4. 建议的下一步

量化辅助:必要时编写 Python 代码从 meta.json 批量提取数据,做统计图表(年份分布、方法频次、参数范围覆盖等),用可视化支撑空白发现。

分析笔记持久化:对深度分析过的论文,必须通过 CLI 将关键发现写入笔记:

bash
scholaraio show "<paper-id>" --append-notes "## YYYY-MM-DD | <workspace> | research-gap
- 关键发现"
4. 互动讨论

报告生成后,主动与用户讨论:

  • 哪些空白与用户的研究方向最相关?
  • 是否需要补充更多文献来验证某个空白?
  • 能否将某个空白细化为具体的研究问题和假设?

示例

用户说:"帮我看看 drag-review 工作区里还有什么研究空白" → 全面扫描文献,多维度分析,生成研究空白报告

用户说:"这些论文的 future work 都提了什么方向?有人做了吗?" → 提取各论文结论中的 future work,交叉搜索验证

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

Files

Just SKILL.md in .claude/skills/research-gap of ZimoLiao/scholaraio.

Open the folder on GitHubat commit 777628b

Compare with similar skills

Research Gap 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 Gap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Gap this skillZimoLiao/scholaraio577—~636Automated safety check: PassMIT
Gapsanthropics/claude-for-legal9.6k2 repos~229Automated safety check: PassApache-2.0
Skill Gap Analysissickn33/agentic-awesome-skills47k1 repos~3.6kAutomated safety check: PassMIT
Gap Surfaceranthropics/claude-for-legal9.6k1 repos~3.7kAutomated safety check: PassApache-2.0
Identifybrycewang-stanford/Auto-Empirical-Research-Skills4.6k—~1.3kAutomated safety check: PassCustom licence
Test Gapsruvnet/ruflo74k—~214Automated safety check: PassMIT

Similar skills

  • Gaps

    anthropics/claude-for-legal

    Official

    Open gaps tracker — what's flagged and not yet closed. An agent skill from anthropics/claude-for-legal.

    9.6k GitHub starsUsed in 2 repos~229 tokens
    Auto-check passed
  • Skill Gap Analysis

    sickn33/agentic-awesome-skills

    Skill gap register: employee, skill area, current against required level, gap severity and recommended training.

    47k GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check passed
  • Gap Surfacer

    anthropics/claude-for-legal

    Official

    Reference: shared gap- and comment-tracker framework backing /regulatory-legal:gaps and /regulatory-legal:comments.

    9.6k GitHub starsUsed in 1 repo~3.7k tokens
    Auto-check passed
  • Identify

    brycewang-stanford/Auto-Empirical-Research-Skills

    Design or review identification strategy for the sewage-house-prices project.

    4.6k GitHub stars~1.3k tokensUpdated 5 days ago
    Research & ScienceAuto-check passed
  • Test Gaps

    ruvnet/ruflo

    Detect missing test coverage and generate test suggestions. An agent skill from ruvnet/ruflo.

    74k GitHub stars~214 tokensUpdated today
    Testing & QAAuto-check passed
  • Official

    Gaps fix profile for PostHog Review's resolution stage: the default resolution criteria, narrowed to fix only real gaps.

    40k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed

More from ZimoLiao/scholaraio

All 43 skills in this repo
  • Document

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio…

    577 GitHub stars~674 tokensUpdated 15 days ago
    Auto-check passed
  • Academic Writing

    ZimoLiao/scholaraio

    A skill your agent uses when the user needs help choosing or organizing an academic-writing workflow by deliverable, stage, or format, including review articles, guided reading, paper sections, PPT…

    577 GitHub stars~827 tokensUpdated 15 days ago
    Auto-check passed
  • Arxiv

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to browse arXiv preprints, search arXiv directly, fetch a PDF by arXiv ID or URL, or send a preprint into the ScholarAIO ingest pipeline.

    577 GitHub stars~799 tokensUpdated 15 days ago
    Auto-check passed
  • Bioinformatics

    ZimoLiao/scholaraio

    A skill your agent uses when working on bioinformatics workflows such as alignment, variant calling, phylogenetics, or protein-structure analysis, especially across BLAST, minimap2, samtools…

    577 GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed
  • Citation Check

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to verify citations in AI-generated or human-written text against the local knowledge base and catch hallucinated, wrong, or missing references.

    577 GitHub stars~454 tokensUpdated 15 days ago
    Auto-check passed
  • Draw

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants diagrams, flowcharts, architecture visuals, data relationships, timelines, concept maps, Mermaid, Graphviz, drawio, or polished paper figures generated…

    577 GitHub stars~1.3k tokensUpdated 15 days ago
    Auto-check: notes

Questions about Research Gap

What does Research Gap do?

A skill your agent uses when the user wants to identify research gaps, open questions, unexplored areas, cross-paper limitations, or future directions from workspace literature. Research Gap is an agent skill from ZimoLiao/scholaraio. Use when the user wants to identify research gaps, open questions, unexplored areas, cross-paper limitations, or future directions from workspace literature.

When should I use Research Gap?

Research Gap fits situations like: the user wants to identify research gaps; unexplored areas; cross-paper limitations; future directions from workspace literature.

How do I install Research Gap in Claude Code?

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

How do I install Research Gap in Codex?

Run `npx skills add ZimoLiao/scholaraio --skill research-gap -a codex`. Or copy the skill folder (.claude/skills/research-gap in ZimoLiao/scholaraio) into .agents/skills/research-gap in your project. Codex loads it when a task matches its description.

Can I use Research Gap 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 ZimoLiao/scholaraio --skill research-gap -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-gap, .gemini/skills/research-gap, .github/skills/research-gap and .opencode/skills/research-gap in your project.

What does Research Gap need to run?

SKILL.md names no scripts, command-line tools or credentials: Research Gap is instructions for the agent only. Our summary lists: Python 3.

Does Research Gap 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 Gap 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. Review the folder before installing.

What licence does Research Gap use?

Research Gap 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 Gap use?

About 636 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Research Gap?

Skills that share tags, products or a category with Research Gap: Gaps (anthropics/claude-for-legal, 9.6k stars), Skill Gap Analysis (sickn33/agentic-awesome-skills, 47k stars), Gap Surfacer (anthropics/claude-for-legal, 9.6k stars) and Identify (brycewang-stanford/Auto-Empirical-Research-Skills, 4.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Gap?

ZimoLiao (a GitHub user) maintains it in ZimoLiao/scholaraio, which has 577 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 25, 2026.

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