v1.39.0: Installer doesn't create slash commands for Claude Code

[tyluhow-hatch]

Bug Report

Version: 1.39.0
Runtime: Claude Code
Install command: npx get-shit-done-cc@latest --claude --global

Issue

After upgrading from v1.30.0 to v1.39.0, the installer no longer creates slash commands in ~/.claude/commands/gsd/. The installer output says to run /gsd-new-project, but that command doesn't exist.

Expected Behavior

The installer should create slash command wrappers in ~/.claude/commands/gsd/ that invoke the skills.

Actual Behavior

• 65 skills are correctly installed to ~/.claude/skills/gsd-*/
• No slash commands created in ~/.claude/commands/gsd/
• Typing /gsd in Claude Code shows no commands
• The installer message says "run /gsd-new-project" but that command doesn't exist

What Was Working in v1.30.0

In v1.30.0, slash commands existed in get-shit-done/commands/gsd/ which were available as /gsd-* commands.

Environment

• macOS (Darwin 24.6.0)
• Claude Code
• GSD installed globally to ~/.claude/

Workaround Needed

Users need to either:

1. Invoke skills through the AI ("run gsd-help")
2. Manually create slash command wrappers
3. Downgrade to v1.30.0

Reproduction Steps

1. npx get-shit-done-cc@latest --claude --global
2. Restart Claude Code
3. Type /gsd - no commands appear
4. Check ls ~/.claude/commands/gsd/ - directory doesn't exist

Request

Either:

• Restore slash command generation in the installer, OR
• Update documentation/output to reflect skills-only architecture

[trek-e]

This was generated by AI during triage.

Triage Notes

Confirmed in source. For npx get-shit-done-cc@latest --claude --global, bin/install.js (lines ~7168–7193) intentionally writes skills to ~/.claude/skills/gsd-*/SKILL.md (Claude Code 2.1.88+ format) and deletes the legacy ~/.claude/commands/gsd/ directory. So the reporter's observation ("65 skills installed, no commands/gsd/") matches the implemented behavior — that part is by design.

The bug is in two adjacent layers:

1. Stale post-install message. bin/install.js:8139–8154 prints Open a blank directory in Claude Code and run /gsd-new-project for the claude runtime, regardless of install mode. For --claude --global (skills-only), /gsd-new-project is not a literal slash command on Claude Code versions that don't auto-derive slash entries from skills/<x>/SKILL.md. Users on those versions type /gsd-new-project and get nothing.
2. Documentation drift. Multiple references in README and the help workflow still talk about /gsd-* slash commands as the primary entry point, with no callout that on global installs the user invokes the skill (e.g., "use the gsd-new-project skill" / mention by name).

Reproducibility. The reporter's repro is exact and matches the code path. No additional info needed to act.

Agent Brief — ready-for-agent

Goal. Make the post-install handoff for --claude --global accurate, and align user-facing docs with the skills-only install layout.

Scope.

1. Post-install message (bin/install.js:8124–8157).
   When runtime === 'claude' && isGlobal, replace the /gsd-new-project instruction with skill-invocation guidance that works on current Claude Code versions, e.g.:

   "Open a blank directory in Claude Code and ask Claude to run the gsd-new-project skill (or type /gsd-new-project if your Claude Code version surfaces skills in the slash menu — Claude Code 2.1.88+)."
   Keep the local-install message (commands/gsd/ mode) as-is — /gsd-new-project works in that path.

2. Verify slash-menu surfacing on current CC. Install GSD globally on Claude Code ≥2.1.88 and confirm whether typing /gsd surfaces the installed skills/gsd-*/SKILL.md entries. If yes, the message can keep /gsd-new-project with a CC-version note; if no, the message must use natural-language skill invocation. Capture findings in the PR description.
3. Docs sweep. Audit README.md, get-shit-done/workflows/help.md, and any onboarding docs for /gsd-* references that assume the legacy commands/gsd/ install. Either:
   • keep the slash-command notation but add a top-of-doc note about the two install modes, or
   • replace with neutral "run the gsd-X skill" language.
     Match whatever is verified in step 2.
4. CHANGELOG.md under Fix — describe both the message correction and any docs alignment.

Out of scope. Re-introducing commands/gsd/ for global Claude installs (that's the v1.39 architecture decision). Don't revert that.

Acceptance.

• Fresh npx get-shit-done-cc@latest --claude --global on Claude Code ≥2.1.88: the printed post-install instruction works verbatim (either as a slash command if surfaced, or as a skill name the user can ask Claude to invoke).
• README and help.md no longer instruct users to type a /gsd-* slash command without disambiguating install mode.
• Manual repro from the issue body produces a usable workflow, not a dead-end /gsd slash menu.

[github-actions]

Branch fix/2957-v1-39-0-installer-doesn-t-create-slash-c created.

git fetch origin && git checkout fix/2957-v1-39-0-installer-doesn-t-create-slash-c