docs(upgrade): Claude Code files live in .claude/skills, not .claude/commands#3708
Merged
Merged
Conversation
…commands The Claude Code integration installs skills into `.claude/skills` (see integrations/claude: `"dir": ".claude/skills"`), and the "what gets kept" list earlier in this same doc already says `.claude/skills/`. But three troubleshooting/reference spots still point users at `.claude/commands/`, which does not exist for a Claude Code install -- so the "verify files exist" checks list an empty/missing directory. Correct all three to `.claude/skills/`. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Collaborator
|
Thank you! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
docs/upgrade.mdpoints users at.claude/commands/in three places when verifying/locating Claude Code's installed files:ls -la .claude/commands/ # Claude Code)But the Claude Code integration installs into
.claude/skills(src/specify_cli/integrations/claude/__init__.py→"dir": ".claude/skills"), and the "what gets kept" list earlier in this same doc (line 98) already correctly says.claude/skills/. So the doc is internally inconsistent, and the three troubleshooting checks tell users tolsa directory that does not exist for a Claude Code install.Fix
Correct all three spots to
.claude/skills/(and reword one label to "command/skill files" to match line 98's phrasing). Documentation-only.Verification
grep .claude/commands docs/upgrade.md→ no matches remain.integrations/claude("dir": ".claude/skills") and the already-correct line 98.markdownlint-cli2 docs/upgrade.md→ 0 issues.AI-assisted: authored with Claude Code. I confirmed the install dir in the integration source and that line 98 of the same doc already uses
.claude/skills/.