Backward compatibility broken - enforcement of the /skill directory naming #3993

Closed
opened 2026-02-16 17:42:13 -05:00 by yindo · 8 comments
Owner

Originally created by @Melodeiro on GitHub (Dec 30, 2025).

Originally assigned to: @rekram1-node on GitHub.

Description

Hello!
Im using different agents solution as it fits my requirements better. It is working inside of a /skills directory. Can you, please made an option to not to crash the opencode if there are /skills directory?

OpenCode version

Any 1.0.205+

Steps to reproduce

Install 1.0.205 version or higher
create ~/.config/opencode/skills directory
open opencode

Screenshot and/or share link

No response

Operating System

No response

Terminal

No response

Originally created by @Melodeiro on GitHub (Dec 30, 2025). Originally assigned to: @rekram1-node on GitHub. ### Description Hello! Im using different agents solution as it fits my requirements better. It is working inside of a /skills directory. Can you, please made an option to not to crash the opencode if there are /skills directory? ### OpenCode version Any 1.0.205+ ### Steps to reproduce Install 1.0.205 version or higher create ~/.config/opencode/skills directory open opencode ### Screenshot and/or share link _No response_ ### Operating System _No response_ ### Terminal _No response_
yindo added the bug label 2026-02-16 17:42:13 -05:00
yindo closed this issue 2026-02-16 17:42:13 -05:00
Author
Owner

@github-actions[bot] commented on GitHub (Dec 30, 2025):

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

  • #6171: Inconsistency in docs for where to install skills - discusses the difference between ~/.opencode/skill and ~/.config/opencode/skill
  • #6292: Global skills are not loaded - related issue where skills in global config folder are not being discovered
  • #6177: Skill discovery doesn't match Claude Code's skills/ directory structure - related to skill directory naming compatibility

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

@github-actions[bot] commented on GitHub (Dec 30, 2025): This issue might be a duplicate of existing issues. Please check: - #6171: Inconsistency in docs for where to install skills - discusses the difference between `~/.opencode/skill` and `~/.config/opencode/skill` - #6292: Global skills are not loaded - related issue where skills in global config folder are not being discovered - #6177: Skill discovery doesn't match Claude Code's skills/ directory structure - related to skill directory naming compatibility Feel free to ignore if none of these address your specific case.
Author
Owner

@Melodeiro commented on GitHub (Dec 30, 2025):

Here is an implementation which im using for reference. Maybe you can get some insights as well https://github.com/joshuadavidthomas/opencode-agent-skills

@Melodeiro commented on GitHub (Dec 30, 2025): Here is an implementation which im using for reference. Maybe you can get some insights as well https://github.com/joshuadavidthomas/opencode-agent-skills
Author
Owner

@rekram1-node commented on GitHub (Dec 30, 2025):

are you disabling the native skills support then? I think opencode supoorts those same features

@rekram1-node commented on GitHub (Dec 30, 2025): are you disabling the native skills support then? I think opencode supoorts those same features
Author
Owner

@Melodeiro commented on GitHub (Dec 30, 2025):

@rekram1-node, the most desired option for me is dynamic discovery of skills, using semantic search, to make the context less bloated.

How can i disable the error message that /skills directory is wrong one? As i understood from the source code it is included in INVALID_DIRS and assertValid, and prevents opencode from starting up entirely

@Melodeiro commented on GitHub (Dec 30, 2025): @rekram1-node, the most desired option for me is dynamic discovery of skills, using semantic search, to make the context less bloated. How can i disable the error message that /skills directory is wrong one? As i understood from the source code it is included in `INVALID_DIRS` and `assertValid`, and prevents opencode from starting up entirely
Author
Owner

@rekram1-node commented on GitHub (Dec 30, 2025):

not possible to disable on ur end without source code changes

@rekram1-node commented on GitHub (Dec 30, 2025): not possible to disable on ur end without source code changes
Author
Owner

@Melodeiro commented on GitHub (Dec 30, 2025):

Yeah thats what im asking about, at least make it a non-strict rule, only as a warning

@Melodeiro commented on GitHub (Dec 30, 2025): Yeah thats what im asking about, at least make it a non-strict rule, only as a warning
Author
Owner

@rekram1-node commented on GitHub (Dec 30, 2025):

we will change this on our end

@rekram1-node commented on GitHub (Dec 30, 2025): we will change this on our end
Author
Owner

@rekram1-node commented on GitHub (Dec 30, 2025):

fixed in next release: https://github.com/sst/opencode/commit/b9ef09a0f4e8c96b4549352b53a64cee4be32aa7

@rekram1-node commented on GitHub (Dec 30, 2025): fixed in next release: https://github.com/sst/opencode/commit/b9ef09a0f4e8c96b4549352b53a64cee4be32aa7
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#3993