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.
Search, verify, and map citations for CS/AI/ML papers. An agent skill from joshua-zyy/academic-paper-writer.
Install Academic Citation
$ npx skills add joshua-zyy/academic-paper-writer --skill academic-citation -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install joshua-zyy/academic-paper-writer academic-citation --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/academic-citation .claude/skills/academic-citation && rm -rf skills-srcUse ~/.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/
Install the "academic-citation" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation into .claude/skills/academic-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-citation", 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 install https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citationType 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.
$ npx skills add joshua-zyy/academic-paper-writer --skill academic-citation -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install joshua-zyy/academic-paper-writer academic-citation --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/academic-citation .agents/skills/academic-citation && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "academic-citation" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation into .agents/skills/academic-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-citation", 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 joshua-zyy/academic-paper-writer --skill academic-citation -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install joshua-zyy/academic-paper-writer academic-citation --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/academic-citation .cursor/skills/academic-citation && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "academic-citation" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation into .cursor/skills/academic-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-citation", 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 https://github.com/joshua-zyy/academic-paper-writer.git --path skills/academic-citation--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add joshua-zyy/academic-paper-writer --skill academic-citation -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install joshua-zyy/academic-paper-writer academic-citation --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/academic-citation .gemini/skills/academic-citation && rm -rf skills-srcUse ~/.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/
Install the "academic-citation" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation into .gemini/skills/academic-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-citation", 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 joshua-zyy/academic-paper-writer academic-citationInstalls 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 joshua-zyy/academic-paper-writer --skill academic-citation -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/academic-citation .github/skills/academic-citation && rm -rf skills-srcUse ~/.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/
Install the "academic-citation" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation into .github/skills/academic-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-citation", 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 joshua-zyy/academic-paper-writer --skill academic-citation -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install joshua-zyy/academic-paper-writer academic-citation --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/joshua-zyy/academic-paper-writer.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/academic-citation .opencode/skills/academic-citation && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "academic-citation" agent skill from https://github.com/joshua-zyy/academic-paper-writer/tree/main/skills/academic-citation into .opencode/skills/academic-citation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "academic-citation", 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
academic-citation- GitHub stars
- 115
- Token cost
- ~1.1k tokens
- SKILL.md length
- 416 words
- Files
- 15 (incl. scripts, references)
- Skills in repo
- 8
- Repo updated
- First seen
- Licence
- MIT
At a glance
Search, verify, and map citations for CS/AI/ML papers. An agent skill from joshua-zyy/academic-paper-writer.
- Works in 8 steps: Read manifest.yaml. It declares… → Read every file listed under… → Apply the loaded material as constraints → …
- : finding references for a paper section
- SKILL.md covers Router Protocol, Modes, Agent Dispatch and Independent Use
- Runs Python scripts from its folder; needs MINERU_API_TOKEN
What it does
Academic Citation is an agent skill from joshua-zyy/academic-paper-writer. Search, verify, and map citations for CS/AI/ML papers. Produces VERIFIED/UNVERIFIED reference lists with Citation-to-Claim maps and Exemplar Sets. Use when: finding references for a paper section, verifying citation accuracy, building exemplar sets for introduction/related work learning, checking if existing citations are real and accurate, supplementing local literature library. Triggers on: 找引用, 文献检索, citation pass, find references, reference check, 补文献, citation verification, Exemplar Set, search papers…
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including scripts and reference files (for example `agents/citation_agent.md`, `agents/literature-reader-agent.md` and `manifest.yaml`).
It sits in Research & Science, covering Citation management, Literature review and Scientific writing. The repository describes itself as: 面向 CS / AI / ML 领域的证据驱动、分节推进的论文写作 Agent Skill。 The licence is MIT.
When your agent uses it
- : finding references for a paper section
- Verifying citation accuracy
- Building exemplar sets for introduction/related work learning
- Checking if existing citations are real and accurate
Example prompts
- “/academic-citation”
Requirements
- Python 3
- A credential in MINERU_API_TOKEN
Workflow steps
8 steps, taken from the first numbered list in SKILL.md.
- Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
- Read every file listed under always_load. These are the skill's binding rules — not reference material.
- Apply the loaded material as constraints
- If the user wants to use a local literature library, first distinguish
- For local_ref_pdf_dir, stop before citation search. Tell the user to register a MinerU API token, set MINERU_API_TOKEN, run…
- Detect the workflow using the manifest's workflow axis. Literature reading output must separate source quotes from agent inference; only…
- Echo the selected mode to the user before executing.
- Reach for references/ only when the manifest's references.on_demand condition is satisfied.
What it can do on your machine
Read from SKILL.md and the folder at commit 6fceefd. 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.
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 these keys or tokens, usually read from environment variables:
MINERU_API_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Academic Citation loads about 1.1k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 163 tokens; SKILL.md has 416 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 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); the scripts in this folder are not scanned.
SKILL.md
The full file from joshua-zyy/academic-paper-writer at commit 6fceefd, republished under its MIT licence (© joshua-zyy). 416 words, ~1,092 tokens.
Download SKILL.mdSave it as
.claude/skills/academic-citation/SKILL.md (or your agent's skills folder). This skill also uses 14 other files; get the full folder from GitHub.- name
- academic-citation
- description
- Search, verify, and map citations for CS/AI/ML papers. Produces VERIFIED/UNVERIFIED reference lists with Citation-to-Claim maps and Exemplar Sets. Use when: finding references for a paper section, verifying citation accuracy, building exemplar sets for introduction/related work learning, checking if existing citations are real and accurate, supplementing local literature library. Triggers on: 找引用, 文献检索, citation pass, find references, reference check, 补文献, citation verification, Exemplar Set, search papers, verify citation, 核验文献, 查引用, literature search, reference verification, citation verification with reading, 引用确认, 全文阅读验证.
Academic Citation
将此 skill 视为"文献取证代理"，而不是搜索结果搬运器。
Router Protocol
- Read
manifest.yaml. It declaresalways_loadfiles,axes, andreferences.on_demand. - Read every file listed under
always_load. These are the skill's binding rules — not reference material. - Apply the loaded material as constraints:
stance.mddefines non-negotiable rules, source/inference boundary, and scope.red-lines.mddefines absolute prohibitions. Do not negotiate these.output-contract.mddefines deliverables per mode.anti-patterns.mddefines known failure modes and their correct alternatives.
- If the user wants to use a local literature library, first distinguish:
local_ref_md_dir: an existing Markdown library containing_index_ref.json.local_ref_pdf_dir: a PDF directory, or any local library directory that lacks_index_ref.json.
- For
local_ref_pdf_dir, stop before citation search. Tell the user to register a MinerU API token, setMINERU_API_TOKEN, runscripts/convert-pdfs-to-md.py, and return only after they confirm PDF→MD completion. Do not proceed to local reading until the generated MD directory has_index_ref.json. - Detect the workflow using the manifest's
workflowaxis. Literature reading output must separate source quotes from agent inference; onlysource: 原文orsource: 图片content may be used as citation evidence. - Echo the selected mode to the user before executing.
- Reach for
references/only when the manifest'sreferences.on_demandcondition is satisfied.
Modes
| Mode | Use when |
|---|---|
full-citation-pass | Complete coverage for a full paper or core section |
targeted-citation-search | Specific claim, section, or topic |
exemplar-set-only | Build Exemplar Set only, not full citation list |
citation-verification | Verify metadata of existing candidate list |
local-citation-pass | Local MD library first, then web supplement |
citation-verification-with-reading | Full-text reading after paper draft completion |
Show full SKILL.md (168 more words)Show less
Agent Dispatch
| Agent | Purpose |
|---|---|
agents/citation_agent.md | Literature search strategy (4-class query templates, output schema) |
agents/literature-reader-agent.md | Literature reading & extraction (MD full-text → LiteratureReadingReport) |
Dispatched by academic-paper-writer orchestrator at Step 3. Subagents search and verify only; they must not modify project files or write paper prose independently. literature-reader-agent is dispatched in parallel by citation_agent or the orchestrator at Step 3a/3b.
Independent Use
| Input | Mode | Priority | Behavior |
|---|---|---|---|
| Section + keywords | full-citation-pass | 1 (explicit) | Full 6-step workflow |
| Citation list / seed papers | citation-verification | 1 (explicit) | Metadata only, no extra search |
local_ref_md_dir provided and _index_ref.json exists | local-citation-pass | 2 (path trigger) | Local MD + batch parallel reader agent dispatch |
Local PDF library path provided, or local path lacks _index_ref.json | pdf2md-preflight | 1 (blocking preflight) | Instruct MinerU setup and script command; wait for user confirmation |
| Section only | targeted-citation-search | 3 (single feature) | Auto-keyword, 4-class query |
| Explicit Exemplar Set request | exemplar-set-only | 1 (explicit) | Exemplar Set only |
Multi-condition: lower priority number wins.
| Scenario | Recommended |
|---|---|
| Just searching/verifying citations | This skill (standalone) |
| Integrating into paper drafting | academic-paper-writer orchestrator |
| Existing draft needs citation review | This skill → academic-reviser |
© joshua-zyy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 14 other files (scripts, references) in skills/academic-citation of joshua-zyy/academic-paper-writer.
- SKILL.md
- agents/citation_agent.md
- agents/literature-reader-agent.md
- manifest.yaml
- references/citation-mapping.md
- references/search-strategy.md
- references/verification-protocol.md
- references/workflow-citation-pass.md
- scripts/citation_audit.py
- scripts/convert-pdfs-to-md.py
- scripts/convert_pdfs_to_md_mineru_api.py
- static/core/anti-patterns.md
- static/core/output-contract.md
- static/core/red-lines.md
- static/core/stance.md
Open the folder on GitHubat commit 6fceefd
Compare with similar skills
Academic Citation 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 |
|---|---|---|---|---|---|---|
| Academic Citation this skilljoshua-zyy/academic-paper-writer | 115 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Academic Paper Writing PipelineImbad0202/academic-research-skills | 51k | — | ~16k | Automated safety check: Pass | Custom licence | |
| Academic Research Suite for CodexImbad0202/academic-research-skills-codex | 12k | — | ~12k | Automated safety check: Pass | Custom licence | |
| Autonomous Researchfedericodeponte/opendraft | 507 | — | ~8.2k | Automated safety check: Pass | Apache-2.0 | |
| Social Science Paper Writingfakerqwq/social-science-paper-writing-skill | 382 | — | ~7k | Automated safety check: Pass | None | |
| Academic Integrity Rewritelin1111-1/academic-integrity-rewrite | 102 | — | ~1.1k | Automated safety check: Pass | MIT |
Similar skills
Academic Research Suite for Codex
Imbad0202/academic-research-skills-codex
A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.
Autonomous Research
federicodeponte/opendraft
An 18-agent pipeline that turns one topic line into a drafted research paper, literature review, or thesis chapter.
Social Science Paper Writing
fakerqwq/social-science-paper-writing-skill
Helps draft, diagnose, review and revise social science papers, from topic and research question to literature review, citation risks and pre-submission checks.
Academic Integrity Rewrite
lin1111-1/academic-integrity-rewrite
Revise Chinese or English academic writing for lower unnecessary textual overlap while preserving meaning, evidence, numbers, equations, terminology, and citations.
Paper Skill
cLin-c/paper-skill
End-to-end, Chinese-first academic research and publication workflow for reading papers, literature reviews, research framing, manuscript planning and writing, Chinese-English translation, LaTeX…
More from joshua-zyy/academic-paper-writer
All 8 skills in this repoAcademic Experiments
joshua-zyy/academic-paper-writer
Audit, run, or verify experimental evidence for CS/AI/ML papers.
Academic Figure
joshua-zyy/academic-paper-writer
Create, revise, or audit academic data/result figures for CS/AI/ML papers.
Academic Reviser
joshua-zyy/academic-paper-writer
Self-review, audit, or verify CS/AI/ML paper drafts as a critical peer reviewer.
Academic Paper Writer
joshua-zyy/academic-paper-writer
A skill your agent uses when writing or revising CS/AI/ML papers from research notes, code repositories, local literature libraries, target venue requirements, or section-level drafting requests.
Academic Polishing
joshua-zyy/academic-paper-writer
Polish academic prose, de-AI-ify text, control claim strength, or rewrite method sections for CS/AI/ML papers.
Academic Venue Research
joshua-zyy/academic-paper-writer
Research target venue requirements and writing style for CS/AI/ML papers.
Related
Categories
Questions about Academic Citation
What does Academic Citation do?
Search, verify, and map citations for CS/AI/ML papers. An agent skill from joshua-zyy/academic-paper-writer. Academic Citation is an agent skill from joshua-zyy/academic-paper-writer. Search, verify, and map citations for CS/AI/ML papers.
When should I use Academic Citation?
Academic Citation fits situations like: : finding references for a paper section; verifying citation accuracy; building exemplar sets for introduction/related work learning; checking if existing citations are real and accurate.
How do I install Academic Citation in Claude Code?
Run `npx skills add joshua-zyy/academic-paper-writer --skill academic-citation -a claude-code`. Or copy the skill folder (skills/academic-citation in joshua-zyy/academic-paper-writer) into .claude/skills/academic-citation in your project. Claude Code loads it when a task matches its description.
How do I install Academic Citation in Codex?
Run `npx skills add joshua-zyy/academic-paper-writer --skill academic-citation -a codex`. Or copy the skill folder (skills/academic-citation in joshua-zyy/academic-paper-writer) into .agents/skills/academic-citation in your project. Codex loads it when a task matches its description.
Can I use Academic Citation 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 joshua-zyy/academic-paper-writer --skill academic-citation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/academic-citation, .gemini/skills/academic-citation, .github/skills/academic-citation and .opencode/skills/academic-citation in your project.
What does Academic Citation need to run?
Going by SKILL.md and its folder, Academic Citation needs Python for the scripts in its folder and credentials named MINERU_API_TOKEN. Our summary lists: Python 3; A credential in MINERU_API_TOKEN.
Does Academic Citation 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 Academic Citation 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Academic Citation use?
Academic Citation 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 Academic Citation use?
About 1.1k tokens (SKILL.md is roughly 4.4k 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 3.6k tokens, read only when the agent opens those files.
What are the alternatives to Academic Citation?
Skills that share tags, products or a category with Academic Citation: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Research Suite for Codex (Imbad0202/academic-research-skills-codex, 12k stars), Autonomous Research (federicodeponte/opendraft, 507 stars) and Social Science Paper Writing (fakerqwq/social-science-paper-writing-skill, 382 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Academic Citation?
joshua-zyy (a GitHub user) maintains it in joshua-zyy/academic-paper-writer, which has 115 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 5, 2026.
Source: joshua-zyy/academic-paper-writer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.