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 😥