Support for agentskills.io Standard

[LeoMartinDev]

Feature hasn't been suggested before.

• I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

Current OpenCode skill discovery is limited to fixed paths like .opencode/skill/<name>/SKILL.md and .claude/skills/, requiring skills to live in specific subdirectories . This lacks flexibility for broader standards. The agentskills.io protocol offers a standardized way to package reusable procedural knowledge and capabilities that agents can load on demand.

Example Implementation

# In any repo directory: ./skills/marketing/SKILL.md or ./src/tools/SKILL.md
# Agent prompts: "Use the marketing skill to generate a campaign"
# OpenCode lists: Available skills: marketing (./skills/marketing), git-release (./.opencode/skill/git-release)

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• Does opencode actually support finding skills at .claude/skills? #6266: Does opencode actually support finding skills at .claude/skills? (discusses configurability of skill discovery paths)
• [FEATURE]: Plugin Hook for Registering Additional Config Directories #6347: [FEATURE]: Plugin Hook for Registering Additional Config Directories (requests ability to register custom directories for skills and other resources)
• Inconsistency in docs for where to install skills #6171: Inconsistency in docs for where to install skills (discusses flexible skill installation paths)

Feel free to ignore if none of these address your specific case.

[developerfred]

@LeoMartinDev have you already taken a look at https://github.com/code-yeongyu/oh-my-opencode It's a plugin that offers this native support; it's an OpenCode plugin.

[rekram1-node]

@LeoMartinDev .skills/ doesnt appear to be part of the spec. Can you show me where it has that?

[LeoMartinDev]

.skills is an example path, it could be anywhere I guess as long as it's folder containing a SKILL.md file.
Cursor recently started to support this https://cursor.com/docs/context/skills

[diegohb]

I wanted to continue this discussion...

It is confusing and would be ideal to conform to the spec.. below is some context on de-confusing myself which not even Opus was able to formulate the questions to clear itself up for 5 hours today dealing with these nuances and non-conforming details with OpenCode's implementation.

DeepWiki:

1. Asking AgentSkills if its documented to be supported by OpenCode: https://deepwiki.com/search/is-this-compatible-with-openco_3ab76476-4748-4b11-81da-ccd475cc3d96?mode=fast
2. Asking OpenCode if it does in fact conform to AgentSkills: https://deepwiki.com/search/according-to-the-agent-skills_89eec9f3-6b4e-48bb-b808-96c215b349c2?mode=deep

If the lack of conformity to the spec as its written was an intentional design decision, I happen to agree that skills should be instruction-only and therefore makes sense NOT to allow executable scripts to be bundled with them. But then maybe its an opportunity to collaborate with agentskills.io to change that in spec OR have them update and make clear in OpenCode docs that it does NOT support that aspect of the spec

Another thing slightly off-topic is that all extensibility features support intermediary directories except tools which requires tool files to be exactly at ~/.opencode/tools/ ... this took some time to understand but I definitely made the assumption.

[github-actions]

To stay organized issues are automatically closed after 90 days of no activity. If the issue is still relevant please open a new one.