/skills/skills-codex

skills-codex

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

Scope

• Base mirror coverage: all 80 mainline skills under skills/
• Support directory: shared-references/, with all 30/30 mainline reference names mirrored
• Default reviewer contract for reviewer-heavy skills:
  • round 1: spawn_agent
  • follow-up: send_input
  • reasoning effort: xhigh
  • base Codex self-review: review_independence: same-family, acceptance_status: provisional
  • Claude/Gemini overlays or deterministic verification: acceptance_status: accepted
• 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.

Recommended Install

Project-local install is the default path for Codex:

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:

.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:

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

Uninstall only managed Codex entries:

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

Optional Overlays

Install the base first, then choose an overlay:

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

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:

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

Update copied installs with:

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 ~/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-html
• pixel-art

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