Agent skill

Workspace

A skill your agent uses when the user wants to organize paper subsets, create workspaces, add or remove papers, search within a workspace, manage refs/papers.json, or export workspace BibTeX.

MITAuto-check passedResearch & Science

Install Workspace

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill workspace -a claude-code

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

GitHub CLI

$ gh skill install ZimoLiao/scholaraio workspace --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/workspace .claude/skills/workspace && 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/

Paste into Claude Code

Install the "workspace" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/workspace into .claude/skills/workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workspace", 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.

$skill-installer

$skill-installer install https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/workspace

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill workspace -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio workspace --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/workspace .agents/skills/workspace && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "workspace" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/workspace into .agents/skills/workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workspace", 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.

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill workspace -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio workspace --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/workspace .cursor/skills/workspace && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "workspace" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/workspace into .cursor/skills/workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workspace", 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.

gemini skills install

$ gemini skills install https://github.com/ZimoLiao/scholaraio.git --path .claude/skills/workspace

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill workspace -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio workspace --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/workspace .gemini/skills/workspace && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "workspace" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/workspace into .gemini/skills/workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workspace", 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.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio workspace

Installs 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).

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill workspace -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/workspace .github/skills/workspace && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "workspace" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/workspace into .github/skills/workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workspace", 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.

skills CLI

$ npx skills add ZimoLiao/scholaraio --skill workspace -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install ZimoLiao/scholaraio workspace --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/workspace .opencode/skills/workspace && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "workspace" agent skill from https://github.com/ZimoLiao/scholaraio/tree/main/.claude/skills/workspace into .opencode/skills/workspace/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "workspace", 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: workspace
GitHub stars: 577
Token cost: ~546 tokens
SKILL.md length: 132 words
Files: 1
Skills in repo: 43
Repo updated: Sep 25, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

A skill your agent uses when the user wants to organize paper subsets, create workspaces, add or remove papers, search within a workspace, manage refs/papers.json, or export workspace BibTeX.

The user wants to organize paper subsets
SKILL.md covers 执行逻辑, Context 管理 and 示例
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
Create workspaces

What it does

Workspace is an agent skill from ZimoLiao/scholaraio. Use when the user wants to organize paper subsets, create workspaces, add or remove papers, search within a workspace, manage refs/papers.json, or export workspace BibTeX.

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

It sits in Research & Science, covering Citation management. It works with LaTeX. 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 organize paper subsets
Create workspaces
Search within a workspace
Manage refs/papers.json

Example prompts

“/workspace”

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

Workspace loads about 546 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 132 words of instructions outside code blocks.

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

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). 132 words, ~546 tokens.

Download SKILL.mdSave it as .claude/skills/workspace/SKILL.md (or your agent's skills folder).

name: workspace
description: Use when the user wants to organize paper subsets, create workspaces, add or remove papers, search within a workspace, manage refs/papers.json, or export workspace BibTeX.

工作区管理

工作区是论文子集管理工具。每个工作区引用主库中的论文（通过 UUID），支持在子集内搜索和导出。

执行逻辑

创建工作区

bash

scholaraio ws init <名称>

添加论文

逐个添加：

bash

scholaraio ws add <名称> <论文标识...>

论文标识可以是：DOI、目录名、UUID。需要按关键词批量添加时，请使用 --search。

批量添加：

bash

scholaraio ws add <名称> --search "<查询词>" [--limit N] [--year YYYY] [--journal 期刊名] [--type 类型]
scholaraio ws add <名称> --topic <主题ID>
scholaraio ws add <名称> --all

--search：按融合检索结果批量添加，支持 --limit/--year/--journal/--type 过滤
--topic：按 BERTopic 主题 ID 批量添加该主题下的全部论文
--all：将主库全部论文加入工作区

三个批量参数互斥。提供批量参数时，位置参数 <论文标识> 被忽略。

移除论文

bash

scholaraio ws remove <名称> <论文标识...>

列出所有工作区

bash

scholaraio ws list

查看工作区论文

bash

scholaraio ws show <名称>

重命名工作区

bash

scholaraio ws rename <旧名称> <新名称>

在工作区内搜索

bash

scholaraio ws search <名称> "<查询词>" [--limit N] [--year YYYY] [--journal 期刊名] [--type 类型] [--mode unified|keyword|semantic]

搜索模式：

unified（默认）：融合检索（关键词 + 语义 RRF 排序）
keyword：FTS5 关键词检索
semantic：FAISS 语义向量检索

范围限定在工作区论文内。

导出工作区 BibTeX

bash

scholaraio ws export <名称> [-o 输出文件] [--year YYYY] [--journal 期刊名] [--type 类型]

Context 管理

工作区论文较多时（>30 篇），ws show 的输出应由 subagent 执行并返回摘要（如"工作区包含 N 篇论文，涵盖 XX 方向"），避免直接输出长列表到主 context
论文全文（L4）应在 subagent 中阅读，仅将关键结论带回主 context
搜索结果超过 20 条时，优先用 subagent 处理并筛选

示例

用户说："帮我建一个 drag reduction 的工作区" → 执行 ws init drag-reduction

用户说："把这几篇论文加到工作区" → 执行 ws add drag-reduction <DOI或目录名...>

用户说："把搜索到的论文都加到工作区" → 执行 ws add drag-reduction --search "turbulent drag reduction" --limit 20

用户说："把主题 3 的论文加到工作区" → 执行 ws add drag-reduction --topic 3

用户说："在工作区里搜 turbulent boundary layer" → 执行 ws search drag-reduction "turbulent boundary layer"

用户说："用关键词在工作区里搜" → 执行 ws search drag-reduction "turbulent boundary layer" --mode keyword

用户说："把工作区改个名" → 执行 ws rename drag-reduction turbulence-control

用户说："导出工作区的引用" → 执行 ws export drag-reduction

用户说："我有哪些工作区" → 执行 ws list

Files

Just SKILL.md in .claude/skills/workspace of ZimoLiao/scholaraio.

Open the folder on GitHubat commit 777628b

Compare with similar skills

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

Workspace compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Workspace this skillZimoLiao/scholaraio	577	—	~546	Automated safety check: Pass	MIT	14 days ago
Citation Managementneflibata-feng/MyArxiv-Agent	126	19 repos	~8.1k	Automated safety check: Notes	MIT	today
Academic Paper Writing PipelineImbad0202/academic-research-skills	51k	—	~16k	Automated safety check: Pass	Custom licence	today
Literature Review AgentAr9av/PaperOrchestra	677	1 repos	~5.2k	Automated safety check: Pass	Custom licence	18 days ago
Academic Searchustc-ai4science/academic-search	666	—	~1.1k	Automated safety check: Pass	MIT	1 mo ago
Collaborating With Claudeappautomaton/latex-arxiv-SKILL	458	1 repos	~1.5k	Automated safety check: Pass	MIT	26 days ago

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
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 today
Research & ScienceAuto-check passed
Literature Review Agent
Ar9av/PaperOrchestra
Step 3 of the PaperOrchestra pipeline (arXiv:2604.05018). An agent skill from Ar9av/PaperOrchestra.
677 GitHub starsUsed in 1 repo~5.2k tokens
Research & ScienceAuto-check passed
Academic Search
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…
666 GitHub stars~1.1k tokensUpdated 1 mo ago
Research & ScienceAuto-check passed
Collaborating With Claude
appautomaton/latex-arxiv-SKILL
Use the Claude Code CLI to consult Claude and delegate coding tasks for prototyping, debugging, and code review.
458 GitHub starsUsed in 1 repo~1.5k 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 yesterday
Research & ScienceAuto-check passed

Questions about Workspace

What does Workspace do?

A skill your agent uses when the user wants to organize paper subsets, create workspaces, add or remove papers, search within a workspace, manage refs/papers.json, or export workspace BibTeX. Workspace is an agent skill from ZimoLiao/scholaraio.json, or export workspace BibTeX.

When should I use Workspace?

Workspace fits situations like: the user wants to organize paper subsets; create workspaces; search within a workspace; manage refs/papers.json.

How do I install Workspace in Claude Code?

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

How do I install Workspace in Codex?

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

Can I use Workspace 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 workspace -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workspace, .gemini/skills/workspace, .github/skills/workspace and .opencode/skills/workspace in your project.

What does Workspace need to run?

SKILL.md names no scripts, command-line tools or credentials: Workspace is instructions for the agent only.

Does Workspace 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 Workspace 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 Workspace use?

Workspace 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 Workspace use?

About 546 tokens (SKILL.md is roughly 2.2k 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 Workspace?

Skills that share tags, products or a category with Workspace: Citation Management (neflibata-feng/MyArxiv-Agent, 126 stars), Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Literature Review Agent (Ar9av/PaperOrchestra, 677 stars) and Academic Search (ustc-ai4science/academic-search, 666 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workspace?

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.

Install Workspace

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

工作区管理

执行逻辑

创建工作区

添加论文

移除论文

列出所有工作区

查看工作区论文

重命名工作区

在工作区内搜索

导出工作区 BibTeX

Context 管理

示例

Files

Compare with similar skills

Similar skills

More from ZimoLiao/scholaraio

Related

Questions about Workspace