Agent skill

Academic Research Suite for Codex

by Imbad0202 in 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.

Custom licenceAuto-check passedResearch & Science

Install Academic Research Suite for Codex

skills CLI
$ npx skills add Imbad0202/academic-research-skills-codex --skill academic-research-suite -a claude-code

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

GitHub CLI
$ gh skill install Imbad0202/academic-research-skills-codex academic-research-suite --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/Imbad0202/academic-research-skills-codex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/academic-research-suite .claude/skills/academic-research-suite && 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/

Facts

Skill name
academic-research-suite
GitHub stars
12k
Token cost
~12k tokens
SKILL.md length
5,402 words
Files
3,115
Skills in repo
1
Repo updated
First seen
Licence
Custom licence

At a glance

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.

  • Works in 3 steps: Explicit clear intent — user invokes a… → Cross-phase materials detected — user… → Ambiguous intent, no materials — user…
  • Running a systematic literature review or meta-analysis
  • SKILL.md covers Versioning, First Rule, Workflow Router and Claude-Style Alias Router, plus 10 more sections
  • Calls claude; needs ARS_OPENAI_COMPAT_API_KEY and S2_API_KEY

What it does

This is a Codex adapter for the ARS suite, with the vendored ARS content under `ars/`. Its first rule is not to load the whole suite: the agent selects one workflow, reads that workflow's `WORKFLOW.md`, and loads only the agent, reference, template or shared files needed for your current stage. Internal entry files are named `WORKFLOW.md` rather than `SKILL.md` so Codex registers just this root router.

Routing follows a shared core: a `[direct-mode]` prefix on the first message skips cross-phase clarification, and explicit aliases such as `/ars-lit-review`, `/ars-citation-check`, `/ars-abstract`, `/ars-revision`, `/ars-reviewer` and `/ars-full` go straight to their workflow. Topics include deep research, systematic reviews, meta-analysis, study screening with `sr-screener`, drafts, integrity checks and peer review, with trigger phrases in English, Korean, Spanish and Chinese. Tool access is limited to reading, searching, web search and Python or `uv` commands.

When your agent uses it

  • Running a systematic literature review or meta-analysis
  • Checking citations and reference formatting in a draft
  • Getting a peer-review style critique of a manuscript
  • Drafting an abstract, outline or revision plan for a paper

Example prompts

  • “/ars-lit-review on the effect of sleep on adolescent test scores.”
  • “Check the citations in thesis/chapter2.md and flag any that do not match the reference list.”
  • “Run the reviewer workflow on my manuscript and help me plan a rebuttal.”
  • “Screen these study records for my systematic review with sr-screener.”

Requirements

  • Python or `uv` available for the suite's scripts
  • Pre-approved tools (allowed-tools): Read, Glob, Grep, WebSearch, Bash(uv *), Bash(python *), Bash(python3 *)

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Explicit clear intent — user invokes a specific skill via /ars-* slash command, or uses an unambiguous trigger keyword that maps to a…
  2. Cross-phase materials detected — user provides artifacts spanning ≥ 2 pipeline phases without naming a specific skill (e.g., pre-written…
  3. Ambiguous intent, no materials — user provides no artifacts and no clear request

What it can do on your machine

Read from SKILL.md and the folder at commit 52228e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • WebSearch
    • Bash(uv *)
    • Bash(python *)
    • Bash(python3 *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude

    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:

    • ARS_OPENAI_COMPAT_API_KEY
    • S2_API_KEY
    • OPENALEX_API_KEY

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

Context cost

Academic Research Suite for Codex loads about 12k tokens when it runs. Until then it costs about 234 tokens; SKILL.md has 5,402 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 5,402 words (~11,745 tokens).

“This is a Codex adapter for the ARS suite. The vendored ARS content lives under ars/; keep it as source material and route through this file first.”

— opening of SKILL.md by Imbad0202, Custom licence
name
academic-research-suite
allowed-tools
Read, Glob, Grep, WebSearch, Bash(uv *), Bash(python *), Bash(python3 *)
metadata.version
3.23.0
metadata.upstream_suite
academic-research-skills
metadata.codex_adapter
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 3,114 other files in skills/academic-research-suite of Imbad0202/academic-research-skills-codex.

  • SKILL.md
  • agents/openai.yaml
  • ars/.command-invariants.toml
  • ars/.gitattributes
  • ars/.github/FUNDING.yml
  • ars/.github/copilot-instructions.md
  • ars/.github/pull_request_template.md
  • ars/.github/workflows/changelog-covers-merges.yml
  • ars/.github/workflows/command-invariants.yml
  • ars/.github/workflows/defer-label-gate.yml
  • ars/.github/workflows/eval-harness.yml
  • ars/.github/workflows/freshness-check.yml
  • ars/.github/workflows/harness-retirement-monthly.yml
  • ars/.github/workflows/platform-port-reminder.yml
  • ars/.github/workflows/pr-closes-issue.yml
  • ars/.github/workflows/pytest.yml
  • ars/.github/workflows/release-cooldown.yml
  • … and 3,098 more

Open the folder on GitHubat commit 52228e8

Compare with similar skills

Academic Research Suite for Codex 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.

Academic Research Suite for Codex compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Academic Research Suite for Codex this skillImbad0202/academic-research-skills-codex12k—~12kAutomated safety check: PassCustom licence
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence
Social Science Paper Writingfakerqwq/social-science-paper-writing-skill382—~7kAutomated safety check: PassNone
Deep Research WorkflowTokenRhythm/opensquilla7.1k—~1.3kAutomated safety check: PassApache-2.0
Deep Research Agent TeamImbad0202/academic-research-skills51k—~13kAutomated safety check: PassCustom licence

Similar skills

  • 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 yesterday
    Research & ScienceAuto-check passed
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • 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.

    382 GitHub stars~7k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed
  • Deep Research Workflow

    TokenRhythm/opensquilla

    Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.

    7.1k GitHub stars~1.3k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Deep Research Agent Team

    Imbad0202/academic-research-skills

    Runs a 13-agent pipeline for rigorous academic research, from forming the question through systematic search, synthesis, bias checks and an APA 7.0 report.

    51k GitHub stars~13k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Autonomous Research

    federicodeponte/opendraft

    An 18-agent pipeline that turns one topic line into a drafted research paper, literature review, or thesis chapter.

    507 GitHub stars~8.2k tokensUpdated 9 days ago
    Research & ScienceAuto-check passed

Questions about Academic Research Suite for Codex

What does Academic Research Suite for Codex do?

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. This is a Codex adapter for the ARS suite, with the vendored ARS content under `ars/`.md`, and loads only the agent, reference, template or shared files needed for your current stage.

When should I use Academic Research Suite for Codex?

Academic Research Suite for Codex fits situations like: running a systematic literature review or meta-analysis; checking citations and reference formatting in a draft; getting a peer-review style critique of a manuscript; drafting an abstract, outline or revision plan for a paper.

How do I install Academic Research Suite for Codex in Claude Code?

Run `npx skills add Imbad0202/academic-research-skills-codex --skill academic-research-suite -a claude-code`. Or copy the skill folder (skills/academic-research-suite in Imbad0202/academic-research-skills-codex) into .claude/skills/academic-research-suite in your project. Claude Code loads it when a task matches its description.

How do I install Academic Research Suite for Codex in Codex?

Run `npx skills add Imbad0202/academic-research-skills-codex --skill academic-research-suite -a codex`. Or copy the skill folder (skills/academic-research-suite in Imbad0202/academic-research-skills-codex) into .agents/skills/academic-research-suite in your project. Codex loads it when a task matches its description.

Can I use Academic Research Suite for Codex 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 Imbad0202/academic-research-skills-codex --skill academic-research-suite -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-research-suite, .gemini/skills/academic-research-suite, .github/skills/academic-research-suite and .opencode/skills/academic-research-suite in your project.

What does Academic Research Suite for Codex need to run?

Going by SKILL.md and its folder, Academic Research Suite for Codex needs the command-line tools its instructions call (claude) and credentials named ARS_OPENAI_COMPAT_API_KEY, S2_API_KEY and OPENALEX_API_KEY. Our summary lists: Python or `uv` available for the suite's scripts. Its frontmatter pre-approves these tools: Read, Glob, Grep, WebSearch, Bash(uv *), Bash(python *), Bash(python3 *).

Does Academic Research Suite for Codex 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 Research Suite for Codex 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 Academic Research Suite for Codex use?

Academic Research Suite for Codex has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Academic Research Suite for Codex use?

About 12k tokens (SKILL.md is roughly 47k 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 Academic Research Suite for Codex?

Skills that share tags, products or a category with Academic Research Suite for Codex: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Research Pipeline (Imbad0202/academic-research-skills, 51k stars), Social Science Paper Writing (fakerqwq/social-science-paper-writing-skill, 382 stars) and Deep Research Workflow (TokenRhythm/opensquilla, 7.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Research Suite for Codex?

Imbad0202 (a GitHub user) maintains it in Imbad0202/academic-research-skills-codex, which has 12,461 GitHub stars. The repository was last updated on October 3, 2026.

Source: Imbad0202/academic-research-skills-codex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.