# drupal-migration

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 142 installs · ★ 53 repo stars
- Author: madsnorgaard
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/madsnorgaard/drupal-agent-resources/tree/HEAD/.claude/skills/drupal-migration/SKILL.md
- Updated: 2026-09-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/drupal-migration

## What it 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`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/drupal-migration/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/drupal-migration/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/drupal-migration/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/drupal-migration/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install madsnorgaard/drupal-agent-resources .claude/skills/drupal-migration
```

2. **Manually: put the files in place**
- File: `.github/skills/drupal-migration/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/madsnorgaard/drupal-agent-resources --path .claude/skills/drupal-migration
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/drupal-migration/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add madsnorgaard/drupal-agent-resources --skill drupal-migration -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/madsnorgaard/drupal-agent-resources/tree/HEAD/.claude/skills/drupal-migration/SKILL.md

## When to use it
- 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
- 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 from `attributes/name`

## Similar
- [Drupal Expert](https://affpapa.org/en/nevibecode/agents/drupal-expert.md) — subagent · ★ 41430 repo stars
- [drupal-development](https://affpapa.org/en/nevibecode/skills/drupal-development.md) — skill · 964 installs
- [migration](https://affpapa.org/en/nevibecode/skills/migration.md) — skill · 127700 installs
- [d1-migration](https://affpapa.org/en/nevibecode/skills/d1-migration.md) — skill · 1200 installs
- [migration-architect](https://affpapa.org/en/nevibecode/skills/migration-architect.md) — skill · 632 installs
- [database-migration-management](https://affpapa.org/en/nevibecode/skills/database-migration-management.md) — skill · 505 installs

From the same set: [madsnorgaard/drupal-agent-resources](https://affpapa.org/en/nevibecode/by/madsnorgaard/drupal-agent-resources.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
