Will this tool delete my old command files automatically?

No. The tool performs the migration and then explicitly asks for user approval before deleting any legacy files to ensure your data is safe.

What happens if a migration fails?

The skill includes 'audit' and 'validate' actions to perform post-migration health checks, identifying any missing files or broken references for manual or automatic fixing.

Can I consolidate multiple commands into a single skill?

Yes, the 'analyze' and 'migrate' actions identify related commands (like test-unit and test-e2e) and merge them into a single skill with argument-based routing.

Does it fix broken links in my documentation?

Yes, the migration process includes a step to search your codebase for old command references and update them to the new skill paths.

Why should I migrate from commands to skills?

Skills are the modern standard for Claude Code v2.1.3+, offering better directory organization, enhanced argument support, and improved discovery via the user-invocable field.

Claude Code Skill Migrator

Name: Claude Code Skill Migrator
Author: melodic-software

bymelodic-software

•

Developer Tools

Automates the transition from legacy flat-file commands to the modern directory-based skill structure for Claude Code.

This specialized skill streamlines repository upgrades by migrating legacy .claude/commands/ files into the standardized .claude/skills/ directory format introduced in Claude Code v2.1.3+. It manages the entire lifecycle of the migration—from discovering old files and analyzing consolidation opportunities to automatically generating YAML frontmatter and updating cross-references throughout your codebase. It ensures your custom AI workflows remain compatible with the latest platform features while improving organization and argument handling.

Key Features

01Automatic discovery of legacy .md command files across project and plugin directories

0238 GitHub stars

03Intelligent consolidation of related commands into single skills with argument routing

04Global codebase scanning to update stale references and command invocations

05Comprehensive health audits with auto-remediation for naming and metadata issues

06Automated YAML frontmatter generation and tool permission inference

Use Cases

01Upgrading legacy Claude Code repositories to the modern v2.1.3+ skill architecture

02Refactoring fragmented command files into organized, noun-phrase skill directories

03Standardizing metadata and permissions across a large ecosystem of custom plugins

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add melodic-software/claude-code-plugins skill-migration

For use in Claude.ai and ChatGPT

Download Skill