Academic Research Skills for Claude Code
Five Claude Code skills that take an academic paper from research question to reviewed, checked draft, pausing for your approval at each stage.
- Skills
- 5
- included
- Hooks
- 2
- included
- Agents
- 4
- included
- Commands
- 16
- included
- Stars
- 54.9K
- on GitHub
academic-research-skills makes Claude Code work through a paper in stages: research, write, check integrity, review, revise and finalize. It stops for your confirmation at every stage, so you stay the author. The plugin adds a set of slash commands, with /ars-plan to plan a paper and /ars-full to run the whole pipeline. One thing to know first: it checks that cited works exist and that claims match their sources, but the author says it cannot prove your data are real, and the license (CC BY-NC 4.0) rules out commercial use.
Good for
- Researchers and graduate students drafting a paper with Claude Code
- Authors who want a simulated peer review before submitting
- Teams running systematic or scoping reviews who need study screening
- Anyone who must check that every cited reference really exists
Install academic-research-skills
Claude Code
- 1
Copy this prompt.
Install the academic-research-skills plugin in Claude Code. Run this command: /plugin marketplace add Imbad0202/academic-research-skills /plugin install academic-research-skills Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
The plugin install includes the hooks, commands and agents. Copying folders gives you the five skills only. Update the plugin with /plugin update academic-research-skills.
From the project README. Source.
Key facts
- Author
- Cheng-I Wu (Imbad0202)
- Version
- 3.24.0, released 2026-10-27
- Last commit
- 2026-11-01
- Created
- 2026-02-26
- Author's mode count
- 35 modes and 43 prompt roles, as claimed by the author
What it includes
Plan a paper chapter by chapter with Socratic questions
Claude asks you questions and helps you decide each chapter before any drafting starts.
Try: “Guide me through writing a paper on demographic decline”
Write ·
/ars-planRun the full research-to-final-paper pipeline
Runs the whole pipeline: research, write, integrity check, review, revise and finalize, stopping for your approval at each stage.
Try: “I want to write a research paper on AI's impact on higher education QA”
Write ·
/ars-fullMake a detailed outline and evidence map
Builds an outline plus a map of which evidence supports which section.
Write ·
/ars-outlineWrite an annotated bibliography
Produces an annotated bibliography formatted as part of a paper.
Write ·
/ars-lit-reviewCompare papers by WHY, HOW and WHAT
Compares several papers side by side on why they were written, how they work and what they find.
Write ·
/ars-3wGet a simulated peer review panel
Runs a mock review panel on your draft and returns their comments.
Try: “Review this paper”
Write ·
/ars-reviewerRevise a draft and answer reviewers
Produces a revised draft and point-by-point responses to reviewer comments.
Write ·
/ars-revisionTurn reviewer comments into a plan
Reads reviewer comments and gives you a ranked roadmap for the revision.
Write ·
/ars-revision-coachCheck a rebuttal against the reviews
Checks your rebuttal draft against the original reviews and flags points you missed.
Read ·
/ars-rebuttal-auditWrite a bilingual abstract and keywords
Drafts an abstract in two languages with keywords.
Write ·
/ars-abstractConvert to LaTeX, DOCX, PDF or Markdown
Converts the paper between formats. DOCX needs Pandoc and PDF needs tectonic.
Runs code ·
/ars-format-convertGet a citation error report
Checks each reference against public indexes and reports the ones that look wrong or unsupported.
Try: “Check citations”
Network ·
/ars-citation-checkDraft an AI-use disclosure for a venue
Writes an AI-usage statement that fits a specific journal or conference.
Write ·
/ars-disclosureRecord that you read a cited work
Marks a cited work as read by you, so the record shows which sources a person checked.
Write ·
/ars-mark-readWithdraw a read record
Removes your read mark from a cited work.
Write ·
/ars-unmark-readDrop cached results for a citation
Clears saved verification results for one citation so it is checked again.
Delete ·
/ars-cache-invalidateResearch team: sources, synthesis, systematic review
Runs a team of research roles that frame the question, search the literature, check sources and synthesize findings. Modes include quick, lit-review, fact-check, socratic and systematic-review with optional meta-analysis.
Try: “Do a systematic review on X with PRISMA”
Write ·
deep-researchPlan, draft and revise the paper
Plans, drafts and revises a paper. Modes include outline-only, abstract-only, citation-check, disclosure and rebuttal-audit.
Write ·
academic-paperFive-seat simulated peer review panel
Simulates a journal-fit reviewer, three reviewers and a devil's advocate. Live reviews are labelled NOT_CALIBRATED.
Write ·
academic-paper-reviewerChain research, writing and review with checkpoints
Orchestrates the other skills in 10 stages, with mandatory integrity checks before and after review and a process summary at the end.
Write ·
academic-pipelineScreen studies for systematic reviews
Screens studies with two blinded AI reviewers and an adjudicator. Reads RIS, PubMed .nbib, Web of Science and CSV, and outputs PRISMA 2020 counts and RIS groups.
Try: “Screen these database exports”
Write ·
sr-screenerUsed by the assistant behind the scenes
Subagent: merges findings across sources
Merges findings across sources, resolves conflicts and maps gaps.
Read ·
synthesis_agentSubagent: designs the methodology
Designs the methodology blueprint for a study.
Read ·
research_architect_agentSubagent: compiles APA 7.0 reports
Turns findings into an APA 7.0 report.
Write ·
report_compiler_agentSubagent: blinded screener for sr-screener
One of the blinded reviewers used by sr-screener.
Read ·
screening_reviewer_agentLists /ars-* commands and checks for updates
Runs announce-ars-loaded.sh at session start. It adds a note listing the commands and at most once a day fetches plugin.json from GitHub. ARS_UPDATE_CHECK=0 turns this off.
Runs code ·
SessionStart hookLocal guard that blocks out-of-scope ARS writes
Runs run_guard.sh before each write, edit or shell call. It finds Python and runs a guard that denies out-of-scope writes and all Bash for fenced ARS subagents. No network; passes through if Python is missing.
Runs code ·
PreToolUse hook (Write, Edit, MultiEdit, Bash)
From the official docs
Permissions
Medium risk
The plugin installs hooks that run shell commands around your tool calls, and citation checks send reference titles to public indexes. Leave the cross-model option off for unpublished work, and set ARS_UPDATE_CHECK=0 if you do not want the daily update check.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
A hook runs before every write and shell call
The PreToolUse hook runs hooks/run_guard.sh before every Write, Edit, MultiEdit and Bash call in any session where the plugin is on. It starts a local Python guard that blocks out-of-scope writes by ARS subagents and makes no network calls. github.com
Opt-in cross-model checks can send your manuscript out
With ARS_CROSS_MODEL set and your consent each session, integrity samples or the full paper can go to OpenAI or Google using your own keys. It is off by default, so leave it unset for unpublished work. github.com
The write guard has blocked edits outside ARS work
Older versions blocked CLAUDE.md edits in every project (the author says fixed in v3.13.0). In Copilot's cloud agent the guard still refuses every edit, and on Windows it can slow down tool calls. github.com
A start-of-session hook checks for updates
The SessionStart hook runs scripts/announce-ars-loaded.sh, which lists the /ars-* commands and, at most once a day, fetches plugin.json from GitHub to compare versions. No user data is sent. Set ARS_UPDATE_CHECK=0 to turn it off. github.com
Reference titles and IDs go to four public indexes
Citation checks send DOIs, arXiv IDs and reference titles to Semantic Scholar, OpenAlex, Crossref and arXiv. If your reference list is confidential, skip the verification scripts. github.com
Your drafts and instructions are saved to local files
The Material Passport and run ledger record your instructions and checkpoint answers next to the path you choose. Integrity checks can save full source texts there, so keep them out of shared folders. github.com
Security advisories
No published security advisories as of Nov 2, 2026.
Technical details
| Turning on read-only | No global read-only switch. Prompt-only modes make no network calls. Set ARS_UPDATE_CHECK=0 to stop the daily update check, and skip the citation verification scripts to avoid lookups. |
|---|---|
| Talks to | api.semanticscholar.org, api.openalex.org, api.crossref.org and arxiv.org (citation lookups: DOIs, arXiv IDs, reference titles). raw.githubusercontent.com (once-a-day update check, no user data). OpenAI or Google APIs only if you turn on ARS_CROSS_MODEL and consent per session |
| Sign-in and keys | No ARS account or key needed. Optional S2_API_KEY and OPENALEX_API_KEY raise lookup limits. |
| Data retention | Citation results are cached locally for 90 days. The author states there is no telemetry or analytics endpoint. |
| Scopes |
|
Works in
It is built for Claude Code. Other clients get a reduced version or none.
Tap an app to see how to set it up and any known problems.
Claude Desktop
SupportedCowork: upload each skill as a zip. Skills run alone, without the multi-agent pipeline. GitHub
Codex
SupportedUse the author's separate Codex repo, packaged as one $academic-research-suite skill. GitHub
Claude Code
Has issuesPlugin works in the CLI, VS Code and JetBrains. Copying the skill folders also works, without hooks.
Known problems
- Open
On Windows with the Python Install Manager, each write-guard launch leaks about 1.5 MB in AppXSvc
Since Oct 2026 · GitHub
Copilot CLI
Not supportedNot supported. The write guard was built for Claude Code's tool shapes.
Known problems
- Open
In Copilot's cloud agent the write guard refused every edit
Since Oct 2026 · GitHub
Gemini CLI
Not supportedNo official support. A community port is in progress. GitHub
OpenCode
Not supportedNot planned. The author says ARS depends on Claude Code's agent dispatch. GitHub
What people say
People like the structured planning and the integrity checks, and doubt that anyone has shown it beats plain prompting.
What people like
- Reviewers like the Socratic planning mode, which asks you to state, challenge and reflect on each point.
- A PhD student on GitHub said the PRISMA and risk-of-bias flow in deep-research saved a lot of wasted effort.
- Supporters note the repo documents its testing and the flaws of earlier designs.
Common complaints
- Hacker News skeptics call it unvalidated 'skill spam' with no benchmark against simply asking Claude for help.
- One reader said it claims human-in-the-loop but reads close to full automation.
- Paywalled papers and bot protection limit what the research stage can reach.
- The author says no one has reported publication or grant outcomes to him so far.
In their words
“There needs to be a new name for people creating these with no obvious validation. Skill spam?”apwheeleHacker NewsMay 2026
“While I agree most of this seems to go too far I do like the idea of the Socratic mode with State-Challenge-Reflect reflection.”janpeukerHacker NewsMay 2026
“The site opens with how it keeps humans in the loop, but when you continue reading it seems almost a full automation feature.”SubiculumCodeHacker NewsMay 2026
“Academic skills requires proper tools as well, since many research papers are either behind paywalls or protected by bot-detection systems.”mdxmaker
Included in this plugin
5
- academic-paper
12-agent academic paper writing pipeline. 11 modes (full/plan/outline/revision/revision-coach/abstract/lit-review/format-convert/citation-check/disclosure/rebuttal-audit). 6 paper types, 5 citation formats, bilingual abstracts, LaTeX/DOCX-via-Pandoc/PDF output. Style Calibration + Writing Quality Ch
11K installs - academic-paper-reviewer
Multi-perspective academic paper review with dynamic reviewer personas. Runs a 5-seat, role-separated review panel (Journal-Fit Reviewer + 3 peer-review roles + Devil's Advocate) with field-specific expertise; role separation is not a claim of independent error processes. Supports full review, re-re
10K installs - academic-pipeline
Orchestrator for the full academic research pipeline: research -> write -> integrity check -> review -> revise -> re-review -> re-revise -> final integrity check -> finalize. Coordinates deep-research, academic-paper, and academic-paper-reviewer into a seamless 10-stage workflow with mandatory, cove
7.4K installs - deep-research
Universal deep research agent team. 13-agent pipeline for rigorous academic research on any topic. 8 modes: full research, quick brief, paper review, lit-review, fact-check, three-way literature scan, Socratic guided research dialogue, and systematic review with optional meta-analysis. Covers resear
7.8K installs - sr-screener
Protocol-driven study screening for systematic, scoping and rapid reviews. Turns a proposal or PROSPERO protocol into confirmed eligibility rules, then screens titles/abstracts and full texts with two blinded AI reviewers and a third-reviewer adjudicator: ordered exclusion codes, no silent defaults,
586 installs
Questions
How do I install academic-research-skills?
Use the install box above for Claude Code. After installing, run /ars-plan and describe a paper to check it works. The box also has steps for Cowork in Claude Desktop, a claude.ai Project and Codex.
Is academic-research-skills safe?
Mostly, with two things to know. It installs hooks: one runs a local Python guard before every write or shell call, and one checks GitHub once a day for updates. Citation checks send reference titles to public indexes, and the opt-in cross-model option can send your manuscript to OpenAI or Google.
Can I use it commercially?
No. It is licensed CC BY-NC 4.0, so you can share and adapt it with credit to Cheng-I Wu, but not for commercial purposes. If you work at a company or sell services built on it, ask the author for terms first.
Will it stop fake or hallucinated citations?
It lowers the risk but does not remove it. The author's citation gate checks that each cited work exists in Semantic Scholar, OpenAlex, Crossref or arXiv, and the claim audit flags cases where a source does not support the claim. The author says it cannot prove procedures were done, data are real or results reproduce, and a consistently reported fabrication can pass.
How accurate is the citation check in practice?
The author's own March 2026 showcase run had 21 of 68 final references with problems in a later audit, even after three rounds of integrity checks. That run predates the current citation gate. The opt-in claim audit has no recorded calibration result yet, so check your references yourself before you submit.
What does each of the five skills do?
deep-research finds and synthesizes sources and runs systematic reviews. academic-paper plans and drafts the paper and handles abstracts, citation checks and AI disclosure. academic-paper-reviewer simulates a five-seat peer review panel. academic-pipeline chains the three in order with checkpoints. sr-screener screens studies for systematic reviews with two blinded AI reviewers and an adjudicator. The author's README says the suite has 35 modes in total.
Does it work in Codex, Cursor or the Claude app?
Codex: yes, through the author's separate Codex repo. Claude desktop (Cowork): the skills run one at a time, but not the full pipeline. claude.ai web: not as a plugin. Cursor is not mentioned in the author's docs, so treat it as unsupported.
What does it cost to run?
The suite is free. The author estimates about US$3 to 7 in model usage for a full pipeline run on a 15,000-word paper at September 2026 list prices, before cache discounts.
Does it help me disclose AI use?
Yes. The disclosure mode (/ars-disclosure) drafts an AI-usage statement for a specific venue. The author says the tool is not meant to hide AI use, and that you remain the author and answer for every claim.
academic-research-skills vs other Claude research skills?
Pick this when you want one guided pipeline from research to review. AI-research-feedback (MIT) only writes pre-submission referee reports, and scientific-agent-skills (K-Dense, MIT) is a broad library of science skills rather than one paper workflow. Browse more in skills for science.
Information
updated Nov 2, 2026
- Runs in
- Claude Code
- Repository
- imbad0202/academic-research-skills
Sources
Docs, issue trackers and discussions this page is built from.
Show all 24Hide
- Project with GitHub files · github.com
- Academic Research Skills for Claude Code (README) · github.com
- Project skills folder · github.com
- Upload skills (Cowork) · github.com
- Codex plugin (separate repo) · github.com
- LICENSE · github.com
- SETUP.md · github.com
- hooks.json · github.com
- commands/ · github.com
- agents/ · github.com
- DATA_FLOWS.md · github.com
- SECURITY.md · github.com
- Copilot cloud agent issue · github.com
- AI-research-feedback · github.com
- scientific-agent-skills · github.com
- ARS performance and cost · github.com
- Post-publication audit report (showcase) · github.com
- Academic Research Skills for Claude Code · news.ycombinator.com
- Thank-you note on deep-research PRISMA flow · github.com
- Support Perplexity AI · github.com
- Gemini/Antigravity support? · github.com
- Windows: prefer a Python outside WindowsApps so the guard launcher does not start the Install Manager · github.com
- Want the OpenCode version please! · github.com
- academic-research-skills-codex · github.com