Inconsistency in docs for where to install skills

[conradkoh]

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

[malhashemi]

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

[connorads]

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 🤷

[conradkoh]

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

[connorads]

Yeah not sure why it's not updating @conradkoh, raised an issue #6241

[connorads]

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