A research-topic exploration workflow based on BERTopic, a method that groups documents by related language and themes. It provides topic summaries, topic papers, merges, reductions, and HTML visualizations.

It helps build or rebuild topic groups, view papers in a topic, inspect outliers, merge related topics, reduce the number of topics, and create visual charts.

It helps reveal how subjects are distributed in a paper library and makes related or overlapping research areas easier to inspect.

How ZimoLiao/scholaraio configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to ZimoLiao/scholaraio. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/ZimoLiao/scholaraio/main/.claude/skills/topics/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/ZimoLiao/scholaraio

Made for: Claude Code.

Or install scholaraio, the plugin that ships this one along with the rest of its 44 skills, 1 hook.

Wrote 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.

README.md

[![agentmods](https://agentmods.dev/badge/skills/zimoliao/scholaraio/topics/github.svg)](https://agentmods.dev/skills/zimoliao/scholaraio/topics)

Your own site

<a href="https://agentmods.dev/skills/zimoliao/scholaraio/topics"><img src="https://agentmods.dev/badge/skills/zimoliao/scholaraio/topics/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.

Your own site · 80×15

<a href="https://agentmods.dev/skills/zimoliao/scholaraio/topics"><img src="https://agentmods.dev/badge/skills/zimoliao/scholaraio/topics.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 553 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

NVIDIA SkillSpector pass 7 Sept 2026

How audits are shown

Origin original No closer match found in the catalogue.

Token cost

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.00033	$0.00553
Opus 5.5	$0.00013	$0.00221
Sonnet 5.5	$0.00007	$0.00111
Haiku 4.5	$0.00003	$0.00055

Measured 2mo ago against content hash 93b2a117b90a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

topics 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.

.claude/skills/topics/SKILL.md · 71 lines

What it actually says

主题探索

探索论文库的主题分布，发现跨领域关联。基于 BERTopic 聚类。

执行逻辑

判断用户意图：
- "建模"、"重建主题" → 构建/重建
- "合并主题"、"压缩到N个" → 智能合并
- "可视化"、"画图" → 生成 HTML
- 查看某主题详情 → 主题查询
- 查看 outlier → topic -1
- 默认展示概览
执行命令：

构建/重建主题模型：

scholaraio topics --build
scholaraio topics --rebuild [--min-topic-size N] [--nr-topics N]

手动合并指定主题（格式: 逗号分隔同组ID，+分隔不同组）：

scholaraio topics --merge "1,6,14+3,5"

算法合并到 N 个主题：

scholaraio topics --reduce <N>

查看主题概览：

scholaraio topics

查看指定主题的论文：

scholaraio topics --topic <ID> [--limit N]

生成 HTML 可视化（6 张图表）：

scholaraio topics --viz

智能合并流程（当用户要求合并/压缩主题时）： a. 先执行 topics 获取所有主题概览 b. 分析每个主题的关键词，判断哪些主题在学术上属于同一研究方向 c. 生成合并方案 d. 用 --merge 执行合并

示例

用户说："帮我看看库里的主题分布" → 执行 topics

用户说："主题2里有哪些论文" → 执行 topics --topic 2

用户说："帮我把相似的主题合并一下" → 先 topics 查看概览，分析关键词，再 topics --merge "1,6,14+3,5"

用户说："给我画个主题分布图" → 执行 topics --viz

Changes

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 · 71 lines · 33 tokens per session scan A 93b2a117b90a

Subscribe to this mod's changes

topics is a skill published in the GitHub repository ZimoLiao/scholaraio (584 stars, last pushed 10d ago), licensed MIT. It adds 33 tokens to every session and 553 once invoked, about $0.0001 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-30.

Analytics and metrics Research agentic-science agentic-search ai-agent computational-research research-workflow scientific-computing

topics next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
topicsZimoLiao/scholaraio	Skill	584	10d ago	MIT	A	33	Claude Code
thoughtdagchenxiachan/thoughtdag	Skill	742	5d ago	MIT	B	39	Claude Code, Codex
autosearch:channel-selection0xmariowu/Autosearch	Skill	54	7d ago	MIT	A	87	Claude Code
autosearch:context-retention-policy0xmariowu/Autosearch	Skill	54	7d ago	MIT	A	89	Claude Code
autosearch:delegate-subtask0xmariowu/Autosearch	Skill	54	7d ago	MIT	A	71	Claude Code
autosearch:experience-compact0xmariowu/Autosearch	Skill	54	7d ago	MIT	A	69	Claude Code
autosearch:graph-search-plan0xmariowu/Autosearch	Skill	54	7d ago	MIT	A	72	Claude Code

scholaraio: Skill for Claude Code