Summary
docs/docs/configure/skills.md ("Disabling External Skills") tells users to set:
export ALTIMATE_CLI_DISABLE_EXTERNAL_SKILLS=true
The flag code only reads the OPENCODE_ spelling:
// packages/opencode/src/flag/flag.ts
export const OPENCODE_DISABLE_EXTERNAL_SKILLS =
OPENCODE_DISABLE_CLAUDE_CODE_SKILLS || truthy("OPENCODE_DISABLE_EXTERNAL_SKILLS")
Other flags in the same file use altTruthy("ALTIMATE_CLI_…", "OPENCODE_…") for dual support (for example OPENCODE_DISABLE_AUTOUPDATE), so this one was missed. Setting the documented variable has no effect: skills from ~/.claude/skills and ~/.agents/skills still load.
Verified on v0.12.0: with only ALTIMATE_CLI_DISABLE_EXTERNAL_SKILLS=true set, a personal skill from ~/.claude/skills was listed and invoked by the model; with OPENCODE_DISABLE_EXTERNAL_SKILLS=true it was not.
Fix
Use altTruthy("ALTIMATE_CLI_DISABLE_EXTERNAL_SKILLS", "OPENCODE_DISABLE_EXTERNAL_SKILLS") in flag.ts (and the same for OPENCODE_DISABLE_CLAUDE_CODE_SKILLS / OPENCODE_DISABLE_CLAUDE_CODE if they are documented under the ALTIMATE_CLI_ name), or change the docs to the OPENCODE_ name. docs/docs/usage/cli.md should list whichever name wins in its environment-variable table.
Summary
docs/docs/configure/skills.md("Disabling External Skills") tells users to set:export ALTIMATE_CLI_DISABLE_EXTERNAL_SKILLS=trueThe flag code only reads the
OPENCODE_spelling:Other flags in the same file use
altTruthy("ALTIMATE_CLI_…", "OPENCODE_…")for dual support (for exampleOPENCODE_DISABLE_AUTOUPDATE), so this one was missed. Setting the documented variable has no effect: skills from~/.claude/skillsand~/.agents/skillsstill load.Verified on v0.12.0: with only
ALTIMATE_CLI_DISABLE_EXTERNAL_SKILLS=trueset, a personal skill from~/.claude/skillswas listed and invoked by the model; withOPENCODE_DISABLE_EXTERNAL_SKILLS=trueit was not.Fix
Use
altTruthy("ALTIMATE_CLI_DISABLE_EXTERNAL_SKILLS", "OPENCODE_DISABLE_EXTERNAL_SKILLS")inflag.ts(and the same forOPENCODE_DISABLE_CLAUDE_CODE_SKILLS/OPENCODE_DISABLE_CLAUDE_CODEif they are documented under theALTIMATE_CLI_name), or change the docs to theOPENCODE_name.docs/docs/usage/cli.mdshould list whichever name wins in its environment-variable table.