Summary
Mux currently treats symlinked project skills under .mux/skills/* as invalid in host-local project workspaces. That means skills installed as symlinks do not show up in agent_skill_list and cannot be managed through agent_skill_write / Chat with Mux.
Background
In the workflow used for PR #2910, the project skill entries were installed as symlinks. Codex flagged that local project skill discovery and management currently reject those symlinked entries, so the right follow-up is to teach Mux to support this installation pattern rather than forcing individual PRs to replace symlinks with copied directories.
Problem
agent_skill_list skips symbolic-link entries for project scope.
agent_skill_write / the skill file utilities reject symlinked project skill directories.
- As a result, symlinked project skills do not appear or remain manageable through Chat with Mux in the default host-local context (non-SSH / non-docker).
References
Generated with mux • Model: openai:gpt-5.4 • Thinking: high
Summary
Mux currently treats symlinked project skills under
.mux/skills/*as invalid in host-local project workspaces. That means skills installed as symlinks do not show up inagent_skill_listand cannot be managed throughagent_skill_write/ Chat with Mux.Background
In the workflow used for PR #2910, the project skill entries were installed as symlinks. Codex flagged that local project skill discovery and management currently reject those symlinked entries, so the right follow-up is to teach Mux to support this installation pattern rather than forcing individual PRs to replace symlinks with copied directories.
Problem
agent_skill_listskips symbolic-link entries for project scope.agent_skill_write/ the skill file utilities reject symlinked project skill directories.References
src/node/services/tools/agent_skill_list.ts,src/node/services/tools/agent_skill_write.ts, andsrc/node/services/agentSkills/skillFileUtils.ts.Generated with
mux• Model:openai:gpt-5.4• Thinking:high