Slash command palette shows duplicate skills when .agents and .codex both contain same skill name

What version of the Codex App are you using (From “About Codex” dialog)?

26.506.31421 (2620)

What subscription do you have?

Plus

What platform is your computer?

Darwin 25.4.0 arm64 arm

What issue are you seeing?

Slash-command skill picker shows duplicate entries when the same skill exists in multiple skill roots (for example .agents/skills and .codex/skills), even when one is just a wrapper/alias to the canonical skill.

What steps can reproduce the bug?

1. In any repo, create both:

• .agents/skills/fix-issues/SKILL.md (canonical/full definition)
• .codex/skills/fix-issues/SKILL.md (wrapper that points to canonical file)

1. Open Codex Desktop in that repo.
2. Open the slash picker with /.
3. Search for fix-issues.

What is the expected behavior?

Only one entry should be shown per logical skill name, or entries should be clearly grouped/marked as aliases so users don’t see ambiguous duplicates.

Additional information

Why This Matters

• Creates confusion about which one to run.
• Makes the picker noisy in repos that mirror skills across .agents/.cursor/.codex.
• Increases chance of selecting a non-canonical wrapper entry unintentionally.

Additional Context

• Canonical skill file contains full workflow.
• Wrapper skill file only redirects to canonical file.
• They are different files but represent the same logical skill.

Suggested Fix

• Deduplicate by normalized name in frontmatter (or by resolved canonical target when wrapper pattern is detected).
• Optionally surface one primary entry with alias/source metadata in details.
• If duplicates must remain, add source labels in UI (.agents, .codex) to reduce ambiguity.

Frequency

Always reproducible in repos with mirrored skill names across multiple skill roots.

Related Skills Potentially Affected

Any mirrored skills (for example debugging, documentation, etc.).