skills.rest
astoeffer
astoefferCOMMUNITY
Explore all skills by this author →
GitHub

migration-guide

Migrate CLAUDE plugin repositories to the Claude Code format.

Updated Aug 23, 2026
Search Tags:#migration#plugin#structure#conversion#frontmatter
One-click install
npx skills add https://github.com/astoeffer/plugin-marketplace --skill migration-guide
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migration-guide
Source: https://github.com/astoeffer/plugin-marketplace/tree/main/plugins/plugin-builder/skills/migration-guide
Command: npx skills add https://github.com/astoeffer/plugin-marketplace --skill migration-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes patterns (resource) components.

What problem does it solve?

Provides procedures for migrating plugins to the correct Claude Code format, including frontmatter injection and directory restructuring.

Core Features & Use Cases

  • Flat to Directory Migration: Convert flat skills into structured directories.
  • Frontmatter Injection: Add required frontmatter to skills and agents.
  • Root Relocation: Move directories to plugin root and cleanup.

Quick Start

Follow migration steps to convert existing skills, update manifests, and validate plugin structure.

Frequently Asked Questions about migration-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert flat plugin skill files into a structured directory format?▼

Flat-to-directory migration reorganizes individual skill files into per-skill directories under your plugin root. The process moves each skill into its own folder, applies required frontmatter, and validates the new structure to ensure compliance with Claude Code format standards.

What frontmatter do I need to add when migrating plugins to Claude Code format?▼

Migration injects required frontmatter metadata into skills and agents during the conversion process. This includes essential fields that Claude Code expects; the Skill validates and applies frontmatter automatically as part of the structured directory setup.

Can I safely migrate my plugin without losing data or breaking existing skills?▼

Yes. The migration process creates safe backups before restructuring. It handles directory relocation, removes empty directories post-migration, and includes post-migration verification steps to confirm all skills remain functional and properly formatted.

When should I migrate my plugin to the Claude Code directory structure?▼

Migrate when your plugin uses flat skill files or lacks proper Claude Code formatting. Migration is necessary to meet functional and technical requirements, ensure compatibility with Claude Code standards, and enable proper skill organization and discovery.

How do I verify my plugin structure is correct after migration?▼

Post-migration verification checks that all skills are in per-skill directories, frontmatter is properly injected, and the plugin root structure matches Claude Code format. The migration process includes validation steps to confirm successful conversion and identify any issues.

Related Skills

Explore More Software Engineering Skills→
dimagi-internaldimagi-internal
1

detect-structure-drift

Detect structural drift across agent frontmatter, artifact manifest, and orchestrator reference documentation.

Official
Advanced
vinnie357vinnie357
24

claude-plugins

Create and validate Claude Code plugin.json manifests for schema compliance.

Community
Intermediate
MomoChenisMeMomoChenisMe
1

plugin-creator

Generate Claude Code plugin scaffolds, manifests, and starter components.

Community
Intermediate
psd401psd401
2

compound-plugin-analyzer

Compare two plugin ecosystems and generate prioritized improvement suggestions.

Official
Advanced