Codex direct native skill loader
Current-session skill group loader for Codex, Claude Code, OpenCode, and generic Agent Skills.
Load a GitHub skill-group or GitHub agent-skill-group into an already-running Codex conversation without moving skill directories.
agent-skill-groups uses codex-activate --direct to update Codex app-server skills/extraRoots live and calls skills/list forceReload. Use --context-mode native-only to rely on Codex progressive disclosure, summary for lightweight current-thread awareness, or full when the current conversation needs complete skill bodies.
This is also the current-session skill group loader for Claude Code, OpenCode, and generic Agent Skills through the portable session-load and session-unload fallback.
Use It When
- A Codex, Claude Code, OpenCode, or generic Agent Skills conversation is already running.
- The task needs a specialized group such as
research,frontend-browser,ctf-web, oracademic-optics. - You want the group now, without waiting for a new session or manual runtime rescan.
Codex Direct Commands
agent-skill-groups codex-activate --config groups.json --runtime codex --direct --context-mode native-only ctf-web
agent-skill-groups codex-clear --config groups.json --runtime codex ctf-webPowerShell users can call the same Codex direct native loader through the compatibility script:
powershell -ExecutionPolicy Bypass -File "$HOME\.codex\scripts\agent-skill-groups.ps1" -Action codex-activate -Direct -ContextMode native-only -Group ctf-web
powershell -ExecutionPolicy Bypass -File "$HOME\.codex\scripts\agent-skill-groups.ps1" -Action codex-clear -Group ctf-webFor runtimes without the Codex app-server path, use the portable current-session pack:
agent-skill-groups session-load --config groups.json --runtime codex ctf-web
agent-skill-groups session-load --config groups.json --runtime codex --context-mode summary ctf-web
agent-skill-groups session-unload --config groups.json --runtime codex ctf-webTwo Loading Layers
| Command | Effect | Use when |
|---|---|---|
codex-activate --direct | Builds a direct extra root, sends it through Codex skills/extraRoots, calls skills/list forceReload, and emits native-only, summary, or full context output. | Codex should see the selected group through native metadata immediately, without moving directories. |
codex-clear | Sends an empty skills/extraRoots list, calls skills/list forceReload, and can print a current-session unload pack. | The scenario task is finished and direct extra roots should be cleared live. |
session-load | Prints a current-conversation context pack or metadata summary from active roots or the disabled pool. | The current conversation needs group awareness or full instructions immediately. |
session-unload | Prints stop instructions for the current conversation. | The scenario task is finished and future replies should return to core behavior. |
profile | Moves skill directories between active and disabled roots. | The runtime's native skill list should change after reload, rescan, or a new session. |
What It Proves
The quickstart and real-world test plan run session-load and session-unload against sample SKILL.md directories. The Codex live path is tested separately with codex-activate --direct --context-mode native-only, codex-clear, skills/extraRoots, and skills/list forceReload. User-space tooling still cannot erase text already sent to the model, so use summary or full only when the current conversation needs emitted context beyond native skill discovery.