opencode icon indicating copy to clipboard operation
opencode copied to clipboard

Inconsistency in docs for where to install skills

Open conradkoh opened this issue 1 month ago • 5 comments

Question

In the docs for skills, it seems like it is recommending to install skills in ~/.opencode/skill, while most of the other docs are recommending that skills are installed in ~/.config/opencode/skill.

Furthermore, it seems that ~/.config/opencode/skill works fine as well, and it remains undocumented.

Link to docs.

Is there a reason for this difference? This is also important for those of us who version control our opencode configurations - having the split is sub-optimal for those cases.

Expected: There should be only one way that the docs recommend to install configurations and skills across the board

conradkoh avatar Dec 25 '25 21:12 conradkoh

Hi @conradkoh this was a miss on my end when I opened the original skill PR, actually both paths are supported by opendcode as valid global directories. I have mad a PR to clarify this.

Thanks

malhashemi avatar Dec 25 '25 23:12 malhashemi

I updated it to be ~/.config/opencode/skill in #6132 because I also got confused! Not sure why it isn't live on the website yet 🤷

connorads avatar Dec 26 '25 22:12 connorads

Great, thanks @connorads. Hmm, is the docs release pipeline not auto run on merge 🤔

conradkoh avatar Dec 26 '25 23:12 conradkoh

Yeah not sure why it's not updating @conradkoh, raised an issue https://github.com/sst/opencode/issues/6241

connorads avatar Dec 27 '25 11:12 connorads

Looks like this is sorted now https://opencode.ai/docs/skills/

Screenshot_20251228-081753.png

connorads avatar Dec 28 '25 08:12 connorads

It would be great to support standards agent skills like https://agentskills.io/home

LeoMartinDev avatar Jan 07 '26 14:01 LeoMartinDev

It would be great to support standards agent skills like https://agentskills.io/home

What do you mean exactly @LeoMartinDev? Can you give some example(s) OpenCode already supports agent skills: https://opencode.ai/docs/skills/

PS. I think we can close this issue now @conradkoh

connorads avatar Jan 07 '26 15:01 connorads

It would be great to support standards agent skills like https://agentskills.io/home

What do you mean exactly @LeoMartinDev? Can you give some example(s) OpenCode already supports agent skills: https://opencode.ai/docs/skills/

PS. I think we can close this issue now @conradkoh

Actually opencode only detects SKILLS from .claude or .opencode directories. What would be great is for opencode to support SKILLS from everywhere in the project

LeoMartinDev avatar Jan 07 '26 18:01 LeoMartinDev

@LeoMartinDev what part of the spec isn't being implemented?

rekram1-node avatar Jan 07 '26 18:01 rekram1-node