-
Notifications
You must be signed in to change notification settings - Fork 7.2k
[Bug]: .claude/commands/ no longer recognized in Claude Code v2.1.88 — needs migration to .claude/skills/ #2031
Description
Bug Description
After upgrading to Claude Code v2.1.88, all speckit slash commands (/speckit.analyze, /speckit.plan, etc.) installed via
specify init in .claude/commands/ return "Unknown skill" when invoked. The /skills dialog does not list them either.
Claude Code has unified the old "commands" and "skills" systems — .claude/commands/ is no longer scanned for slash
commands. Only .claude/skills//SKILL.md format is recognized.
Steps to Reproduce
- Install spec-kit and run specify init (creates files in .claude/commands/)
- Upgrade Claude Code to v2.1.88
- Type /speckit.analyze in the prompt
- See: "Unknown skill: speckit.analyze"
Expected Behavior
Slash commands should be available as /speckit.analyze, /speckit.plan, etc.
Actual Behavior
All speckit commands return "Unknown skill" — Claude Code no longer reads .claude/commands/.
Specify CLI Version
spec-kit (latest via specify init)
AI Agent
Claude Code
Operating System
macOS (Darwin 25.3.0)
Python Version
Python 3.14.2
Error Logs
Additional Context
Related to #291 but a different root cause — this is not a path/cwd issue. The .claude/commands/ mechanism itself has
been deprecated in favor of .claude/skills/. The specify init command needs to be updated to output skills-format files
(.claude/skills//SKILL.md with proper frontmatter including name, description, user-invocable: true).