feat(skill): change skill path to skills/

[pascalandy]

Summary

• Changed skill discovery path from .opencode/skill/ to .opencode/skills/ (plural).
• Added support for discovering skills from .claude/skills/ in both project and home directories.
• Added validation to guide users to use the plural skills/ directory.
• Updated documentation and tests to reflect these changes.

Context

In version 1.0.192, skills located in .opencode/skill/ (as previously documented) were failing to load for users with large skill libraries (~25 skills).

Solution: Renaming the parent directory to skills/ resolved the issue.

While the Agent Skills spec defines the SKILL.md file, it does not strictly define the parent directory name. This PR standardizes on skills/ to align with Claude-compatible conventions and ensures OpenCode looks in both .opencode/ and .claude/ locations. This fixes the documentation mismatch and the loading issue.

tree

per example, this works as expected as tested in the current version of oc (1.0.192)

.opencode
├── agent
├── command
└── skills
    ├── changelog
    │   ├── references
    │   │   └── changelog_sop.md
    │   └── SKILL.md
    ├── cli-gh
    │   ├── references
    │   │   └── help.md
    │   └── SKILL.md
    └── cli-chezmoi
        ├── references
        │   └── cli_reference.md
        ├── scripts
        │   └── apply_chezmoi.sh
        ├── assets
        └── SKILL.md

Session

https://opncd.ai/share/1XhiOijp

Crap, this share seems broken 😥

[rekram1-node]

opencode uses singular for everything else so while we may pick up skills in addition to skill we don't want to disallow skill and we still should read skill.

We can load the claude skills but we need to fix the validation to be less strict

[rekram1-node]

for now let's not read "skills/", we will pick it up if we allow pluralization of all the other dirs too

[pascalandy]

So meanwhile, I was about to report back..
and I guess the confirmation that a skill triggered is this:

It's a bit hard to test as this is not deterministic

I'll use skill then :-p

[connorads]

@pascalandy It's a bit hard to test as this is not deterministic

FYI @pascalandy I've since learned that you can see which skills are loaded with opencode debug skill

opencode debug skill
[
  {
    "name": "global-opencode-skill",
    "description": "Global .opencode skill for troubleshooting discovery.",
    "location": "/Users/connorads/.config/opencode/skill/global-opencode-skill/SKILL.md"
  },
  {
    "name": "test-skill",
    "description": "use this when asked to test skill",
    "location": "/Users/connorads/git/opencode/.opencode/skill/test-skill/SKILL.md"
  }
]

And hopefully you won't need to use that either if we can get something like #6154 merged 🤞

[timothyis]

This change looks to be already implemented https://opencode.ai/docs/skills/#place-files