Skip to content

Use ~/.agents/skills for the Codex install path - #148

Merged
kaankacar merged 1 commit into
mainfrom
fix-codex-skills-path
Oct 12, 2026
Merged

kaankacar merged 1 commit into
mainfrom
fix-codex-skills-path

Conversation

@kaankacar

Copy link
Copy Markdown
Contributor

Refs #27 (item 6, from @jamesbachini).

Codex now reads user skills from ~/.agents/skills. The old ~/.codex/skills path still works, but Codex marks it as deprecated.

Sources:

  • Codex docs list $HOME/.agents/skills as the user location: https://learn.chatgpt.com/docs/build-skills
  • Codex source keeps $CODEX_HOME/skills "for backward compatibility": codex-rs/ext/skills/src/host_roots.rs
  • The scan is recursive to depth 6 (MAX_SCAN_DEPTH), so a full repo clone still finds every skills/*/SKILL.md.

Changes:

  • README: new clone path, a one-line note on the old path, and the table row.
  • site/src/data/installers.mjs: new clone path on the site and in llms.txt.
  • Codex docs link: the old URL redirects (308) to the new one.

Codex now reads user skills from ~/.agents/skills. It keeps
~/.codex/skills only for backward compatibility. Update the README,
the site installer and the Codex docs link.
Copilot AI lite review requested due to automatic review settings October 12, 2026 13:42
@github-actions

github-actions Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-10-12 13:46 UTC

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No unresolved review issues were identified.

0 open findings

What changed in this PR

Updates Codex installation guidance to use the current ~/.agents/skills path while documenting the deprecated legacy path.

Changes:

  • Updated README installation instructions and directory table.
  • Updated site installer data used by the landing page and llms.txt.
File Description
site/​src/​data/​installers.mjs Updates the site-generated Codex clone command.
README.md Documents the new Codex skills path and legacy compatibility.

🧠 Review effort: Lite


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@kaankacar
kaankacar merged commit e93c182 into main Oct 12, 2026
8 checks passed
@kaankacar
kaankacar deleted the fix-codex-skills-path branch October 12, 2026 13:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants