# pulumi-terraform-to-pulumi

Переводит проекты Terraform и OpenTofu в Pulumi: переносит HCL в код на выбранном языке и импортирует состояние в стек.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 959 установок · ★ 78
- Автор: pulumi
- Лицензия: Apache-2.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/pulumi/agent-skills/tree/HEAD/migration/skills/pulumi-terraform-to-pulumi/SKILL.md
- Обновлён: 2026-10-09
- HTML: https://affpapa.org/nevibecode/skills/pulumi-terraform-to-pulumi

## Что делает

Скилл ведёт миграцию по шагам. Сначала вы с агентом фиксируете, где лежат исходники Terraform, куда положить проект Pulumi, на каком языке писать (TypeScript, Python, YAML) и что нужно — только перевести код или ещё и перенести состояние стека. План подтверждается до начала работы.

Дальше агент создаёт пустой проект в нужной папке и стек, а состояние тянет командой `terraform state pull`, если локального `.tfstate` нет — это работает и с удалёнными бэкендами, включая Pulumi Cloud. Черновик состояния готовит плагин `terraform-migrate`, который ставится сам. Из файла `/tmp/required-providers.json` видно, какие провайдеры и версий нужны; их ставят пакетным менеджером языка, а не через `pulumi plugin install`. Потом черновик импортируется в стек, исходники переводятся до пустого диффа в `pulumi_preview`.

Есть жёсткие ограничения. Не запускайте `pulumi convert` — он не сохраняет привязку состояния, для этого и нужен плагин. Проект создаётся внутри склонированного репозитория, а не в `/workspace`. Если `tofu refresh` не авторизован, шаг не пропускают: придётся собрать окружение Pulumi ESC с нужными учётными данными, иначе автоматическая миграция не пойдёт. В финале скилл предлагает привязать ESC к стеку и открыть Pull Request с переведённым кодом.

## Требования
- Работает с: Terraform

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pulumi/agent-skills --skill pulumi-terraform-to-pulumi -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/pulumi-terraform-to-pulumi/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/pulumi-terraform-to-pulumi/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pulumi/agent-skills --skill pulumi-terraform-to-pulumi -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/pulumi-terraform-to-pulumi/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pulumi/agent-skills --skill pulumi-terraform-to-pulumi -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/pulumi-terraform-to-pulumi/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pulumi/agent-skills pulumi-terraform-to-pulumi
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/pulumi-terraform-to-pulumi/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add pulumi/agent-skills --skill pulumi-terraform-to-pulumi -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/pulumi/agent-skills --path migration/skills/pulumi-terraform-to-pulumi
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/pulumi-terraform-to-pulumi/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add pulumi/agent-skills --skill pulumi-terraform-to-pulumi -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/pulumi/agent-skills/tree/HEAD/migration/skills/pulumi-terraform-to-pulumi/SKILL.md

## Когда брать
- перевести HCL-описание инфраструктуры в код Pulumi
- перенести состояние Terraform в стек Pulumi без ручного переписывания
- подобрать провайдеры Pulumi и их версии под существующий проект
- свести диффы к нулю после миграции через `pulumi_preview`
- открыть Pull Request с переведёнными исходниками

## Примеры запросов агенту
- Перенеси проект Terraform из `./infra` в Pulumi на TypeScript, состояние тоже импортируй
- Сконвертируй OpenTofu в Pulumi на Python, исходники лежат в `./tf`
- Переведи HCL в Pulumi и покажи, какие провайдеры понадобятся

## Похожие
- [terraform-skill](https://affpapa.org/nevibecode/skills/terraform-skill.md) — скилл · 7400 установок
- [terragrunt-generator](https://affpapa.org/nevibecode/skills/terragrunt-generator.md) — скилл · 1200 установок
- [terraform-specialist](https://affpapa.org/nevibecode/agents/terraform-specialist.md) — субагент · 1349 установок
- [huawei-cloud-terraform-installer](https://affpapa.org/nevibecode/skills/huawei-cloud-terraform-installer.md) — скилл · 17400 установок
- [huawei-cloud-terraform-generator](https://affpapa.org/nevibecode/skills/huawei-cloud-terraform-generator.md) — скилл · 17000 установок
- [terraform-stacks](https://affpapa.org/nevibecode/skills/terraform-stacks.md) — скилл · 5600 установок

Из того же набора: [pulumi/agent-skills](https://affpapa.org/nevibecode/by/pulumi/agent-skills.md) — 13 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md