Allow symlinked Skill folders/files

Resolved 💬 8 comments Opened Dec 20, 2025 by ldorigo Closed Jan 15, 2026

💡 Likely answer: A maintainer (etraut-openai, contributor) responded on this thread — see the highlighted reply below.

What feature would you like to see?

Different agents (i.e. claude code) have a different directory for skills. Following symlinks mean that one can define a single skill tree for all agents and simply link them to the proper locations. Currently I need to use a brittle mechanism that copies the full skill files. Symlinks are nice. Honor symlinks.

Additional information

_No response_

View original on GitHub ↗

8 Comments

JeongJuhyeon · 7 months ago

Wouldn't be ideal if like with custom instructions, it again takes a year of having to use dozens of links and copies before we settle on a skills version of AGENTS.md that every agent looks at instead of all having different folders and names. Hoping that some lessons were learnt there. Github Copilot for one just supports .claude/skills out of the box in addition to its own .github/skills.

philipp-spiess · 7 months ago

Agree this would be a very good quality of life change. ~/.codx/AGENTS.md already follows symlinks so this feels more like an oversight.

asonawalla · 7 months ago

I think a slightly better approach might be to allow users to define the skills tree in codex config. Symlinks are certainly better than syncing edits, but having the tools look in a central, configurable location sounds ideal.

xxchan · 6 months ago

Or we hope this can get into the agentskills spec... https://github.com/agentskills/agentskills/issues/15

banagale · 6 months ago

This would be very much appreciated. It is something of a blocker, as .codex/ can live under version control and when dealing with worktrees we're talking about a lot of unwanted file copies.

etraut-openai contributor · 6 months ago

Working on it: https://github.com/openai/codex/pull/8801

WiSaGaN · 6 months ago

#8801 has been merged and released in https://github.com/openai/codex/releases/tag/rust-v0.80.0 . I think we can close this now.

banagale · 6 months ago

Many thanks, @etraut-openai, @bolinfest and @xl-openai.

This will have a significant impact on my daily workflows, and save a ton of complexity for folks. It will make it easier to flip over to Codex.