Skip to content

[Bug]: .claude/commands/ no longer recognized in Claude Code v2.1.88 — needs migration to .claude/skills/ #2031

@S2thend

Description

@S2thend

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

  1. Install spec-kit and run specify init (creates files in .claude/commands/)
  2. Upgrade Claude Code to v2.1.88
  3. Type /speckit.analyze in the prompt
  4. 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).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions