How does it handle non-standard filenames?

The skill applies a set of normalization rules—lowercasing, replacing spaces with hyphens, and removing special characters—to ensure filenames meet the platform requirements.

Why should I migrate my plugin to the directory format?

The directory format is the current standard for Claude Code, allowing for better organization of metadata, reference files, and assets within each specific skill or command.

Can this skill detect tool permissions automatically?

Yes, it scans your existing content for logic involving reading, writing, or searching to automatically suggest the correct 'allowed-tools' in the YAML frontmatter.

Does it work for both skills and agents?

Yes, the migration guide provides specific procedures and frontmatter extraction rules for both skill files and agent configurations to ensure consistency across your plugin.

Claude Plugin Migration Guide

Name: Claude Plugin Migration Guide
Author: astoeffer

byastoeffer

开发者工具

Standardizes and migrates legacy Claude Code plugins to the current directory-based format and specification.

关于

The Migration Guide skill automates the transition of Claude Code plugins from legacy flat-file structures to the modern directory-based format required for full compatibility. It intelligently extracts frontmatter metadata, handles complex directory restructuring for skills and agents, and ensures all required fields—such as tool permissions and descriptions—are accurately populated. This tool is essential for developers maintaining or upgrading older plugin repositories to ensure they meet the latest Claude Code standards and marketplace requirements.

主要功能

0 GitHub stars
Automatically extracts and populates missing YAML frontmatter from existing content
Restructures plugin root folders to comply with .claude-plugin specifications
Identifies and cleans up redundant or empty directories post-migration
Converts legacy flat-file skill structures into standardized directory formats
Detects and maps tool permissions by analyzing tool usage patterns in code

使用场景

Restructuring complex plugins with nested command and skill dependencies
Upgrading older Claude Code plugins to meet current marketplace standards
Batch-processing undocumented skills to add required metadata and frontmatter

关于

主要功能

0 GitHub stars
Automatically extracts and populates missing YAML frontmatter from existing content
Restructures plugin root folders to comply with .claude-plugin specifications
Identifies and cleans up redundant or empty directories post-migration
Converts legacy flat-file skill structures into standardized directory formats
Detects and maps tool permissions by analyzing tool usage patterns in code

使用场景

Restructuring complex plugins with nested command and skill dependencies
Upgrading older Claude Code plugins to meet current marketplace standards
Batch-processing undocumented skills to add required metadata and frontmatter