Skip to content

Fixed OpenCode skills not showing up in the composer - #7572

Closed
kridaydave wants to merge 13 commits into
pingdotgg:mainfrom
kridaydave:fix/opencode-skills-discovery
Closed

Fixed OpenCode skills not showing up in the composer#7572
kridaydave wants to merge 13 commits into
pingdotgg:mainfrom
kridaydave:fix/opencode-skills-discovery

Conversation

@kridaydave

@kridaydave kridaydave commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

OpenCode skills were not appearing in the chat composer when typing $. Added filesystem discovery for OpenCode user and project skill directories and hooked them into the provider status snapshot.

Summary :

  • Added OpenCode skill discovery scanning user and workspace skill roots (~/.config/opencode/skills, ~/.opencode/skills, $OPENCODE_CONFIG_DIR, .claude/skills, .agents/skills, .opencode/skills)
  • Implemented precedence order and frontmatter metadata parsing with clean fallback to directory name
  • Attached discovered skills to OpenCode provider snapshots in OpenCodeProvider.ts
  • Added unit tests covering skill discovery, relative path resolution, and provider status output

Ready For Review !!


Note

Medium Risk
Touches OpenCode provider snapshots and scans user/workspace skill directories, so picker contents and path handling can be wrong if discovery or merge logic is off. Not auth or data-store critical.

Overview
OpenCode skills now show in the $ picker by scanning the same user and project SKILL.md roots OpenCode itself loads, then attaching them to the provider snapshot.

discoverOpenCodeSkills walks user dirs (~/.claude, ~/.agents, XDG/~/.opencode, $OPENCODE_CONFIG_DIR) then git-ancestor project dirs (.claude / .agents / .opencode). Later roots win on name collisions; YAML frontmatter supplies name/description with a directory-name fallback. OpenCode disable flags (OPENCODE_DISABLE_EXTERNAL_SKILLS, OPENCODE_DISABLE_CLAUDE_CODE, OPENCODE_DISABLE_CLAUDE_CODE_SKILLS) skip .claude/.agents roots using the same "1"/"true" parsing.

checkOpenCodeProviderStatus merges discovered skills over SDK inventory. Local discovery is skipped when a serverUrl is set so the picker does not advertise skills an external server cannot run. Discovered skills still appear on probe error/disabled snapshots for local CLI.

Reviewed by Cursor Bugbot for commit 2496273. Bugbot is set up for automated code reviews on this repo. Configure here.

Note

Fix OpenCode skills not showing up in composer by adding local skill discovery

  • Adds discoverOpenCodeSkills in OpenCodeSkills.ts, which scans user roots (~/.claude/skills, ~/.agents/skills, ~/.config/opencode/skills, ~/.opencode/skills, $OPENCODE_CONFIG_DIR/skills) and project roots (.claude/skills, .agents/skills, .opencode/skills from git ancestor to cwd) for SKILL.md files with YAML frontmatter
  • Integrates discovery into checkOpenCodeProviderStatus in OpenCodeProvider.ts so local skills appear in the provider snapshot when using a local CLI; discovered skills override SDK-reported skills on name collisions via mergeOpenCodeSkills
  • Provides FileSystem and Path services in OpenCodeDriver.ts so the discovery effect can access the filesystem at runtime
  • Disable flags OPENCODE_DISABLE_EXTERNAL_SKILLS, OPENCODE_DISABLE_CLAUDE_CODE, and OPENCODE_DISABLE_CLAUDE_CODE_SKILLS gate which roots are scanned; only "1" and "true" count as enabled
  • Behavioral Change: when a serverUrl is configured, local skills are omitted from the snapshot to avoid advertising local-only skills for external servers

Macroscope summarized 2496273.

@coderabbitai

coderabbitai Bot commented Aug 19, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: fc7cd918-07a0-4e5b-8fab-defa38f6ef85

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added vouch:unvouched PR author is not yet trusted in the VOUCHED list. size:L 100-499 changed lines (additions + deletions). labels Aug 19, 2026
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts Outdated
@macroscopeapp

macroscopeapp Bot commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Approvability

Verdict: Skipped

Macroscope did not run approvability analysis for this PR. Macroscope could not determine whether this PR modifies its approvability configuration, so the PR was not approved automatically. A PR that may change the rules that govern approval is never approved automatically.

Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts Outdated
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts Outdated
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts Outdated
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts Outdated
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts Outdated
…overy

discoverOpenCodeSkills scanned .claude/.agents/.opencode skill roots
unconditionally, so skills the OpenCode binary itself refuses to load
could resurface in the $ picker via merge and fail when invoked.
Discovery now skips every disk root when OPENCODE_DISABLE_EXTERNAL_SKILLS
is set, and skips .claude/skills roots when OPENCODE_DISABLE_CLAUDE_CODE
or OPENCODE_DISABLE_CLAUDE_CODE_SKILLS is set.

Worked on by ox-alpha (opencode)
…e disabled

OPENCODE_DISABLE_EXTERNAL_SKILLS now drops only .claude/skills and
.agents/skills roots instead of all discovery, matching upstream OpenCode,
and disable flags parse strictly as 1/true like OpenCode's truthy helper.
@kridaydave
kridaydave force-pushed the fix/opencode-skills-discovery branch from fd908e9 to e950bfa Compare August 22, 2026 09:40
Comment thread apps/server/src/provider/Layers/OpenCodeProvider.ts Outdated
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts Outdated
Comment thread apps/server/src/provider/Layers/OpenCodeProvider.ts
…emote OpenCode

Unterminated SKILL.md frontmatter blocks are now treated as malformed
instead of publishing the skill under its directory name. When a serverUrl
is configured, checkOpenCodeProviderStatus no longer runs local disk
discovery so only skills from the external OpenCode server are advertised.
Comment thread apps/server/src/provider/Drivers/OpenCodeSkills.ts
Empty fences (---/---) now parse as valid frontmatter with no metadata,
so the skill is published under its directory name as upstream's
gray-matter parser does, instead of being skipped.
@jappyjan

Copy link
Copy Markdown
Contributor

+1 on this. would highly appreciate a fix soon, it sucks quite hard to not be able to see and activate your skills through the T3Code ui :/

@cursor cursor Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 2496273. Configure here.

? []
: [{ directory: path.join(dir, ".agents", "skills"), scope: "project" as const }]),
{ directory: path.join(dir, ".opencode", "skills"), scope: "project" as const },
]),

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Singular skill dirs skipped

Medium Severity

OpenCode discovers native skills under both skill/ and skills/ (glob {skill,skills}/**/SKILL.md on .opencode and config roots). discoverOpenCodeSkills only scans the plural skills directory on those roots, so skills kept under singular skill/ never reach the composer $ picker even though OpenCode loads them.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 2496273. Configure here.

@t3dotgg

t3dotgg commented Aug 23, 2026

Copy link
Copy Markdown
Member

Note

🤖 GPT-5.6 Sol responding on behalf of Theo

Closing this PR after an automated pass over open pull requests. OpenCode skill discovery already shipped in #3154.

@t3dotgg t3dotgg closed this Aug 23, 2026
@kridaydave

Copy link
Copy Markdown
Contributor Author

[!NOTE]
🤖 GPT-5.6 Sol responding on behalf of Theo

Closing this PR after an automated pass over open pull requests. OpenCode skill discovery already shipped in #3154.

Didn't work in latest commit. Worth a look

@kridaydave

Copy link
Copy Markdown
Contributor Author

@t3dotgg this has been incorrectly closed. Skill discovery didn't work in latest release for opencode . I'm sorry if this incorrect/inconvient.

@jappyjan

Copy link
Copy Markdown
Contributor

+1 latest release does not work!

@kridaydave

Copy link
Copy Markdown
Contributor Author

@juliusmarminge Please reopen this, it has been wrongly closed

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

Labels

size:L 100-499 changed lines (additions + deletions). vouch:unvouched PR author is not yet trusted in the VOUCHED list.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants