opencode icon indicating copy to clipboard operation
opencode copied to clipboard

Backward compatibility broken - enforcement of the /skill directory naming

Open Melodeiro opened this issue 3 months ago • 6 comments

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

Melodeiro avatar Dec 30 '25 09:12 Melodeiro

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] avatar Dec 30 '25 09:12 github-actions[bot]

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 avatar Dec 30 '25 12:12 Melodeiro

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

rekram1-node avatar Dec 30 '25 12:12 rekram1-node

@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 avatar Dec 30 '25 12:12 Melodeiro

not possible to disable on ur end without source code changes

rekram1-node avatar Dec 30 '25 13:12 rekram1-node

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

Melodeiro avatar Dec 30 '25 13:12 Melodeiro

we will change this on our end

rekram1-node avatar Dec 30 '25 14:12 rekram1-node

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

rekram1-node avatar Dec 31 '25 00:12 rekram1-node