Skip to content

skills-codex

Category: code-gen
Field: —
License: MIT
Updated: 2026-05-18
Stages: code-generation

skills-codex

Codex-native mirror and adaptation layer for the main ARIS skills/ package.

Scope

  • Base mirror coverage: all 67 mainline skills under skills/
  • Support directory: shared-references/
  • Default reviewer contract for reviewer-heavy skills:
  • round 1: spawn_agent
  • follow-up: send_input
  • reasoning effort: xhigh
  • Optional overlays:
  • skills-codex-claude-review
  • skills-codex-gemini-review

This package is still an appendage to the Claude mainline, not a separate Codex-first product line.

Project-local install is the default path for Codex:

Bash
git clone https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep.git ~/aris_repo
cd ~/your-project

bash ~/aris_repo/tools/install_aris_codex.sh .

This creates a flat managed layout:

Text Only
.agents/skills/<skill-name> -> ~/aris_repo/skills/skills-codex/<skill-name>
.aris/installed-skills-codex.txt
AGENTS.md   # managed Codex block

Reconcile after upstream changes:

Bash
cd ~/aris_repo && git pull
bash ~/aris_repo/tools/install_aris_codex.sh ~/your-project --reconcile

Uninstall only managed Codex entries:

Bash
bash ~/aris_repo/tools/install_aris_codex.sh ~/your-project --uninstall

Optional Overlays

Install the base first, then choose an overlay:

Bash
bash ~/aris_repo/tools/install_aris_codex.sh ~/your-project --reconcile --with-claude-review-overlay
Bash
bash ~/aris_repo/tools/install_aris_codex.sh ~/your-project --reconcile --with-gemini-review-overlay

Overlays only replace reviewer routing. They do not replace the base mirror or the executor model.

Copy Install and Update

If you intentionally use a copied Codex install instead of managed project symlinks:

Bash
mkdir -p ~/.codex/skills
cp -a ~/aris_repo/skills/skills-codex/. ~/.codex/skills/

Update copied installs with:

Bash
bash ~/aris_repo/tools/smart_update_codex.sh
bash ~/aris_repo/tools/smart_update_codex.sh --apply

For a copied project-local Codex install:

Bash
bash ~/aris_repo/tools/smart_update_codex.sh --project ~/your-project
bash ~/aris_repo/tools/smart_update_codex.sh --project ~/your-project --apply

smart_update_codex.sh refuses symlink-managed installs and redirects them to install_aris_codex.sh --reconcile.

Non-Degrading Skills

The following Codex skills must not silently degrade when their required capability is missing:

  • comm-lit-review
  • research-lit
  • paper-poster
  • pixel-art

If the required source, reviewer, or local preview capability is unavailable, the skill should stop and tell the user what to configure.