Academic Research Suite for Codex
This is the Codex router for the Academic Research Skills suite. It expects the
suite content to live under ars/. Install with:
.\scripts\install-codex-skill.ps1 -Force
or:
./scripts/install-codex-skill.sh --force
After installation, restart Codex or open a new Codex conversation and invoke:
Use $academic-research-suite to plan a literature review on ...
First Rule
Do not load the whole suite by default. Select one workflow, read that
workflow's SKILL.md, then load only the agent, reference, template, or shared
files needed for the user's current stage.
Workflow Router
Choose the workflow by intent:
| User intent |
Read first |
| Deep research, literature review, systematic review, meta-analysis, fact-checking, research-question refinement |
ars/deep-research/SKILL.md |
| Academic paper writing, paper outline, abstract, revision, citation formatting, AI disclosure, LaTeX/DOCX/PDF formatting guidance |
ars/academic-paper/SKILL.md |
| Paper review, peer review simulation, editorial decision, reviewer calibration, re-review after revision |
ars/academic-paper-reviewer/SKILL.md |
| End-to-end research-to-paper pipeline, integrity gates, staged review/revision/finalization workflow |
ars/academic-pipeline/SKILL.md |
If a request spans multiple workflows, start with
ars/academic-pipeline/SKILL.md unless the user clearly asks for a single
phase.
Paper Topic Scoping Override
If the user wants to write a paper, thesis, proposal, article, or manuscript,
but only provides a broad topic, tentative title, or research direction without
a clear answerable research question, route to ars/deep-research/SKILL.md in
Socratic mode first.
First response in this path:
- State that the request is being routed to deep-research Socratic mode because
the research question is not yet precise.
- Ask 3-5 narrowing questions.
- Do not produce an outline, draft, literature review, or full pipeline
dashboard until at least one candidate research question is clear.
Alias Router
Codex does not install Claude slash commands, but this package emulates their
intent through plain aliases:
| Alias |
Route |
ars-plan |
ars/academic-paper/SKILL.md in plan mode |
ars-outline |
ars/academic-paper/SKILL.md in outline-only mode |
ars-abstract |
ars/academic-paper/SKILL.md in abstract-only mode |
ars-lit-review |
ars/academic-paper/SKILL.md lit-review mode, or ars/deep-research/SKILL.md lit-review mode when source discovery is needed |
ars-citation-check |
ars/academic-paper/SKILL.md citation-check mode |
ars-disclosure |
ars/academic-paper/SKILL.md disclosure mode |
ars-format-convert |
ars/academic-paper/SKILL.md format-convert mode |
ars-revision-coach |
ars/academic-paper/SKILL.md revision-coach mode |
ars-revision |
ars/academic-paper/SKILL.md revision mode |
ars-full |
ars/academic-pipeline/SKILL.md full workflow |
If a slash-prefixed alias is intercepted by the client, tell the user to use the
plain alias form, for example ars-plan my topic.
Codex Runtime Mapping
- Treat upstream "agent" files as scoped role prompts to perform inline.
- Do not spawn Codex subagents automatically. Use subagents only when the user
explicitly asks for parallel delegation.
- Use Codex web browsing for current facts, source verification, citation
checks, and external evidence, and provide source links.
- Treat Claude-specific hook and plugin metadata as upstream traceability only.
- Preserve independence in multi-review phases: write each reviewer section
before synthesizing.
Shared Resources
Resolve upstream relative paths under ars/:
shared/... -> ars/shared/...scripts/... -> ars/scripts/...examples/... -> ars/examples/...docs/... -> ars/docs/...
If ars/ is missing, stop and ask the user to run the Codex installer script
from the repository root.
1---2name: academic-research-suite3description: Codex-native Academic Research Skills router for deep research, literature review, systematic review, academic paper writing, manuscript review, citation checks, disclosure, full research-to-paper pipelines, and experiment planning or validation. Supports aliases such as ars-plan, ars-outline, ars-abstract, ars-lit-review, ars-citation-check, ars-disclosure, ars-format-convert, ars-revision-coach, ars-revision, and ars-full.4---56# Academic Research Suite for Codex78This is the Codex router for the Academic Research Skills suite. It expects the9suite content to live under `ars/`. Install with:1011```powershell12.\scripts\install-codex-skill.ps1 -Force13```1415or:1617```bash18./scripts/install-codex-skill.sh --force19```2021After installation, restart Codex or open a new Codex conversation and invoke:2223```text24Use $academic-research-suite to plan a literature review on ...25```2627## First Rule2829Do not load the whole suite by default. Select one workflow, read that30workflow's `SKILL.md`, then load only the agent, reference, template, or shared31files needed for the user's current stage.3233## Workflow Router3435Choose the workflow by intent:3637| User intent | Read first |38|---|---|39| Deep research, literature review, systematic review, meta-analysis, fact-checking, research-question refinement | `ars/deep-research/SKILL.md` |40| Academic paper writing, paper outline, abstract, revision, citation formatting, AI disclosure, LaTeX/DOCX/PDF formatting guidance | `ars/academic-paper/SKILL.md` |41| Paper review, peer review simulation, editorial decision, reviewer calibration, re-review after revision | `ars/academic-paper-reviewer/SKILL.md` |42| End-to-end research-to-paper pipeline, integrity gates, staged review/revision/finalization workflow | `ars/academic-pipeline/SKILL.md` |4344If a request spans multiple workflows, start with45`ars/academic-pipeline/SKILL.md` unless the user clearly asks for a single46phase.4748## Paper Topic Scoping Override4950If the user wants to write a paper, thesis, proposal, article, or manuscript,51but only provides a broad topic, tentative title, or research direction without52a clear answerable research question, route to `ars/deep-research/SKILL.md` in53Socratic mode first.5455First response in this path:56571. State that the request is being routed to deep-research Socratic mode because58 the research question is not yet precise.592. Ask 3-5 narrowing questions.603. Do not produce an outline, draft, literature review, or full pipeline61 dashboard until at least one candidate research question is clear.6263## Alias Router6465Codex does not install Claude slash commands, but this package emulates their66intent through plain aliases:6768| Alias | Route |69|---|---|70| `ars-plan` | `ars/academic-paper/SKILL.md` in plan mode |71| `ars-outline` | `ars/academic-paper/SKILL.md` in outline-only mode |72| `ars-abstract` | `ars/academic-paper/SKILL.md` in abstract-only mode |73| `ars-lit-review` | `ars/academic-paper/SKILL.md` lit-review mode, or `ars/deep-research/SKILL.md` lit-review mode when source discovery is needed |74| `ars-citation-check` | `ars/academic-paper/SKILL.md` citation-check mode |75| `ars-disclosure` | `ars/academic-paper/SKILL.md` disclosure mode |76| `ars-format-convert` | `ars/academic-paper/SKILL.md` format-convert mode |77| `ars-revision-coach` | `ars/academic-paper/SKILL.md` revision-coach mode |78| `ars-revision` | `ars/academic-paper/SKILL.md` revision mode |79| `ars-full` | `ars/academic-pipeline/SKILL.md` full workflow |8081If a slash-prefixed alias is intercepted by the client, tell the user to use the82plain alias form, for example `ars-plan my topic`.8384## Codex Runtime Mapping8586- Treat upstream "agent" files as scoped role prompts to perform inline.87- Do not spawn Codex subagents automatically. Use subagents only when the user88 explicitly asks for parallel delegation.89- Use Codex web browsing for current facts, source verification, citation90 checks, and external evidence, and provide source links.91- Treat Claude-specific hook and plugin metadata as upstream traceability only.92- Preserve independence in multi-review phases: write each reviewer section93 before synthesizing.9495## Shared Resources9697Resolve upstream relative paths under `ars/`:9899- `shared/...` -> `ars/shared/...`100- `scripts/...` -> `ars/scripts/...`101- `examples/...` -> `ars/examples/...`102- `docs/...` -> `ars/docs/...`103104If `ars/` is missing, stop and ask the user to run the Codex installer script105from the repository root.
crazymsn