Docs: Skill path mismatch - &#39;skills&#39; (plural) vs &#39;skill&#39; (singular) #7068

Originally created by @bjesuiter on GitHub (Jan 21, 2026).

Originally assigned to: @rekram1-node on GitHub.

Summary

The documentation specifies skill paths with plural skills/, but opencode actually loads from singular skill/.
Loading from skills/ does NOT WORK right now!
The agent says when using the skills tool, my skills don't show up when I place them in skills/, but they DO show up when placed at skill/

Documentation Says

From the docs :

Global config: ~/.config/opencode/skills/<name>/SKILL.md

Link to the Docs: https://opencode.ai/docs/skills/#:~:text=Troubleshoot%20loading-,Agent%20Skills,-Define%20reusable%20behavior

Actual Behavior

Skills only load from:

~/.config/opencode/skill/<name>/SKILL.md

Steps to Reproduce

Create a skill at ~/.config/opencode/skills/my-skill/SKILL.md (plural, as documented)
Restart opencode
Skill is not found
Move to ~/.config/opencode/skill/my-skill/SKILL.md (singular)
Restart opencode
Skill is found

Expected Behavior

Either:

Update docs to reflect actual path (skill/ singular), OR
Update code to match docs (skills/ plural), OR
Support both paths

Environment

macOS
opencode (latest as of 2025-01-21)

Originally created by @bjesuiter on GitHub (Jan 21, 2026). Originally assigned to: @rekram1-node on GitHub. ## Summary The documentation specifies skill paths with **plural** `skills/`, but opencode actually loads from **singular** `skill/`. **Loading from skills/ does NOT WORK right now!** The agent says when using the skills tool, my skills don't show up when I place them in skills/, but they DO show up when placed at skill/ ## Documentation Says From the docs : ``` Global config: ~/.config/opencode/skills/<name>/SKILL.md ``` Link to the Docs: https://opencode.ai/docs/skills/#:~:text=Troubleshoot%20loading-,Agent%20Skills,-Define%20reusable%20behavior ## Actual Behavior Skills only load from: ``` ~/.config/opencode/skill/<name>/SKILL.md ``` ## Steps to Reproduce 1. Create a skill at `~/.config/opencode/skills/my-skill/SKILL.md` (plural, as documented) 2. Restart opencode 3. Skill is **not** found 4. Move to `~/.config/opencode/skill/my-skill/SKILL.md` (singular) 5. Restart opencode 6. Skill **is** found ## Expected Behavior Either: - Update docs to reflect actual path (`skill/` singular), OR - Update code to match docs (`skills/` plural), OR - Support both paths ## Environment - macOS - opencode (latest as of 2025-01-21)

yindo commented

@github-actions[bot] commented on GitHub (Jan 21, 2026):

This issue might be a duplicate of existing issues. Please check:

#8054: Skill Discovery Only Checks skills/ Directory, Ignoring skill/ Path
#9044: Tweak .opencode/skill into .opencode/skills
#9207: skills directory name why not use same specify as claude code
#6171: Inconsistency in docs for where to install skills
#6177: Skill discovery doesn't match Claude Code's skills/ directory structure
#6266: Does opencode actually support finding skills at .claude/skills?
#6432: Backward compatibility broken - enforcement of the /skill directory naming

Feel free to ignore if none of these address your specific case.

@github-actions[bot] commented on GitHub (Jan 21, 2026): This issue might be a duplicate of existing issues. Please check: - #8054: Skill Discovery Only Checks `skills/` Directory, Ignoring `skill/` Path - #9044: Tweak `.opencode/skill` into `.opencode/skills` - #9207: skills directory name why not use same specify as claude code - #6171: Inconsistency in docs for where to install skills - #6177: Skill discovery doesn't match Claude Code's skills/ directory structure - #6266: Does opencode actually support finding skills at `.claude/skills`? - #6432: Backward compatibility broken - enforcement of the /skill directory naming Feel free to ignore if none of these address your specific case.

yindo commented

@rekram1-node commented on GitHub (Jan 21, 2026):

Hm looking

@rekram1-node commented on GitHub (Jan 21, 2026): Hm looking

yindo commented

@rekram1-node commented on GitHub (Jan 21, 2026):

Cannot replicate

@rekram1-node commented on GitHub (Jan 21, 2026): <img width="866" height="430" alt="Image" src="https://github.com/user-attachments/assets/28f63b43-de31-4f4a-adec-544b8b340a40" /> Cannot replicate

yindo commented

@rekram1-node commented on GitHub (Jan 21, 2026):

and you are on 1.1.28 correct?

@rekram1-node commented on GitHub (Jan 21, 2026): and you are on 1.1.28 correct?

yindo commented

@rothnic commented on GitHub (Jan 21, 2026):

I'm having the same issue with the latest opencode (1.1.29), setting up fresh on a new dev machine, trying to use the vercel skill installer package to try that out along with creating some of my own skills. It seems vercel was confused by the location to put them and the opencode cli is confused as well, since the debug command for skills finds them in the "wrong" location. None of these skills are listed as available in opencode, even after restarting.

It would be nice to have some easy way to see the tools, skills etc available to the default or particular agent, using the same underlying functionality, from the cli to validate configurations, along with where permissions or settings are coming from. It seems the cli debug commands don't use the same functionality.

  /data/projects/ntm on  copilot/add-opencode-server-support opencode debug skill
[
  {
    "name": "humanizer",
    "description": "Remove signs of AI-generated writing from text. Use when editing or reviewing\ntext to make it sound more natural and human-written. Based on Wikipedia's\ncomprehensive \"Signs of AI writing\" guide. Detects and fixes patterns including:\ninflated symbolism, promotional language, superficial -ing analyses, vague\nattributions, em dash overuse, rule of three, AI vocabulary words, negative\nparallelisms, and excessive conjunctive phrases.\n",
    "location": "/home/ubuntu/.config/opencode/skills/humanizer/SKILL.md"
  },
  {
    "name": "skill-creator",
    "description": "Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.",
    "location": "/home/ubuntu/.config/opencode/skills/skill-creator/SKILL.md"
  },
  {
    "name": "opencode",
    "description": "A comprehensive skill for managing all aspects of OpenCode, including configuration, installation, extensions, SDK usage, and ecosystem research.",
    "location": "/home/ubuntu/.config/opencode/skills/opencode/SKILL.md"
  },
  {
    "name": "agent-mail",
    "description": "Detailed usage patterns for the mcp-agent-mail server, including registration, file reservations, and communication macros.",
    "location": "/home/ubuntu/.config/opencode/skills/agent-mail/SKILL.md"
  },
  {
    "name": "skills-discovery",
    "description": "Search for and install Agent Skills that give you specialized capabilities. Before starting work, ask might a skill exist that handles this better than my base knowledge? If the task involves specific technologies, frameworks, file formats, or expert domains. Search proactively, even if the user doesn't mention skills. Skills encode best practices, tools, and techniques you wouldn't otherwise have. Also use when users explicitly ask to find, install, or manage skills.",
    "location": "/home/ubuntu/.opencode/skill/skills-discovery/SKILL.md"
  }
]

  /data/projects/ntm on  copilot/add-opencode-server-support ls ~/.config/opencode/skills
3268860 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:13:29 2026  .
2509121 drwxrwxrwx ubuntu ubuntu 4.0 KB Wed Jan 21 17:53:52 2026  ..
3268861 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 16:18:15 2026  agent-mail
3275890 lrwxrwxrwx ubuntu ubuntu  33 B  Wed Jan 21 17:05:18 2026  humanizer ⇒ ../../../.agents/skills/humanizer
3271258 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:10:32 2026  opencode
3276097 lrwxrwxrwx ubuntu ubuntu  37 B  Wed Jan 21 17:13:29 2026  skill-creator ⇒ ../../../.agents/skills/skill-creator

  /data/projects/ntm on  copilot/add-opencode-server-support opencode --version
1.1.29

  /data/projects/ntm on  copilot/add-opencode-server-support ls ~/.config/opencode
2509121 drwxrwxrwx ubuntu ubuntu 4.0 KB Wed Jan 21 17:53:52 2026  .
1055105 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:43:16 2026  ..
2513590 .rwxrwxrwx ubuntu ubuntu 123 B  Wed Jan 21 15:15:17 2026  .gitignore
2512835 .rw-rw-r-- ubuntu ubuntu 1.4 KB Wed Jan 21 16:39:28 2026  AGENTS.md
2509176 .rw-rw-r-- ubuntu ubuntu 1.0 KB Wed Jan 21 17:50:38 2026  antigravity-accounts.json
2512784 .rw-r--r-- ubuntu ubuntu  11 KB Wed Jan 21 17:53:52 2026  bun.lock
2512856 .rw-rw-r-- ubuntu ubuntu 234 KB Wed Jan 21 17:00:29 2026  config.schema.json
3271260 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 16:50:05 2026  docs
3268747 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 16:18:15 2026  instructions
2514377 drwxrwxrwx ubuntu ubuntu 4.0 KB Wed Jan 21 17:51:49 2026  node_modules
2512839 .rw-rw-r-- ubuntu ubuntu 3.7 KB Wed Jan 21 17:29:46 2026  opencode.jsonc
2513589 .rwxrwxrwx ubuntu ubuntu 161 B  Wed Jan 21 17:53:52 2026  package.json
3273540 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:00:29 2026  scripts
3268860 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:13:29 2026  skills

@rothnic commented on GitHub (Jan 21, 2026): I'm having the same issue with the latest opencode (1.1.29), setting up fresh on a new dev machine, trying to use the vercel skill installer package to try that out along with creating some of my own skills. It seems vercel was confused by the location to put them and the opencode cli is confused as well, since the debug command for skills finds them in the "wrong" location. None of these skills are listed as available in opencode, even after restarting. It would be nice to have some easy way to see the tools, skills etc available to the default or particular agent, using the same underlying functionality, from the cli to validate configurations, along with where permissions or settings are coming from. It seems the cli debug commands don't use the same functionality. ``` bash  /data/projects/ntm on  copilot/add-opencode-server-support opencode debug skill [ { "name": "humanizer", "description": "Remove signs of AI-generated writing from text. Use when editing or reviewing\ntext to make it sound more natural and human-written. Based on Wikipedia's\ncomprehensive \"Signs of AI writing\" guide. Detects and fixes patterns including:\ninflated symbolism, promotional language, superficial -ing analyses, vague\nattributions, em dash overuse, rule of three, AI vocabulary words, negative\nparallelisms, and excessive conjunctive phrases.\n", "location": "/home/ubuntu/.config/opencode/skills/humanizer/SKILL.md" }, { "name": "skill-creator", "description": "Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.", "location": "/home/ubuntu/.config/opencode/skills/skill-creator/SKILL.md" }, { "name": "opencode", "description": "A comprehensive skill for managing all aspects of OpenCode, including configuration, installation, extensions, SDK usage, and ecosystem research.", "location": "/home/ubuntu/.config/opencode/skills/opencode/SKILL.md" }, { "name": "agent-mail", "description": "Detailed usage patterns for the mcp-agent-mail server, including registration, file reservations, and communication macros.", "location": "/home/ubuntu/.config/opencode/skills/agent-mail/SKILL.md" }, { "name": "skills-discovery", "description": "Search for and install Agent Skills that give you specialized capabilities. Before starting work, ask might a skill exist that handles this better than my base knowledge? If the task involves specific technologies, frameworks, file formats, or expert domains. Search proactively, even if the user doesn't mention skills. Skills encode best practices, tools, and techniques you wouldn't otherwise have. Also use when users explicitly ask to find, install, or manage skills.", "location": "/home/ubuntu/.opencode/skill/skills-discovery/SKILL.md" } ]  /data/projects/ntm on  copilot/add-opencode-server-support ls ~/.config/opencode/skills 3268860 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:13:29 2026  . 2509121 drwxrwxrwx ubuntu ubuntu 4.0 KB Wed Jan 21 17:53:52 2026  .. 3268861 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 16:18:15 2026  agent-mail 3275890 lrwxrwxrwx ubuntu ubuntu 33 B Wed Jan 21 17:05:18 2026  humanizer ⇒ ../../../.agents/skills/humanizer 3271258 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:10:32 2026  opencode 3276097 lrwxrwxrwx ubuntu ubuntu 37 B Wed Jan 21 17:13:29 2026  skill-creator ⇒ ../../../.agents/skills/skill-creator  /data/projects/ntm on  copilot/add-opencode-server-support opencode --version 1.1.29  /data/projects/ntm on  copilot/add-opencode-server-support ls ~/.config/opencode 2509121 drwxrwxrwx ubuntu ubuntu 4.0 KB Wed Jan 21 17:53:52 2026  . 1055105 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:43:16 2026  .. 2513590 .rwxrwxrwx ubuntu ubuntu 123 B Wed Jan 21 15:15:17 2026  .gitignore 2512835 .rw-rw-r-- ubuntu ubuntu 1.4 KB Wed Jan 21 16:39:28 2026  AGENTS.md 2509176 .rw-rw-r-- ubuntu ubuntu 1.0 KB Wed Jan 21 17:50:38 2026  antigravity-accounts.json 2512784 .rw-r--r-- ubuntu ubuntu 11 KB Wed Jan 21 17:53:52 2026  bun.lock 2512856 .rw-rw-r-- ubuntu ubuntu 234 KB Wed Jan 21 17:00:29 2026  config.schema.json 3271260 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 16:50:05 2026  docs 3268747 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 16:18:15 2026  instructions 2514377 drwxrwxrwx ubuntu ubuntu 4.0 KB Wed Jan 21 17:51:49 2026  node_modules 2512839 .rw-rw-r-- ubuntu ubuntu 3.7 KB Wed Jan 21 17:29:46 2026  opencode.jsonc 2513589 .rwxrwxrwx ubuntu ubuntu 161 B Wed Jan 21 17:53:52 2026  package.json 3273540 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:00:29 2026  scripts 3268860 drwxrwxr-x ubuntu ubuntu 4.0 KB Wed Jan 21 17:13:29 2026  skills ```

yindo commented

@rekram1-node commented on GitHub (Jan 21, 2026):

None of these skills are listed as available in opencode, even after restarting.

What do you mean?

@rekram1-node commented on GitHub (Jan 21, 2026): > None of these skills are listed as available in opencode, even after restarting. What do you mean?

yindo commented

@rothnic commented on GitHub (Jan 21, 2026):

@rekram1-node the command i show above (opencode debug skill) to list out the 5 skills that I'd expect to see in the opencode TUI don't show up when i run opencode. I'm specifically trying to use the slash command to see it in the TUI like it is working for me on my other machine. I tried the approach you used and the agent shows the skills, so it must be a TUI issue.

The only thing i can think of is this is my first time trying that skill installer which leverages symlinks so we can use the same skill across agents.

@rothnic commented on GitHub (Jan 21, 2026): @rekram1-node the command i show above (`opencode debug skill`) to list out the 5 skills that I'd expect to see in the opencode TUI don't show up when i run opencode. I'm specifically trying to use the slash command to see it in the TUI like it is working for me on my other machine. I tried the approach you used and the agent shows the skills, so it must be a TUI issue. The only thing i can think of is this is my first time trying that skill installer which leverages symlinks so we can use the same skill across agents. <img width="1699" height="1031" alt="Image" src="https://github.com/user-attachments/assets/55dca147-912a-4840-b3b1-7213b6b568b9" />

yindo commented

@rekram1-node commented on GitHub (Jan 21, 2026):

I think there is some confusion here, you can't invoke skills manually, so doing a /skill-creator won't do anything even if all the skills are loaded

@rekram1-node commented on GitHub (Jan 21, 2026): I think there is some confusion here, you can't invoke skills manually, so doing a /skill-creator won't do anything even if all the skills are loaded

yindo commented

@rothnic commented on GitHub (Jan 21, 2026):

ahhh... sorry for the confusion, i think i installed oh my opencode on my other machine the same time that opencode added skill support and thought the slash commands were coming from opencode. I guess I assumed since if you really want an agent to use one that you need to reference it there would be a way to reference it. Not being able to @ mention them or something makes it a bit confusing.

Treating them as commands kind of felt odd but at the same time made sense, since you could technically use a slash command or reference the command markdown file or point an agent to a directory of files (essentially a skill), and get a similar result.

@rothnic commented on GitHub (Jan 21, 2026): ahhh... sorry for the confusion, i think i installed oh my opencode on my other machine the same time that opencode added skill support and thought the slash commands were coming from opencode. I guess I assumed since if you really want an agent to use one that you need to reference it there would be a way to reference it. Not being able to @ mention them or something makes it a bit confusing. Treating them as commands kind of felt odd but at the same time made sense, since you could technically use a slash command or reference the command markdown file or point an agent to a directory of files (essentially a skill), and get a similar result. <img width="1339" height="260" alt="Image" src="https://github.com/user-attachments/assets/a8fe04b9-73a9-474a-8bd9-8a0b38fef94f" />

yindo commented

@rothnic commented on GitHub (Jan 21, 2026):

I do still stand by the suggestion it would be a ux win to list out or view explicitly what skills or tools are available based on the path, then the status of the permissions for the given agent selected. Maybe with an option to hide or show disabled skills/tools. I think it is a common concern to both understand if something really is available to an agent and also how many tools and how much they take up context. Maybe keep them separate in a slash command of /skills and /tools where tools is grouped by custom/plugin vs mcp server.

Maybe I'll poke around at that sometime.

@rothnic commented on GitHub (Jan 21, 2026): I do still stand by the suggestion it would be a ux win to list out or view explicitly what skills or tools are available based on the path, then the status of the permissions for the given agent selected. Maybe with an option to hide or show disabled skills/tools. I think it is a common concern to both understand if something really is available to an agent and also how many tools and how much they take up context. Maybe keep them separate in a slash command of /skills and /tools where tools is grouped by custom/plugin vs mcp server. Maybe I'll poke around at that sometime.

yindo commented

@bjesuiter commented on GitHub (Jan 21, 2026):

Cannot replicate

Interesting, maybe that issue is because i also use oh-my-opencode plugin if that breaks the skill detection.
I'll investigate.

@bjesuiter commented on GitHub (Jan 21, 2026): > Cannot replicate Interesting, maybe that issue is because i also use oh-my-opencode plugin if that breaks the skill detection. I'll investigate.

yindo commented

@rothnic commented on GitHub (Jan 21, 2026):

Cannot replicate

Interesting, maybe that issue is because i also use oh-my-opencode plugin if that breaks the skill detection.
I'll investigate.

For me it was the opposite where I was used to seeing the skills in the TUI due to oh my opencode, but if that isn't installed or working then you will not see the skills anywhere in the TUI. You can check what opencode should be loading and can see by using that opencode debug skills cli command.

@rothnic commented on GitHub (Jan 21, 2026): > > Cannot replicate > > Interesting, maybe that issue is because i also use oh-my-opencode plugin if that breaks the skill detection. > I'll investigate. > For me it was the opposite where I was used to seeing the skills in the TUI due to oh my opencode, but if that isn't installed or working then you will not see the skills anywhere in the TUI. You can check what opencode should be loading and can see by using that opencode debug skills cli command.

yindo commented

@bjesuiter commented on GitHub (Jan 21, 2026):

Cannot replicate

Interesting, maybe that issue is because i also use oh-my-opencode plugin if that breaks the skill detection.
I'll investigate.

For me it was the opposite where I was used to seeing the skills in the TUI due to oh my opencode, but if that isn't installed or working then you will not see the skills anywhere in the TUI. You can check what opencode should be loading and can see by using that opencode debug skills cli command.

Yes, I asked the agent to give me the list of "skills" it sees with its "skill" tool and my personal skills only showed up there when they're placed in skill/ instead of skills/.
Still investigating further.

@bjesuiter commented on GitHub (Jan 21, 2026): > > > Cannot replicate > > > > > > Interesting, maybe that issue is because i also use oh-my-opencode plugin if that breaks the skill detection. > > I'll investigate. > > For me it was the opposite where I was used to seeing the skills in the TUI due to oh my opencode, but if that isn't installed or working then you will not see the skills anywhere in the TUI. You can check what opencode should be loading and can see by using that opencode debug skills cli command. Yes, I asked the agent to give me the list of "skills" it sees with its "skill" tool and my personal skills only showed up there when they're placed in skill/ instead of skills/. Still investigating further.

yindo commented

@Leewonchan14 commented on GitHub (Jan 22, 2026):

same here

@Leewonchan14 commented on GitHub (Jan 22, 2026): <img width="1809" height="568" alt="Image" src="https://github.com/user-attachments/assets/db96eb70-faa6-4c28-acd8-66a648b21e93" /> <img width="1647" height="588" alt="Image" src="https://github.com/user-attachments/assets/a766b27c-552c-4fb9-8b52-73d84233c492" /> same here

yindo commented

@rekram1-node commented on GitHub (Jan 22, 2026):

@Leewonchan14 need a bit more info to debug here, Im not sure what im seeing

@rekram1-node commented on GitHub (Jan 22, 2026): @Leewonchan14 need a bit more info to debug here, Im not sure what im seeing

yindo commented

@Leewonchan14 commented on GitHub (Jan 22, 2026):

@Leewonchan14 need a bit more info to debug here, Im not sure what im seeing

when i skill write in $(pwd)/.opencode/skills/langgraph-docs/SKILL.md not wokring
but write in $(pwd)/.opencode/skill/langgraph-docs/SKILL.md is wokring

the path skills not working to me too

@Leewonchan14 commented on GitHub (Jan 22, 2026): > [@Leewonchan14](https://github.com/Leewonchan14) need a bit more info to debug here, Im not sure what im seeing when i skill write in $(pwd)/.opencode/skills/langgraph-docs/SKILL.md not wokring but write in $(pwd)/.opencode/skill/langgraph-docs/SKILL.md is wokring the path skills not working to me too

yindo commented

@GitHubxsy commented on GitHub (Jan 23, 2026):

m

@GitHubxsy commented on GitHub (Jan 23, 2026): m

yindo commented

@deadcoder0904 commented on GitHub (Jan 26, 2026):

Is the agent vs agents working or is that still an issue? Because I got this from Claude.

Your agents need to be in .opencode/agent/ (singular), not .claude/agents/

And it somehow gave me error to in OpenCode Desktop for some reason.

@deadcoder0904 commented on GitHub (Jan 26, 2026): Is the agent vs agents working or is that still an issue? Because I got this from Claude. > Your agents need to be in .opencode/agent/ (singular), not .claude/agents/ And it somehow gave me error to in OpenCode Desktop for some reason.

yindo commented

@dogmatic69 commented on GitHub (Jan 27, 2026):

skills do not work for me with "skills" dir, but does with "skill". I have no plugins, mcps or otherwise setup. Pretty much clean install of opencode.

"agents" works for me for agents.

@dogmatic69 commented on GitHub (Jan 27, 2026): skills do not work for me with "skills" dir, but does with "skill". I have no plugins, mcps or otherwise setup. Pretty much clean install of opencode. "agents" works for me for agents. <img width="1832" height="1145" alt="Image" src="https://github.com/user-attachments/assets/59fd4e27-9276-48a2-bcce-3b642b282dd3" />

yindo commented

@deadcoder0904 commented on GitHub (Jan 28, 2026):

I just managed to make agents work. Unlinked .opencode <-> .claude & started using both separately now. Everything now lives under .opencode/agents so it works. I guess separation is the way to go now. No more DRY principle.

@deadcoder0904 commented on GitHub (Jan 28, 2026): I just managed to make agents work. Unlinked `.opencode` <-> `.claude` & started using both separately now. Everything now lives under `.opencode/agents` so it works. I guess separation is the way to go now. No more DRY principle.

yindo commented

@rekram1-node commented on GitHub (Jan 29, 2026):

I had multiple people test, cannot replicate the bug at all.

If you are using any plugins I recommend raising issue w/ them. Our glob should be reading all the plurals

@rekram1-node commented on GitHub (Jan 29, 2026): I had multiple people test, cannot replicate the bug at all. If you are using any plugins I recommend raising issue w/ them. Our glob should be reading all the plurals

yindo commented

@dogmatic69 commented on GitHub (Jan 29, 2026):

As stated, I'm using a clean install with no plugins, configurations or anything of the sort.

@dogmatic69 commented on GitHub (Jan 29, 2026): As stated, I'm using a clean install with no plugins, configurations or anything of the sort.

yindo commented

@rekram1-node commented on GitHub (Jan 29, 2026):

@dogmatic69 can u show me:
opencode debug config

and

opencode debug skill

and then tell me which skills aren't being loaded (AND where they are on ur filesystem relative to where opencode is running)

@rekram1-node commented on GitHub (Jan 29, 2026): @dogmatic69 can u show me: `opencode debug config` and `opencode debug skill` and then tell me which skills aren't being loaded (AND where they are on ur filesystem relative to where opencode is running)

yindo commented

@dogmatic69 commented on GitHub (Jan 30, 2026):

$ ls -al .opencode/ski* && opencode debug skill | jq '.[].name'
lrwxrwxrwx 1 dogmatic69 dogmatic69 17 Jan 28 11:56 .opencode/skills -> ../.github/skills
"agent-templates"
"how-to-document"
"dependencies"

debug shows them as "loaded". All there. Actually using them is another story...

@dogmatic69 commented on GitHub (Jan 30, 2026): ``` $ ls -al .opencode/ski* && opencode debug skill | jq '.[].name' lrwxrwxrwx 1 dogmatic69 dogmatic69 17 Jan 28 11:56 .opencode/skills -> ../.github/skills "agent-templates" "how-to-document" "dependencies" ``` debug shows them as "loaded". All there. Actually using them is another story... <img width="1334" height="87" alt="Image" src="https://github.com/user-attachments/assets/c8b54aac-daea-4b1c-bdce-3757bd934a78" />

yindo commented

@rekram1-node commented on GitHub (Jan 30, 2026):

Hmm I did the exact same and it works for me, weird

@rekram1-node commented on GitHub (Jan 30, 2026): Hmm I did the exact same and it works for me, weird

yindo commented

@rekram1-node commented on GitHub (Jan 30, 2026):

@rekram1-node commented on GitHub (Jan 30, 2026): <img width="666" height="44" alt="Image" src="https://github.com/user-attachments/assets/9748710b-2068-4e11-acc3-c5c3e2f9cff1" /> <img width="1112" height="291" alt="Image" src="https://github.com/user-attachments/assets/33e0a18a-7329-432d-be5a-cab997d04e46" />

yindo commented

@rekram1-node commented on GitHub (Jan 30, 2026):

I imagine it has something to do with symlinks being an issue...

@rekram1-node commented on GitHub (Jan 30, 2026): I imagine it has something to do with symlinks being an issue...

yindo commented

@rekram1-node commented on GitHub (Jan 30, 2026):

What if u put this in ur config?

  "skills": {
    "paths": [".github/skills"],
  },

@rekram1-node commented on GitHub (Jan 30, 2026): What if u put this in ur config? ``` "skills": { "paths": [".github/skills"], }, ```

yindo commented

@niderhoff commented on GitHub (Feb 2, 2026):

I imagine it has something to do with symlinks being an issue...

It has nothing to do with the issue title, but I can confirm that symlinks do not work. This is a bit unfortunate as symlink is the method used by vercel skills (https://skills.sh/) to avoid installing copies of skills for all agents.

@niderhoff commented on GitHub (Feb 2, 2026): > I imagine it has something to do with symlinks being an issue... It has nothing to do with the issue title, but I can **confirm** that symlinks do **not** work. This is a bit unfortunate as symlink is the method used by vercel skills (https://skills.sh/) to avoid installing copies of skills for all agents.

yindo commented

@dogmatic69 commented on GitHub (Feb 2, 2026):

Symilnks absolutely do work, I have agents and skills in .github and symlinked across all my repos for opencode. You want to ensure it is symlinked to .opencode/skill as .opencode/skills (as per the issue) does not work

@dogmatic69 commented on GitHub (Feb 2, 2026): Symilnks absolutely do work, I have agents and skills in `.github` and symlinked across all my repos for opencode. You want to ensure it is symlinked to `.opencode/skill` as `.opencode/skills` (as per the issue) does not work

yindo commented

@niderhoff commented on GitHub (Feb 2, 2026):

Symilnks absolutely do work, I have agents and skills in .github and symlinked across all my repos for opencode. You want to ensure it is symlinked to .opencode/skill as .opencode/skills (as per the issue) does not work

I could observe the following:

Skills in .opencode/skills do work
Skills symlinked to .opencode/skills do not work

are we using the same version/os?

I am on MacOS, opencode 1.1.48. I did not symlink the whole .opencode/skills folder, I symlinked subfolders, e.g. .opencode/skills/xxx -> somewhere/else/xxx

@niderhoff commented on GitHub (Feb 2, 2026): > Symilnks absolutely do work, I have agents and skills in `.github` and symlinked across all my repos for opencode. You want to ensure it is symlinked to `.opencode/skill` as `.opencode/skills` (as per the issue) does not work I could observe the following: - Skills in .opencode/skills **do** work - Skills symlinked to .opencode/skills **do not** work are we using the same version/os? I am on MacOS, opencode 1.1.48. I did not symlink the whole .opencode/skills folder, I symlinked subfolders, e.g. .opencode/skills/xxx -> somewhere/else/xxx

yindo commented

@deadcoder0904 commented on GitHub (Feb 2, 2026):

Fwiw, I've realized that until you have specification like AGENTS.md by a big AI lab, don't use symlinks.

It IS a source of the issue since OpenCode & Claude Code have different ways to do same things.

I'm sure other labs like Open AI & Gemini will have different things as well.

Ditch the symlink & do 4x the work if you use 4 different providers. Repeat yourself. Its the only way for this to be reliable for now.

Again, this is personal experience. YMMV.

@deadcoder0904 commented on GitHub (Feb 2, 2026): Fwiw, I've realized that until you have specification like AGENTS.md by a big AI lab, don't use symlinks. It IS a source of the issue since OpenCode & Claude Code have different ways to do same things. I'm sure other labs like Open AI & Gemini will have different things as well. Ditch the symlink & do 4x the work if you use 4 different providers. Repeat yourself. Its the only way for this to be reliable for now. Again, this is personal experience. YMMV.

yindo commented

@bjesuiter commented on GitHub (Feb 5, 2026):

This might be obsolete now that all but anthropic are standardizing on .agents/skills. Have to check though

@bjesuiter commented on GitHub (Feb 5, 2026): This might be obsolete now that all but anthropic are standardizing on .agents/skills. Have to check though

yindo commented