[FEATURE]: Add skills.exclude config to disable specific skill directories

[ahmadaidin]

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

Problem

OpenCode scans 6 standard skill directories (global + project-level):

• ~/.config/opencode/skills//SKILL.md
• ~/.claude/skills//SKILL.md
• ~/.agents/skills//SKILL.md
• .opencode/skills//SKILL.md
• .claude/skills//SKILL.md
• .agents/skills//SKILL.md

Users may want to exclude specific directories (e.g., ~/.agents/skills/) while keeping others (e.g., ~/.claude/skills/). Currently there is no selective exclusion mechanism — either all global directories are scanned, or none via OPENCODE_DISABLE_GLOBAL_CONFIG.

Proposed Solution

Add a skills.exclude config option in opencode.json:

{
  skills: {
    exclude: [~/.agents/skills]
  }
}

Behavior:

• Accepts an array of directory paths (supports ~ expansion)
• Paths are checked against skill directory roots
• Matching directories are skipped during discovery
• Other directories remain unaffected

Why This Matters

• Users with large skill collections in ~/.agents/skills/ may want to limit noise in the available skills list
• GSD framework users have internal skills that should not appear in agent selection
• permission.skill: deny blocks programmatic spawning (via task tool), which is too restrictive

Related

• OPENCODE_DISABLE_GLOBAL_CONFIG (PR feat(config): add OPENCODE_DISABLE_GLOBAL_CONFIG flag #21650) — all-or-nothing global disable
• hidden: true frontmatter (issues [FEATURE]: Add hidden field to skill frontmatter to exclude skills from agent selection #20473/[FEATURE]: Add hidden field to skill frontmatter to exclude skills from agent selection #20474) — per-skill hiding (not yet merged)

[github-actions]

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

• [FEATURE]: Add a switch to disable automatic skill directory discovery #15396: [FEATURE]: Add a switch to disable automatic skill directory discovery (closed) — requests a similar mechanism to disable/control automatic skill directory scanning, with a proposed skills.auto_discovery config option or env var

Your proposal is more targeted (selective exclusion of specific directories vs. all-or-nothing), so it may still be distinct enough to warrant its own issue. Please review and confirm whether this addresses a different enough use case.