Repository navigation
bug: OPENCODE_DISABLE_CLAUDE_CODE 不应禁用 .agents/skills/ 技能加载 #25119
Description
Description
设置 OPENCODE_DISABLE_CLAUDE_CODE=1 环境变量后，.agents/skills/xxx/SKILL.md 文件无法被加载。
Root Cause
在 packages/core/src/flag/flag.ts 中，标志级联链路为：
OPENCODE_DISABLE_CLAUDE_CODE=1
→ OPENCODE_DISABLE_CLAUDE_CODE_SKILLS = true (line 22-23)
→ OPENCODE_DISABLE_EXTERNAL_SKILLS = true (line 50)
在 packages/opencode/src/skill/index.ts:155 中：
if (!Flag.OPENCODE_DISABLE_EXTERNAL_SKILLS) {
// 扫描 ~/.claude/skills/**/SKILL.md 和 ~/.agents/skills/**/SKILL.md
// 扫描项目祖先目录中的 .claude/ 和 .agents/
}OPENCODE_DISABLE_EXTERNAL_SKILLS 为 true 后，.claude/skills/ 和 .agents/skills/ 都被跳过了。
问题
.agents/ 目录是 opencode 自身的惯例（见 skill/index.ts:23: EXTERNAL_DIRS = [".claude", ".agents"]），不应受 OPENCODE_DISABLE_CLAUDE_CODE 影响。
.claude/是 Claude Code 的目录约定，禁用是合理的.agents/是 opencode 自己的约定，将两者捆绑在一起会导致：用户只想禁用 Claude Code 兼容行为，却无意中连 opencode 自身的.agents/技能也禁用了
Suggested Fix
将 EXTERNAL_DIRS 按来源拆分，让 .agents/ 的扫描不受 OPENCODE_DISABLE_CLAUDE_CODE 影响：
.claude/skills/— 受OPENCODE_DISABLE_CLAUDE_CODE控制（现状合理）.agents/skills/— 应有独立 flag（如OPENCODE_DISABLE_AGENTS_SKILLS）或不受此 flag 影响
Steps to Reproduce
export OPENCODE_DISABLE_CLAUDE_CODE=1- 在项目目录创建
.agents/skills/test-skill/SKILL.md（含合法name、descriptionfrontmatter） - 启动 opencode
- 检查 available skills — 该技能不会出现
Operating System
Linux
Activity
github-actions commentedon Apr 30, 2026
This issue might be a duplicate of existing issues. Please check:
OPENCODE_DISABLE_CLAUDE_CODE=1also disables.agents/skillsloadingdevcxl commentedon Apr 30, 2026
English translation of the issue:
Setting
OPENCODE_DISABLE_CLAUDE_CODE=1prevents.agents/skills/xxx/SKILL.mdfiles from being loaded.Root Cause
In
packages/core/src/flag/flag.ts, the flag cascade chain is:In
packages/opencode/src/skill/index.ts:155:When
OPENCODE_DISABLE_EXTERNAL_SKILLSis true, both.claude/skills/and.agents/skills/are skipped entirely.The Problem
.agents/is opencode's own convention (seeskill/index.ts:23:EXTERNAL_DIRS = [".claude", ".agents"]) and should NOT be affected byOPENCODE_DISABLE_CLAUDE_CODE..claude/is a Claude Code directory convention — disabling it makes sense.agents/is opencode's own convention — tying them together means users who only want to disable Claude Code compatibility inadvertently lose opencode's own.agents/skillsSuggested Fix
Separate the
EXTERNAL_DIRShandling so that.agents/scanning is not affected byOPENCODE_DISABLE_CLAUDE_CODE:.claude/skills/— controlled byOPENCODE_DISABLE_CLAUDE_CODE(current behavior is fine).agents/skills/— should have its own independent flag (e.g.OPENCODE_DISABLE_AGENTS_SKILLS) or not be affected by this flag at allSteps to Reproduce
export OPENCODE_DISABLE_CLAUDE_CODE=1.agents/skills/test-skill/SKILL.mdin a project directory (with validnameanddescriptionfrontmatter)