Add support for Codex `.agents/skills` discovery and Agent Skills open standard locations

[lastobelus]

What variant of Codex are you using?

CLI

What feature would you like to see?

Summary

Thanks for shipping skills support in Every Code.

Could we add compatibility with the Codex .agents skill discovery model so teams can use the same repository layout across Codex and Every Code?

Why this would help

• Reduces migration friction between Codex and Every Code.
• Lets teams keep skills in git at repo scope without tool-specific path rewrites.
• Aligns with current Codex docs and the Agent Skills ecosystem direction.

Current behavior in Every Code docs

Per docs/skills.md in this repo, skills are currently documented as:

• v1 location: ~/.codex/skills/**/SKILL.md
• hidden entries and symlinks skipped

Source:

• https://github.com/just-every/code/blob/main/docs/skills.md

Requested behavior (compatibility mode)

Please consider supporting these additional discovery roots used by Codex:

• repo scope: .agents/skills from $CWD up to $REPO_ROOT
• user scope: $HOME/.agents/skills
• admin scope: /etc/codex/skills (optional)

Also requested:

• follow symlinked skill folders in those locations
• preserve deterministic precedence and ordering
• keep current ~/.codex/skills behavior for backward compatibility

Proposed precedence

• SYSTEM (bundled)
• ADMIN (/etc/codex/skills)
• USER ($HOME/.agents/skills)
• REPO (nearest .agents/skills from CWD up to repo root)
• legacy ~/.codex/skills (or vice versa if preferred, as long as documented)

Any clear, documented precedence is fine; consistency matters most.

References

• Codex skills docs (.agents/skills locations + symlink support):
  • https://developers.openai.com/codex/skills
• Agent Skills open standard:
  • https://agentskills.io/

Optional usability improvement

• Add a debug/inspection command to show discovered skill roots and loaded SKILL paths.