Skip to content

skills: slash frontmatter field has no effect; skills never appear in the command registry #51753

Closed

Description

@wompix

Description

The V2 skills docs document a slash frontmatter field (and metadata.opencode/slash) that controls whether a skill appears in interactive command catalogs. In 2.0.18 the field is not implemented: skills never populate the command registry, so a skill cannot be invoked as /skill-id.

Setting metadata.opencode/slash: true explicitly produces no change. The skill is otherwise wired up correctly — /api/skill returns it with autoinvoke: false parsed as expected, and it loads fine by ID through the skill tool — so this is not a frontmatter-parsing problem.

A command file in ~/.config/opencode/commands/ does appear in the registry immediately, which is the current workaround:

---
description: Rewrite text in ASD-STE100 Simplified Technical English
---

Load the `asd-ste100` skill with the skill tool, then apply it to the text below.

$ARGUMENTS

Related: #51427 (closed) reports the same missing slash support in 2.0.18, and #50638 reports skills missing from the Desktop slash list including with slash: true. Filing separately only to add two details those reports do not cover: that opencode/autoinvoke parses correctly from the same metadata block (ruling out malformed frontmatter as the cause), and the command-file workaround above. Happy for this to be merged into either.

Steps to reproduce

  1. Create ~/.config/opencode/skills/example/SKILL.md:

    ---
    name: example
    description: An example skill
    metadata:
      opencode/autoinvoke: false
      opencode/slash: true
    ---
    
    Body.
  2. opencode api get /api/skill — the skill is listed, with "autoinvoke": false.

  3. opencode api get /api/command — only init and review are returned. example is absent.

  4. Type / in the TUI — no example entry.

Reproduces 100% of the time, including across a full service restart.

Plugins

None.

OpenCode version

2.0.18 (latest)

Operating System

Linux 7.2.4-ogc3.1.fc44.x86_64 (Fedora 44)

Terminal

xterm-256color, COLORTERM=truecolor, TERM_PROGRAM unset

Screenshot and/or share link

None. The /api/command and /api/skill responses above are the evidence; happy to attach a share link if useful.

Activity

  1. added
    needs:complianceThis means the issue will auto-close after 2 hours.
    and removed
    needs:complianceThis means the issue will auto-close after 2 hours.
    on Sep 28, 2026
  2. github-actions commented on Sep 28, 2026

    @github-actions
    Contributor

    Thanks for updating the issue with the required description and reproduction details!

  3. Tarquinen commented on Oct 20, 2026

    @Tarquinen
    Member

    This was fixed by #52752. That PR merged into the v2 branch, so GitHub didn't close this issue automatically. Closing as completed.

    — from 𝕺𝖕𝖊𝖓𝕮𝖔𝖉𝖊

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions