Skip to content

Document workaround for hidden explicit commands#537

Open
Kevinjohn wants to merge 1 commit into
openai:mainfrom
Kevinjohn:docs/model-invocation-workaround
Open

Document workaround for hidden explicit commands#537
Kevinjohn wants to merge 1 commit into
openai:mainfrom
Kevinjohn:docs/model-invocation-workaround

Conversation

@Kevinjohn

@Kevinjohn Kevinjohn commented Jul 19, 2026

Copy link
Copy Markdown

Users can be told an explicitly entered /codex:* command is unavailable because Claude Code hides manual-only commands from the agent's skills list.

Closes #238.

Observable sequence

  • Enter a command such as /codex:status or /codex:review.
  • Expected: Claude attempts the explicit command.
  • Actual: Claude may refuse because commands with disable-model-invocation: true are absent from its available-skills list.

Documentation change

  • Add a troubleshooting entry linked to the upstream Claude Code issue.
  • List every currently affected plugin command.
  • Provide a ready-to-paste global CLAUDE.md instruction that distinguishes explicit user commands from automatic model invocation.

This is a documentation-only change; command configuration and runtime behavior are unchanged.

Validation

  • node --test tests/commands.test.mjs: 8 passed
  • Full test suite: passed
  • git diff --check: clean

Actual screenshots

README workaround — actual terminal diff

The terminal diff adds the troubleshooting note and global CLAUDE.md workaround

Focused documentation validation — actual terminal output

Eight focused command documentation tests passing in the terminal

@Kevinjohn
Kevinjohn marked this pull request as ready for review July 20, 2026 12:21
@Kevinjohn
Kevinjohn requested a review from a team July 20, 2026 12:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document workaround for disable-model-invocation: true commands (agents refuse to invoke until nudged)

1 participant