anomalyco / anomalyco/opencode

Symlinked skill directories inside .opencode/skills/ are not discovered on Windows

Open
#41,505 0 comments 0 reactions 1 assignee View on GitHub

@Hona is already working on this.

Since Aug 10, 2026.

Dominant language
TypeScript
Stars
209k
Forks
27.5k
PR merge metrics
PR metrics pending

Description

Description
Description

Skills whose directory inside .opencode/skills/ is a symbolic link to another
location are silently ignored on Windows.

Expected behavior

The skill is discovered and listed, as on macOS and Linux.

Actual behavior

The skill does not appear. The symlink itself is valid and SKILL.md resolves
through it (Test-Path ...\my-skill\SKILL.md returns True). Replacing the
symlink with a real directory (or a directory junction) makes the skill appear,
so discovery apparently does not follow symlinked directories when scanning
skills/ on Windows.

Related
  • #18848 (symlinked .claude/skills directory not discovered)
  • #27638 (symlink handling in skill dirs)
Plugins

n/a

OpenCode version

1.18.6

Steps to reproduce
  1. On Windows, create a skill somewhere, e.g. D:\build\skill\SKILL.md with valid
    frontmatter (name, description).
  2. Symlink it into the project skills dir:
    New-Item -ItemType SymbolicLink -Path "<project>\.opencode\skills\my-skill" -Target "D:\build\skill"
  3. Start opencode in the project and list available skills.
Screenshot and/or share link

No response

Operating System

Windows 11

Terminal

Windows Terminal

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.