claude-command-naming

Command files should use kebab-case naming

Formerly known as command-naming. The legacy name still works in configs, --rule/--skip-rule, suppression comments, and baselines.

Severity	warning
Autofix	auto
Since	v0.1.0
Category	Claude Code

Why

Command file names are used as identifiers in invocation syntax (/plugin:command-name). Non-kebab-case names break conventions and may not be recognized by all runtimes.

Examples

Bad:

commands/deployStaging.md
commands/Run_Tests.md

Good:

commands/deploy-staging.md
commands/run-tests.md

How to fix

Rename the command file to use kebab-case (lowercase letters and hyphens only). skillsaw fix can suggest the correct filename.

Configuration

rules:
  claude-command-naming:
    enabled: true  # true | false | auto
    severity: warning

Run skillsaw explain claude-command-naming to see this documentation and the rule's effective configuration in your terminal.