Pulumi Terraform To Pulumi

This handles the full Terraform to Pulumi migration workflow, not just code conversion. It walks you through translating HCL source code and importing existing tfstate into a new Pulumi stack using the terraform-migrate plugin instead of the standard convert command, which matters because it preserves state mapping. The skill enforces a specific sequence: confirm scope with the user, create an empty Pulumi project, pull remote state if needed, generate the state translation, install the exact provider versions it specifies, import the state, then iteratively fix your code until preview shows no diff. It's opinionated about avoiding common mistakes like running commands in the wrong directory or skipping the credential setup step.

skills.sh installs: 974
GitHub stars: 79
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pulumi/agent-skills --skill pulumi-terraform-to-pulumi --agent claude-code

Installs into .claude/skills of the current project.

Files

Migrating from Terraform to Pulumi

Critical constraints — read before acting:

Do NOT run pulumi convert — use the terraform-migrate plugin instead, which preserves state mapping.

Do NOT run pulumi package add terraform-module — this is for a different workflow.

Do NOT create the Pulumi project under /workspace — create it inside the checked-out repo.

Replace ${terraform_dir} and ${pulumi_dir} below with the actual paths confirmed with the user.

First establish scope and plan the migration by working out with the user:

where the Terraform sources are (${terraform_dir})
where the migrated Pulumi project lives (${pulumi_dir})
what is the target Pulumi language (such as TypeScript, Python, YAML)
whether migration aims to setup Pulumi stack states, or only translate source code

Confirm the plan with the user before proceeding.

Create a new Pulumi project in ${pulumi_dir} in the chosen language. Edit sources to be empty and not declare any resources. Ensure a Pulumi stack exists.

You must run pulumi_up tool before proceeding to ensure initial stack state is written.

SKILL.md on GitHub