commands-migrate-to-skills

Migration guidance for deprecated Commands

Warning

Rule Details

This rule complements commands-deprecated-directory by providing detailed, actionable migration instructions when a .claude/commands directory is detected. It walks through the four steps needed to convert each command into a properly structured skill: creating the skill directory, moving scripts, adding SKILL.md with frontmatter, and updating plugin.json references.

Incorrect

Legacy command file in .claude/commands

# .claude/commands/deploy.md
Run the deployment script.

```bash
./scripts/deploy.sh
```

Correct

Equivalent skill with proper structure

# .claude/skills/deploy/SKILL.md
---
name: deploy
description: Run the deployment script
---

## Usage

Invoke with `/deploy` to run the deployment pipeline.

How To Fix

1. Create a skill directory: .claude/skills/<skill-name>/
2. Move command scripts to <skill-name>/<skill-name>.sh
3. Add a SKILL.md with YAML frontmatter (name, description) and documentation
4. Update plugin.json to reference skills instead of commands
5. Remove the old command file from .claude/commands/

Options

This rule does not have any configuration options.

Related Rules

• commands-deprecated-directory

Resources

• Rule Implementation
• Rule Tests

Version

Available since: v0.2.0