Agent skill

Citation Assistant

by ZhangNy301 in ZhangNy301/citation-assistant

A skill your agent uses when the user needs academic citations, BibTeX, venue/author quality checks, or help filling [CITE] placeholders.

No licenceAuto-check: notesResearch & Science

Install Citation Assistant

skills CLI
$ npx skills add ZhangNy301/citation-assistant --skill citation-assistant -a claude-code

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

GitHub CLI
$ gh skill install ZhangNy301/citation-assistant citation-assistant --agent claude-code

Project 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/

Facts

Skill name
citation-assistant
GitHub stars
238
Token cost
~1.1k tokens
SKILL.md length
274 words
Files
19 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when the user needs academic citations, BibTeX, venue/author quality checks, or help filling [CITE] placeholders.

  • Works in 6 steps: 解析需求 → 语义化查询构造 → 执行搜索 → …
  • The user needs academic citations
  • SKILL.md covers ⚠️ 核心原则, 📦 可用脚本, 🆕 增强功能 and 🔄 工作流程, plus 2 more sections
  • Runs Shell scripts from its folder; calls bash; reaches semanticscholar.org; needs S2_API_KEY

What it does

Citation Assistant is an agent skill from ZhangNy301/citation-assistant. Use when the user needs academic citations, BibTeX, venue/author quality checks, or help filling [CITE] placeholders. Triggers include 文献引用、找引用、citation、bib、参考文献、替换不规范引用、查询作者 H-index、判断期刊/会议质量。

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts (for example `CHANGELOG.md`, `README.md` and `scripts/author_info.sh`).

It sits in Research & Science, covering Citation management and Academic paper search. It works with LaTeX and arXiv. The repository describes itself as: Claude Code Skill for automated academic citation workflow with Semantic Scholar API.

When your agent uses it

  • The user needs academic citations
  • Venue/author quality checks
  • Help filling [CITE] placeholders
  • Include 文献引用、找引用、citation、bib、参考文献、替换不规范引用、查询作者 H-index、判断期刊/会议质量

Example prompts

  • “/citation-assistant”

Requirements

  • A Bash shell
  • A credential in S2_API_KEY

Workflow steps

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

  1. 解析需求
  2. 语义化查询构造
  3. 执行搜索
  4. 评估文献质量
  5. 生成 BibTeX
  6. 生成中文推荐报告

What it can do on your machine

Read from SKILL.md and the folder at commit b1fde76. 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 9 files in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • bash

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • semanticscholar.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • S2_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Citation Assistant loads about 1.1k tokens when it runs. Until then it costs about 53 tokens; SKILL.md has 274 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:166
    # 在 Skill 目录创建 .env 文件
  • NoteMentions a .env fileSKILL.md:167
    "your_key_here"' > "${CLAUDE_SKILL_ROOT}/.env"
  • NoteMentions a .env fileSKILL.md:180
    # 默认 100,可在 .env 中配置
  • NoteMentions a .env fileSKILL.md:181
    _THRESHOLD=100' >> "${CLAUDE_SKILL_ROOT}/.env"

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 274 words (~1,136 tokens).

name
citation-assistant

Read the full SKILL.md on GitHub

Files

SKILL.md and 18 other files (scripts) in the repository root of ZhangNy301/citation-assistant.

  • SKILL.md
  • .env.example
  • .gitignore
  • CHANGELOG.md
  • README.md
  • data/ccf_2022.jsonl
  • data/ccf_2022.sqlite
  • data/ccf_2026.jsonl
  • data/ccf_2026.sqlite
  • data/impact_factor.sqlite3
  • scripts/author_info.sh
  • scripts/ccf_lookup.sh
  • scripts/crossref_search.sh
  • scripts/doi2bibtex.sh
  • scripts/if_lookup.sh
  • scripts/init.sh
  • scripts/s2_bulk_search.sh
  • scripts/s2_search.sh
  • scripts/venue_info.sh

Open the folder on GitHubat commit b1fde76

Compare with similar skills

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

Citation Assistant compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Citation Assistant this skillZhangNy301/citation-assistant238—~1.1kAutomated safety check: NotesNone
Citation Managementneflibata-feng/MyArxiv-Agent12619 repos~8.1kAutomated safety check: NotesMIT
Literature Review AgentAr9av/PaperOrchestra6791 repos~5.2kAutomated safety check: PassCustom licence
Academic Searchustc-ai4science/academic-search668—~1.1kAutomated safety check: PassMIT
Arxiv MCP Serverblazickjp/arxiv-mcp-server3.2k—~353Automated safety check: PassApache-2.0
Arxiv Paper Writerappautomaton/latex-arxiv-SKILL458—~2.3kAutomated safety check: PassMIT

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
  • Literature Review Agent

    Ar9av/PaperOrchestra

    Step 3 of the PaperOrchestra pipeline (arXiv:2604.05018). An agent skill from Ar9av/PaperOrchestra.

    679 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…

    668 GitHub stars~1.1k tokensUpdated 1 mo ago
    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 2 days ago
    Research & ScienceAuto-check passed
  • Arxiv Paper Writer

    appautomaton/latex-arxiv-SKILL

    Write LaTeX ML/AI review articles for arXiv using the IEEEtran template and verified BibTeX citations.

    458 GitHub stars~2.3k tokensUpdated 27 days ago
    Research & ScienceAuto-check passed
  • Arxiv Paper Writer

    yunshenwuchuxun/latex-paper-skills

    Writes ML/AI review and survey papers for arXiv using the IEEEtran LaTeX template with verified BibTeX citations.

    267 GitHub stars~3.2k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed

Works with

Questions about Citation Assistant

What does Citation Assistant do?

A skill your agent uses when the user needs academic citations, BibTeX, venue/author quality checks, or help filling [CITE] placeholders. Citation Assistant is an agent skill from ZhangNy301/citation-assistant. Use when the user needs academic citations, BibTeX, venue/author quality checks, or help filling [CITE] placeholders.

When should I use Citation Assistant?

Citation Assistant fits situations like: the user needs academic citations; venue/author quality checks; help filling [CITE] placeholders; include 文献引用、找引用、citation、bib、参考文献、替换不规范引用、查询作者 H-index、判断期刊/会议质量.

How do I install Citation Assistant in Claude Code?

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

How do I install Citation Assistant in Codex?

Run `npx skills add ZhangNy301/citation-assistant --skill citation-assistant -a codex`. Or copy the skill folder (the ZhangNy301/citation-assistant repository) into .agents/skills/citation-assistant in your project. Codex loads it when a task matches its description.

Can I use Citation 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 ZhangNy301/citation-assistant --skill citation-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/citation-assistant, .gemini/skills/citation-assistant, .github/skills/citation-assistant and .opencode/skills/citation-assistant in your project.

What does Citation Assistant need to run?

Going by SKILL.md and its folder, Citation Assistant needs a shell for the scripts in its folder, the command-line tools its instructions call (bash) and credentials named S2_API_KEY. Our summary lists: A Bash shell; A credential in S2_API_KEY.

Does Citation Assistant access the network?

SKILL.md names 1 domain. In commands or code: semanticscholar.org; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Citation Assistant safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Citation Assistant use?

No licence was found for Citation Assistant or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Citation Assistant use?

About 1.1k tokens (SKILL.md is roughly 4.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 Citation Assistant?

Skills that share tags, products or a category with Citation Assistant: Citation Management (neflibata-feng/MyArxiv-Agent, 126 stars), Literature Review Agent (Ar9av/PaperOrchestra, 679 stars), Academic Search (ustc-ai4science/academic-search, 668 stars) and Arxiv MCP Server (blazickjp/arxiv-mcp-server, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Citation Assistant?

ZhangNy301 (a GitHub user) maintains it in ZhangNy301/citation-assistant, which has 238 GitHub stars. The repository was last updated on March 14, 2026.

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