codex-skill-groups

Codex-focused subproject for agent-skill-groups.

The general runtime-aware project now lives at:

https://github.com/go165/agent-skill-groups

Keep using this repository when you specifically want the OpenAI Codex workflow, defaults, examples, and PowerShell compatibility wrapper. New generic features should be developed in agent-skill-groups first, then synced here when they improve Codex usage.

Scope

This repository focuses on Codex-specific operations:

• Codex user skill roots such as $HOME/.codex/skills
• shared Agent Skills roots that Codex can see, such as $HOME/.agents/skills
• a Codex managed disabled pool at $HOME/.codex/skills.disabled/managed
• Codex memory snippets for AGENTS.md
• PowerShell-first setup for Windows Codex CLI users

For Claude Code, OpenCode, or generic Agent Skills repositories, use the parent project:

git clone https://github.com/go165/agent-skill-groups.git

Why This Exists

Large Codex skill collections can become noisy:

• too many skills are considered in every session
• specialized CTF, Figma, paper, or media workflows remain loaded when unused
• manual folder moves are hard to repeat safely

The solution is a small always-on core plus scenario groups that can be loaded when a task needs them.

Install For Codex

git clone https://github.com/go165/codex-skill-groups.git
cd codex-skill-groups

New-Item -ItemType Directory -Force "$HOME\.codex\scripts" | Out-Null
New-Item -ItemType Directory -Force "$HOME\.codex\skill-groups" | Out-Null

Copy-Item ".\scripts\agent-skill-groups.ps1" "$HOME\.codex\scripts\agent-skill-groups.ps1"
Copy-Item ".\examples\groups.example.json" "$HOME\.codex\skill-groups\groups.json"

Codex Commands

# List groups
powershell -ExecutionPolicy Bypass -File "$HOME\.codex\scripts\agent-skill-groups.ps1" -Action list

# Show status
powershell -ExecutionPolicy Bypass -File "$HOME\.codex\scripts\agent-skill-groups.ps1" -Action status

# Enable a group without disabling others
powershell -ExecutionPolicy Bypass -File "$HOME\.codex\scripts\agent-skill-groups.ps1" -Action enable -Group figma-design

# Switch to a scenario profile and disable other managed skills
powershell -ExecutionPolicy Bypass -File "$HOME\.codex\scripts\agent-skill-groups.ps1" -Action profile -Group ctf-web

# Return to the lean baseline
powershell -ExecutionPolicy Bypass -File "$HOME\.codex\scripts\agent-skill-groups.ps1" -Action profile -Group core

The Python CLI is synced from the parent project and also supports:

python -m agent_skill_groups runtimes
python -m agent_skill_groups analyze --runtime codex --json
python -m agent_skill_groups suggest --runtime codex
python -m agent_skill_groups doctor --runtime codex
python -m agent_skill_groups plan --runtime codex ctf-web

Codex Memory Snippet

Add this to AGENTS.md:

# Persistent Codex Skill Group Manager
- Parent project: `https://github.com/go165/agent-skill-groups`.
- Codex subproject: `https://github.com/go165/codex-skill-groups`.
- Group table: `$HOME\.codex\skill-groups\groups.json`.
- PowerShell script: `$HOME\.codex\scripts\agent-skill-groups.ps1`.
- Python CLI: `python -m agent_skill_groups`.
- Before a task clearly matches a disabled scenario group, load the smallest
  suitable group with `profile --runtime codex <group>` or the PowerShell
  `-Action profile -Group <group>` command.
- After scenario work, return to `core` unless asked to keep the group active.

Relationship To agent-skill-groups

agent-skill-groups is the canonical upstream for runtime-agnostic behavior:

• multi-runtime presets
• analyzer and doctor logic
• Python package metadata
• test fixtures
• generic documentation

codex-skill-groups stays as the Codex adapter:

• Codex examples
• Codex defaults
• Codex memory snippets
• Windows/Codex CLI ergonomics

When behavior differs, keep the implementation compatible and document the Codex-specific reason in this repository.