Skip to content

Rename plugin /doctor command to /gm-doctor to stop shadowing built-in#30

Open
bborn wants to merge 1 commit into
mainfrom
task/4091-feedback-doctor-from-taskyou-os-plugin-h
Open

Rename plugin /doctor command to /gm-doctor to stop shadowing built-in#30
bborn wants to merge 1 commit into
mainfrom
task/4091-feedback-doctor-from-taskyou-os-plugin-h

Conversation

@bborn
Copy link
Copy Markdown
Contributor

@bborn bborn commented Jun 5, 2026

Problem

The taskyou-os plugin shipped a command named doctor, which collides with Claude CLI's built-in /doctor. As reported by Kyle Carbonneau:

/doctor (ty-os) is stealing the show from /doctor command in claude cli. Any input of /doctor routes to /taskyou-os:doctor (even if you select the claude default one with the arrow keys).

A plugin command should never share a name with a built-in — there's no plugin-side way to make the disambiguation picker honor the built-in selection. The fix is to not name the command doctor.

Fix

Rename the command doctorgm-doctor:

  • The bare /doctor now unambiguously resolves to Claude CLI's built-in.
  • gm-doctor fits the existing gm-* command family (gm-babysit, gm-fix, gm-help, gm-start, gm-status), so it groups nicely in the command picker.
  • Users run it as /gm-doctor (or /taskyou-os:gm-doctor).

Changes

  • .claude/commands/doctor.md.claude/commands/gm-doctor.md — updated name: frontmatter (doctorgm-doctor) and the in-file self-reference.
  • README.md — updated the 4 references in the Plugin Commands table and the Updating section.

Notes

  • Existing installs stop shadowing /doctor once they update the plugin (via /gm-doctor itself or /plugin marketplace add taskyou/taskyou-os, then restart Claude Code).
  • Internal scratch filenames (/tmp/doctor-nono-*) and the report's display title ("TaskYou-OS Doctor") are left as-is — they aren't command references.

🤖 Generated with Claude Code

The taskyou-os plugin shipped a command named `doctor`, which collides
with Claude CLI's built-in `/doctor`. Typing `/doctor` routed to
`/taskyou-os:doctor` even when the user explicitly picked Claude's
built-in from the disambiguation list.

Rename the command to `gm-doctor` so the bare `/doctor` unambiguously
resolves to the built-in. `gm-doctor` also fits the existing `gm-*`
command family (gm-babysit, gm-fix, gm-help, gm-start, gm-status).

- Rename .claude/commands/doctor.md -> gm-doctor.md and update its
  `name:` frontmatter and self-reference.
- Update README command table and Updating section references.

After updating the plugin, users invoke `/gm-doctor` (or
`/taskyou-os:gm-doctor`); the built-in `/doctor` is no longer shadowed.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.

1 participant