Skip to content

Slash skill commands do not reload edited SKILL.md content #49451

Closed as not planned

Description

@lazyayuan

Problem

When developing a project-local Skill, editing .opencode/skills/<name>/SKILL.md in VS Code is reflected in the file/Git diff, but invoking /<name> in OpenCode still uses the content loaded when the process started. Developers must restart OpenCode to test each Skill edit.

Reproduction

  1. Start OpenCode with a project-local Skill.
  2. Invoke /<skill-name> once.
  3. Edit and save that Skill's SKILL.md.
  4. Invoke /<skill-name> again.

The second invocation returns the old Skill body.

Expected behavior

Slash commands backed by Skills should reload the current SKILL.md content when invoked. Existing conversation output should remain immutable history.

Root cause

The Command service builds slash commands from skill.all() at initialization and closes over item.content, so /skill-name never reaches the Skill service again.

Why this is distinct

This is not about discovering Skills created after startup (#42478) or adding a general file-watching system (#8751, #34492). The Skill already exists and is listed correctly. Its disk-backed content can already be reloaded by Skill.require(), but the slash command path bypasses that reload by retaining the initial item.content snapshot.

Activity

  1. github-actions commented on Sep 17, 2026

    @github-actions
    Contributor

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

    If your report is specifically about the slash command handler caching item.content at startup (rather than discovery of new skills), it may still be worth keeping open as a distinct bug, but please check the linked issues first.

  2. neriousy commented on Oct 20, 2026

    @neriousy
    Member

    Thanks for reporting this! In V2, the old skill slash-command path was removed in 2.0.4: use @skill-id in your prompt instead, and local SKILL.md edits refresh automatically for subsequent prompts without rewriting earlier messages. Update with opencode upgrade or npm i -g @opencode/cli@latest (desktop: update the app). Please comment or reopen if edited skills still load stale content on that version or newer.

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