drupal-migration

Migrate Drupal data between versions and sources with YAML and Drush.

45|9|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/madsnorgaard/agent-resources --skill drupal-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drupal-migration
Source: https://github.com/madsnorgaard/agent-resources/tree/main/.claude/skills/drupal-migration
Command: npx skills add https://github.com/madsnorgaard/agent-resources --skill drupal-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides practical guidance to migrate Drupal data between major versions (D7 to D10/11) and integrate CSV or JSON API data sources, reducing manual migration toil.

Core Features & Use Cases

  • Guided setup for Drupal's Migrate API and core/contrib modules (migrate, migrate_plus, migrate_tools).
  • Concrete migration examples: D7 to D10/11, CSV imports, JSON API based migrations, and custom migrations.
  • Use Case: Update a legacy Drupal 7 site to Drupal 10 by mapping fields, configuring sources, and applying transformations with a maintenance window.

Quick Start

Install and enable the required Drupal migration modules (migrate, migrate_plus, migrate_tools) and begin with a migration YAML file (e.g., migrate_plus.migration.my_example.yml). Then run drush migrate:status, followed by drush migrate:import <migration_id>.

Frequently Asked Questions about drupal-migration

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

FAQPage Schema
How do I migrate content from Drupal 7 to Drupal 10?

To migrate content from Drupal 7 to Drupal 10, you use the Drupal Migrate API to map fields from the legacy source to the new destination, configuring source, process, and destination setup in migration YAML files.

What modules do I need to run a Drupal migration with Drush?

You need the core Migrate module along with the contributed migrate_plus and migrate_tools modules to run Drupal migrations. After enabling them, use Drush commands like migrate:status and migrate:import to execute the process.

Can I import data from a CSV file into Drupal using the Migrate API?

Yes, you can import CSV data into Drupal using the Migrate API. You define the CSV file as the source in your migration YAML configuration, map the columns to destination fields, and run the import via Drush.

Does the Drupal Migrate API support importing data from a JSON API?

The Drupal Migrate API supports importing data from a JSON API. You configure the JSON API endpoint as the source within your migration YAML file, allowing you to pull and map external data into Drupal entities.

What is the structure of a Drupal migration YAML file?

A Drupal migration YAML file defines the source data, process mapping for fields, and destination entity type. It forms the core configuration needed to execute data transfers using the Migrate API and Drush.