claude-code-toolkit

Error / Message

Custom slash command not found

Claude Code can't find a custom command you expected to exist — almost always a file location or naming issue.

Custom commands are markdown files in .claude/commands/ (project-level) or the equivalent user-level directory, and the command name comes directly from the filename — /review maps to review.md, for example. The most common cause of a missing command is simply the file being in the wrong directory, or a typo between the filename and the slash command being typed.

It's worth double-checking the file actually has content Claude Code recognizes as a command definition (a description and instructions), not just an empty or malformed file.

This is exactly the format the toolkit's own command pack uses — dropping its .md files straight into .claude/commands/ is meant to make this a non-issue for the commands it includes.

Confirm the file is at .claude/commands/<name>.md

Frequently asked questions

What does "Custom slash command not found" mean in Claude Code?

Claude Code can't find a custom command you expected to exist — almost always a file location or naming issue.

How do I fix it?

Try: Confirm the file is at .claude/commands/<name>.md

Is this something to worry about?

This is exactly the format the toolkit's own command pack uses — dropping its .md files straight into .claude/commands/ is meant to make this a non-issue for the commands it includes.

Is this covered in the Claude Code Toolkit?

Yes — Custom slash command not found and patterns like it are part of the full command, hook, and template pack included with a Claude Code Toolkit subscription.

Want the full command, hook, and template pack?

This is one pattern out of the full Claude Code Toolkit — subscribe for the complete set, plus everything we add going forward.

Subscribe to the toolkit — $79/mo

← See everything in Explore