anomalyco/opencode
1
0
Fork 0
mirror of https://github.com/anomalyco/opencode.git synced 2026-07-22 02:05:26 -04:00
Code Issues 5.9k Packages Projects Releases 19 Wiki Activity

Inconsistency in docs for where to install skills #3868

New Issue
Closed
opened 2026-02-16 17:41:45 -05:00 by yindo · 9 comments
yindo commented 2026-02-16 17:41:45 -05:00
Owner
Copy Link
Copy Source

Originally created by @conradkoh on GitHub (Dec 25, 2025).

Originally assigned to: @jayair on GitHub.

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

Originally created by @conradkoh on GitHub (Dec 25, 2025). Originally assigned to: @jayair on GitHub. ### 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](https://opencode.ai/docs/skills/). 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
yindo added the docs label 2026-02-16 17:41:45 -05:00
yindo closed this issue 2026-02-16 17:41:45 -05:00
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

@malhashemi commented on GitHub (Dec 25, 2025):

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 commented on GitHub (Dec 25, 2025): 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
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

@connorads commented on GitHub (Dec 26, 2025):

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 commented on GitHub (Dec 26, 2025): 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 🤷
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

@conradkoh commented on GitHub (Dec 26, 2025):

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

@conradkoh commented on GitHub (Dec 26, 2025): Great, thanks @connorads. Hmm, is the docs release pipeline not auto run on merge 🤔
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

@connorads commented on GitHub (Dec 27, 2025):

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

@connorads commented on GitHub (Dec 27, 2025): Yeah not sure why it's not updating @conradkoh, raised an issue https://github.com/sst/opencode/issues/6241
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

@connorads commented on GitHub (Dec 28, 2025):

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

Screenshot_20251228-081753.png

@connorads commented on GitHub (Dec 28, 2025): Looks like this is sorted now https://opencode.ai/docs/skills/ ![Screenshot_20251228-081753.png](https://github.com/user-attachments/assets/8f722f88-3ac2-44d4-adab-2042ed2af9c6)
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

@LeoMartinDev commented on GitHub (Jan 7, 2026):

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

@LeoMartinDev commented on GitHub (Jan 7, 2026): It would be great to support standards agent skills like https://agentskills.io/home
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

@connorads commented on GitHub (Jan 7, 2026):

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 commented on GitHub (Jan 7, 2026): > 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
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

@LeoMartinDev commented on GitHub (Jan 7, 2026):

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 commented on GitHub (Jan 7, 2026): > > It would be great to support standards agent skills like https://agentskills.io/home > > What do you mean exactly [@LeoMartinDev](https://github.com/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](https://github.com/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
yindo commented 2026-02-16 17:41:45 -05:00
Author
Owner
Copy Link
Copy Source

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

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

@rekram1-node commented on GitHub (Jan 7, 2026): @LeoMartinDev what part of the spec isn't being implemented?
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
acp
bad
bug
discussion
docs
documentation
enhancement
extension
good first issue
growth
help-wanted
mcp
model-problem
needs:compliance
nix
opentui
perf
pull-request
Mirrored from GitHub Pull Request
 tui
web
windows
zen
No Label docs
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#3868
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?