Codex Desktop App can not read a skill created by symbol link "ln -s" in MacOS
Resolved 💬 2 comments Opened Mar 26, 2026 by davidhsusl Closed Mar 26, 2026
💡 Likely answer: A maintainer (github-actions[bot], contributor)
responded on this thread — see the highlighted reply below.
What version of the Codex App are you using (From “About Codex” dialog)?
26.324.21641（1228）
What subscription do you have?
Free
What platform is your computer?
Darwin 25.3.0 arm64 arm
What issue are you seeing?
I created a skill and use symbol link "ln -s" in MacOS, but when I Open Codex Desktop App and go to the skill panel, I can't find the skill, but the VSCode copilot can find it, so I think it's a bug in Codex Desktop App
What steps can reproduce the bug?
- Create a symbol link
ln -s ~/my-agents/skills/test-skill/SKILL.md ~/.agents/skills/test-skill/SKILL.md
- Open Codex Desktop App and go to the skill panel
What is the expected behavior?
Can find the skill created by symbol link in MacOS
Additional information
_No response_
2 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Symbolic links to a SKILL.md file are not supported. This is by design. The packaging boundary for a skill is its containing directory. Symbolic links to the skill's directory are supported.