Academic Research Skills Codex

# Academic Research Skills for Codex

> Skill by [ara.so](https://ara.so) — Codex Skills collection.

This skill provides a comprehensive suite of AI-assisted academic research workflows including deep research, paper writing, peer review, and end-to-end research pipelines. Originally designed for Claude Code, this Codex-native package routes requests to specialized research agents based on user intent.

## What It Does

Academic Research Skills (ARS) for Codex provides five core workflows:

1. **Deep Research** - Literature reviews, systematic reviews, research question refinement, fact-checking
2. **Academic Paper** - Outlining, drafting, citation formatting, revision, AI disclosure
3. **Academic Paper Reviewer** - Manuscript review, simulated peer review, editorial decisions
4. **Academic Pipeline** - End-to-end research-to-publication workflow with integrity gates
5. **Experiment Agent** - Code experiment planning, study protocols, reproducibility validation

## Installation

Install using the Codex skill installer with git method:

```bash
python "$HOME/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo Imbad0202/academic-research-skills-codex \
  --ref main \
  --path skills/academic-research-suite \
  --method git
```

### Update Existing Installation

```bash
rm -rf "$HOME/.codex/skills/academic-research-suite"
python "$HOME/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py" \
  --repo Imbad0202/academic-research-skills-codex \
  --ref main \
  --path skills/academic-research-suite \
  --method git
```

After installation, open a new Codex conversation to activate the skill.

### Verify Installation

```text
/skills
```

You should see one entry: `academic-research-suite`. You should NOT see separate entries for `academic-paper`, `deep-research`, etc.

## Core Usage Patterns

### Basic Invocation

Use `$academic-research-suite` followed by your research task:

```text
Use $academic-research-suite to help me plan a systematic literature review on
AI adoption in higher education quality assurance.
```

The Codex adapter automatically routes to the appropriate workflow based on your request.

### Workflow Selection

| Workflow | When to Use | Example Trigger |
|----------|-------------|-----------------|
| `deep-research` | Need research question refinement, literature review, fact-checking | "conduct a systematic review on..." |
| `academic-paper` | Need paper outline, drafting, citations, revision | "write a research paper about..." |
| `academic-paper-reviewer` | Need manuscript review, peer review simulation | "review this research manuscript..." |
| `academic-pipeline` | Need full research-to-publication workflow | "run end-to-end pipeline from topic to paper" |
| `experiment-agent` | Need code experiment design, study protocols | "plan a reproducible code experiment..." |

### Structured Request Pattern

For best results, provide goal, current state, and constraints:

```text
Use $academic-research-suite.

Goal: write a journal article on AI in higher education QA
Current materials: literature matrix and rough findings, no outline yet
Output needed: paper architecture and evidence checklist
Constraints: English, APA 7, policy audience
```

## Command Aliases

Codex emulates Claude Code `/ars-*` commands as aliases:

| Alias | Workflow | Purpose |
|-------|----------|---------|
| `ars-plan` | academic-paper | Create paper plan/structure |
| `ars-outline` | academic-paper | Generate outline only |
| `ars-abstract` | academ