Skip to content

Docs name ALTIMATE_CLI_DISABLE_EXTERNAL_SKILLS but only OPENCODE_DISABLE_EXTERNAL_SKILLS is read #1329

Description

@anandgupta42

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.

Activity

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

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions