Custom skills do not show up
What version of the IDE extension are you using?
26.311.21342
What subscription do you have?
Business
Which IDE are you using?
VS Code
What platform is your computer?
Linux 6.17.0-19-generic x86_64 x86_64
What issue are you seeing?
I created a skill using the Codex App on mac (still eagerly waiting for Codex app to be released for linux) and the relevant files were added to my repo. Switched to developing on my linux machine and pulled the changes, however the skill does not show up.
Screenshots:
Skill is present in repo
<img width="386" height="238" alt="Image" src="https://github.com/user-attachments/assets/b69713af-f1c3-4698-a589-4653568e73b5" />
Skill does not get suggested/autocompleted
<img width="492" height="346" alt="Image" src="https://github.com/user-attachments/assets/cff2e6fe-b2bd-4c8d-b22f-f466d3cfabdd" />
What steps can reproduce the bug?
Create a skill in a repo, try to reference it with a slash command.
What is the expected behavior?
Skills would autocomplete on slash if they are detected
Additional information
_No response_
7 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Skills are typically referenced by
$, but they should also show up when you use/.Have you tried restarting the extension after you add the skill?
Are you sure that the SKILL.md frontmatter is valid?
Aha, well it doesn't show up with the $ prefix either. See:
<img width="492" height="346" alt="Image" src="https://github.com/user-attachments/assets/2f97f62f-f682-4f42-80cc-940876449819" />
Yes, also tried restarting VSCode entirely.
I believe so. I generated the skill using the Codex App.
But here is the content just to be sure:
I replaced the "``
" with "/`" because otherwise the github comment would assume that the first "``" was the end of the code snippet. In the actual SKILL.md file obviously that "/" is not present.Here's the cinematic landing page skill.md that I got off the internet somewhere (works with claude code and antigravity so I assume it's valid)
I can reproduce a stronger variant of this issue.
Observed behavior:
codexCLI sees my newly added custom skills correctly.Concrete example from my setup:
.agents/skills/Practical impact:
Expected behavior:
This seems closely related to skill discovery caching / refresh behavior in the extension rather than the skill files themselves, because CLI and extension disagree on the same workspace.
Linking a more specific follow-up repro here: #16607
That newer issue narrows this down to a resume-path problem:
$skillinvocation can refresh## SkillscontextSo this may be the same broader skill-refresh family, but
#16607focuses on the specific case where the developer-context skill inventory is stale aftercodex resume, even though discovery/UI already updated.