NSFC Literature Review Writer
HuiyuLi-2000/Chinese-Grant-Writer-Skills
Writes the research-status literature review and critique section of an NSFC grant proposal, backed by a bundled multi-source literature search.
Access and configure a user's local or cloud Zotero library without MCP by executing the bundled JSON CLI.
Install Zotero Research Assistant
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Bubble-OoO/zotero-research-assistant-skill zotero-research-assistant --agent claude-codeProject 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/
Install the "zotero-research-assistant" agent skill from https://github.com/Bubble-OoO/zotero-research-assistant-skill/tree/main into .claude/skills/zotero-research-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotero-research-assistant", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Bubble-OoO/zotero-research-assistant-skill zotero-research-assistant --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "zotero-research-assistant" agent skill from https://github.com/Bubble-OoO/zotero-research-assistant-skill/tree/main into .agents/skills/zotero-research-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotero-research-assistant", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Bubble-OoO/zotero-research-assistant-skill zotero-research-assistant --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "zotero-research-assistant" agent skill from https://github.com/Bubble-OoO/zotero-research-assistant-skill/tree/main into .cursor/skills/zotero-research-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotero-research-assistant", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Bubble-OoO/zotero-research-assistant-skill zotero-research-assistant --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "zotero-research-assistant" agent skill from https://github.com/Bubble-OoO/zotero-research-assistant-skill/tree/main into .gemini/skills/zotero-research-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotero-research-assistant", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Bubble-OoO/zotero-research-assistant-skill zotero-research-assistantInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "zotero-research-assistant" agent skill from https://github.com/Bubble-OoO/zotero-research-assistant-skill/tree/main into .github/skills/zotero-research-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotero-research-assistant", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Bubble-OoO/zotero-research-assistant-skill zotero-research-assistant --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "zotero-research-assistant" agent skill from https://github.com/Bubble-OoO/zotero-research-assistant-skill/tree/main into .opencode/skills/zotero-research-assistant/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zotero-research-assistant", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
zotero-research-assistant- GitHub stars
- 117
- Token cost
- ~1.2k tokens
- SKILL.md length
- 573 words
- Files
- 13 (incl. scripts, references)
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- None found
At a glance
Access and configure a user's local or cloud Zotero library without MCP by executing the bundled JSON CLI.
- Works in 4 steps: Run python /scripts/run_zotero.py health… → Treat ok: false from every command as a… → Cite each mentioned library item as… → …
- Troubleshooting
- SKILL.md covers Setup and troubleshooting…, Required behavior, Route requests and Write safety, plus 1 more section
- Runs Python scripts from its folder; calls python
What it does
Zotero Research Assistant is an agent skill from Bubble-OoO/zotero-research-assistant-skill. Access and configure a user's local or cloud Zotero library without MCP by executing the bundled JSON CLI. Use for Skill setup or troubleshooting, Zotero connection configuration, collection/folder browsing, exact collection item retrieval, library search, paper metadata, PDF full text, annotations, notes, tags, comparisons, and literature reviews. Trigger when the user mentions Zotero, a Zotero collection/folder such as “目录下的论文”, papers in their library, PDF annotations, adding Zotero notes/tags, or fixing this…
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 16 other files, including scripts and reference files (for example `README.md`, `README.zh-CN.md` and `agents/openai.yaml`).
It sits in Research & Science, covering Citation management and Deep research. It works with Zotero, Model Context Protocol and Python. The repository describes itself as: zotero-research-assistant-skill.
When your agent uses it
- Troubleshooting
- Zotero connection configuration
- Collection/folder browsing
- Exact collection item retrieval
Example prompts
- “目录下的论文”
- “/zotero-research-assistant”
Requirements
- Python 3
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Run python /scripts/run_zotero.py health before the first Zotero operation in a task. If it returns ok: false, report the error and stop…
- Treat ok: false from every command as a hard failure. Never transform an error or empty result into a positive claim.
- Cite each mentioned library item as [First author, year, Zotero key] when those fields exist.
- Distinguish a Zotero collection from a topic query. Never search the whole library using a collection name as a keyword.
What it can do on your machine
Read from SKILL.md and the folder at commit dc71b8e. 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 3 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python
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
Zotero Research Assistant loads about 1.2k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 154 tokens; SKILL.md has 573 words of instructions outside code blocks.
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: warnings
The automated check found patterns that need a careful read before installing.
- NoteMentions a .env fileSKILL.md:12
t tell the user to run commands or edit `.env` manually. Detect the operating system and available Python 3.10+ or Conda - WarningContains instruction-override wording (e.g. “without asking the user”)SKILL.md:12
terminal and file operations directly. Do not tell the user to run commands or edit `.env` manually. Detect the operati
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
Without a licence we can't republish the file, so here is its outline and opening line. It has 573 words (~1,248 tokens).
“Use the bundled scripts/run_zotero.py; do not require or configure MCP. Resolve the absolute path of this skill directory before running it. The runner can delegate to a Conda or virtual-environment interpreter configured with ZOTERO_PYTHON. Read references/setup.md only when placing, configuring…”
- name
- zotero-research-assistant
Files
SKILL.md and 12 other files (scripts, references) in the repository root of Bubble-OoO/zotero-research-assistant-skill.
- SKILL.md
- .env.example
- .gitignore
- README.md
- README.zh-CN.md
- agents/openai.yaml
- references/setup.md
- requirements.txt
- scripts/run_zotero.py
- scripts/zotero_cli.py
- scripts/zotero_tools.py
- tests/test_cli.py
- tests/test_zotero_tools.py
Open the folder on GitHubat commit dc71b8e
Compare with similar skills
Zotero Research Assistant 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Zotero Research Assistant this skillBubble-OoO/zotero-research-assistant-skill | 117 | — | ~1.2k | Automated safety check: Warn | None | |
| NSFC Literature Review WriterHuiyuLi-2000/Chinese-Grant-Writer-Skills | 439 | 1 repos | ~1.4k | Automated safety check: Notes | MIT | |
| CLI Anything ZoteroPiaoyangGuohai1/cli-anything-zotero | 138 | — | ~2.6k | Automated safety check: Pass | Apache-2.0 | |
| Setup MedsciAperivue/medsci-skills | 333 | — | ~960 | Automated safety check: Pass | MIT | |
| Literature Review Toolsbrycewang-stanford/Auto-Empirical-Research-Skills | 4.6k | — | ~2.5k | Automated safety check: Notes | Custom licence | |
| Annotate Paper54yyyu/zotero-mcp | 5.3k | — | ~1.5k | Automated safety check: Pass | MIT |
Similar skills
CLI Anything Zotero
PiaoyangGuohai1/cli-anything-zotero
Full-featured CLI for Zotero reference management. An agent skill from PiaoyangGuohai1/cli-anything-zotero.
Setup Medsci
Aperivue/medsci-skills
A skill your agent uses when a skill fails for a missing tool or the environment needs checking.
Literature Review Tools
brycewang-stanford/Auto-Empirical-Research-Skills
Recommend AND run open-source AI tools, agents, Claude Code / Codex skills, and MCP servers for any stage of a literature review — searching, reading, extracting, synthesizing, screening…
Annotate Paper
54yyyu/zotero-mcp
Read the open paper and write study annotations into its PDF with zotero-cli - a context box on the title, a four-part summary on the abstract, role-coded abstract highlights, one box per figure…
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…
Related
Works with
Categories
Questions about Zotero Research Assistant
What does Zotero Research Assistant do?
Access and configure a user's local or cloud Zotero library without MCP by executing the bundled JSON CLI. Zotero Research Assistant is an agent skill from Bubble-OoO/zotero-research-assistant-skill. Access and configure a user's local or cloud Zotero library without MCP by executing the bundled JSON CLI.
When should I use Zotero Research Assistant?
Zotero Research Assistant fits situations like: troubleshooting; zotero connection configuration; collection/folder browsing; exact collection item retrieval.
How do I install Zotero Research Assistant in Claude Code?
Run `npx skills add Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a claude-code`. Or copy the skill folder (the Bubble-OoO/zotero-research-assistant-skill repository) into .claude/skills/zotero-research-assistant in your project. Claude Code loads it when a task matches its description.
How do I install Zotero Research Assistant in Codex?
Run `npx skills add Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a codex`. Or copy the skill folder (the Bubble-OoO/zotero-research-assistant-skill repository) into .agents/skills/zotero-research-assistant in your project. Codex loads it when a task matches its description.
Can I use Zotero Research Assistant 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 Bubble-OoO/zotero-research-assistant-skill --skill zotero-research-assistant -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zotero-research-assistant, .gemini/skills/zotero-research-assistant, .github/skills/zotero-research-assistant and .opencode/skills/zotero-research-assistant in your project.
What does Zotero Research Assistant need to run?
Going by SKILL.md and its folder, Zotero Research Assistant needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Zotero Research Assistant 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 Zotero Research Assistant safe to install?
Our automated static check of SKILL.md flagged 1 warning(s): contains instruction-override wording (e.g. “without asking the user”). Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Zotero Research Assistant use?
No licence was found for Zotero Research Assistant or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Zotero Research Assistant use?
About 1.2k tokens (SKILL.md is roughly 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 1.5k tokens, read only when the agent opens those files.
What are the alternatives to Zotero Research Assistant?
Skills that share tags, products or a category with Zotero Research Assistant: NSFC Literature Review Writer (HuiyuLi-2000/Chinese-Grant-Writer-Skills, 439 stars), CLI Anything Zotero (PiaoyangGuohai1/cli-anything-zotero, 138 stars), Setup Medsci (Aperivue/medsci-skills, 333 stars) and Literature Review Tools (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 Zotero Research Assistant?
Bubble-OoO (a GitHub user) maintains it in Bubble-OoO/zotero-research-assistant-skill, which has 117 GitHub stars. The repository was last updated on August 11, 2026.
Source: Bubble-OoO/zotero-research-assistant-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.