drupal-migration — Claude Code skill for Drupal migrations
drupal-migration — a skill for Drupal 7 to Drupal 10 migrations, CSV and JSON API imports. Generates migration configs, writes source plugins and process mappings.
no license 142 installs ★ 53 updated 2026-09-17
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a claude-codeWhat drupal-migration does
The skill handles Migrate API tasks: sets up Drupal 7 database connections in settings.php, generates migration YAML via drush migrate:upgrade, and overrides default migrations for fields, files, and taxonomy. For CSV it specifies plugin: csv with file path and IDs; for JSON API it uses plugin: url with data selectors. In the process section it maps fields, applies transformations like static_map and concat, and resolves entity references with migration_lookup or entity_generate.
Requires migrate_plus, migrate_tools, and migrate_file modules — the skill provides install commands via composer require and drush en. The Drupal 7 connection in $databases['migrate'] must be configured before content migration runs.
Covers custom data sources, multi-value fields with sub_process, conditional row processing (skip_on_empty, skip_on_value), and rollbacks via drush migrate:rollback.
What it helps with
- migrate nodes, users, and files from Drupal 7 to Drupal 10
- import products from CSV with taxonomy term lookup
- load data from JSON API and create nodes
- write a custom source plugin for migration
- override default field and text format migrations
Example prompts for the agent
- Set up migration for article nodes from Drupal 7, image field should reference migrated files
- Write YAML to import products from
products.csv, category is a term name lookup - Create a migration from JSON API at
https://api.example.com/users, name field comes fromattributes/name
How to install drupal-migration
1Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a claude-code2Manually: put the files in place
~/.claude/skills/drupal-migration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/drupal-migration/
1Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a codex2Manually: put the files in place
.agents/skills/drupal-migration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a cursor2Manually: put the files in place
.cursor/skills/drupal-migration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install madsnorgaard/drupal-agent-resources .claude/skills/drupal-migration2Manually: put the files in place
.github/skills/drupal-migration/SKILL.md1Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a gemini-cli2Platform CLI
gemini skills install https://github.com/madsnorgaard/drupal-agent-resources --path .claude/skills/drupal-migrationManually: put the files in place
.devin/skills/drupal-migration/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about drupal-migration
How to install drupal-migration in Claude Code?
Run npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a claude-code, then open ~/.claude/skills/drupal-migration/SKILL.md.
What does drupal-migration do?
Assists with Drupal migrations: generates YAML configs for Drupal 7 upgrades, CSV and JSON API imports, writes source plugins and field process mappings.
Which modules does drupal-migration require?
Needs migrate_plus, migrate_tools, and migrate_file. The skill provides Composer and Drush commands to install them.