skills: documented slash frontmatter is not implemented in v2.0.18 #51427

Summary

The V2 skills docs document a slash frontmatter field (and metadata.opencode/slash) that controls whether a skill appears in interactive command catalogs. In the latest release (v2.0.18) neither field is parsed or exposed, so skills cannot be invoked as /skill-id and the setting has no observable effect.

Environment

• opencode version: v2.0.18 (latest V2 tag)
• OS: macOS (Darwin 25.5.0, arm64)
• Terminal: Ghostty + tmux (TERM=xterm-256color, TERM_PROGRAM=tmux, COLORTERM=truecolor)
• Shell: /bin/zsh
• Install/channel: Homebrew tap anomalyco/tap, formula opencode-v2
• Active plugins: none

Reproduction

1. Add a skill with slash: true in frontmatter, e.g. .opencode/skills/foo/SKILL.md:

   ---
   name: Foo
   description: Test skill
   slash: true
   ---
   
   Body.

2. Open the TUI and type / — no /foo (or /skill-id) entry appears in the command catalog.

3. Query the API:

   • opencode api get /api/skill — the returned skill has no slash field.
   • opencode api get /api/command — returns only commands; no skills.

4. Set slash: false instead — same result; the field is ignored either way.

Expected Behavior

Per https://opencode.ai/v2/docs/skills/ (docs source services/www/src/docs/content/skills.mdx at v2.0.18):

Skills should be present in the interactive command catalog by default, with slash / metadata.opencode/slash controlling that.

Actual Behavior

slash and metadata.opencode/slash are dropped during skill parsing at v2.0.18:

• packages/core/src/config/plugin/skill-file.ts reads only name, description, and metadata["opencode/autoinvoke"] when building Skill.Info.
• packages/schema/src/skill.ts defines Skill.Info as { id, name, description, autoinvoke, path, content }; there is no slash field.
• No other code path consumes the field.

The only user-facing skill invocation in v2.0.18 is the @ mention picker (packages/tui/src/component/prompt/autocomplete.tsx builds skill mentions with prefix = "@"), plus the /skills selector (packages/tui/src/component/dialog-skill.tsx) which inserts @skill-id. Automatic model loading via the skill tool is unaffected.

Additional Context

• Docs: https://opencode.ai/v2/docs/skills/
• Observed consistently on v2.0.18, the latest V2 release tag.
• Workaround: use @skill-id mentions or /skills.
• Possible resolution: either implement slash / metadata.opencode/slash (parse into Skill.Info, include skills in the command catalog) or remove the field from the docs until it is supported.