Repository navigation
[BUG]: ~/.agents/skills/ path not resolved on Windows #17007
Description
Description
On Windows, OpenCode does not discover skills placed in ~/.agents/skills/<name>/SKILL.md.
According to the skills documentation, the following global paths should be searched:
~/.config/opencode/skills/<name>/SKILL.md✅ works~/.claude/skills/<name>/SKILL.md(not tested)~/.agents/skills/<name>/SKILL.md❌ not working on Windows
Steps to Reproduce
- Windows 11, OpenCode on
win32 - Create
C:\Users\<user>\.agents\skills\find-skills\SKILL.mdwith valid frontmatter - Start OpenCode
- Check available skills via the
skilltool
Expected: find-skills appears in the skill list
Actual: find-skills does not appear
Workaround
Copying the same SKILL.md to C:\Users\<user>\.config\opencode\skills\find-skills\SKILL.md makes the skill discoverable immediately after restarting OpenCode.
Environment
- Platform: Windows (
win32) - Skills in
~/.config/opencode/skills/work correctly - Skills in
~/.agents/skills/are silently ignored
Hypothesis
The ~ path expansion for ~/.agents/ may not be resolved correctly on Windows, or the path is only implemented for POSIX systems.
Metadata
Metadata
Assignees
Labels
No labels
Activity
github-actions commentedon Mar 11, 2026
This issue might be a duplicate of existing issues. Please check:
~/.agents/skills/**#12741: Skills in~/.agents/skills/not being auto-detected (same root problem, though that report is not Windows-specific)If your issue is distinct (specifically the Windows
~expansion for~/.agents/), please note that in the existing issues or confirm it's already tracked there.devcxl commentedon Apr 30, 2026
ProjectDir/.agents/skills/<name>/SKILL.md not working on Linux
github-actions commentedon Jul 4, 2026
To stay organized issues are automatically closed after 60 days of no activity. If the issue is still relevant please open a new one.