pulumi-terraform-to-pulumi

Migrate Terraform HCL configurations and state files to Pulumi code.

63|5|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/pulumi/agent-skills --skill pulumi-terraform-to-pulumi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pulumi-terraform-to-pulumi
Source: https://github.com/pulumi/agent-skills/tree/main/migration/skills/pulumi-terraform-to-pulumi
Command: npx skills add https://github.com/pulumi/agent-skills --skill pulumi-terraform-to-pulumi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex and time-consuming process of migrating infrastructure code from Terraform to Pulumi, enabling users to leverage Pulumi's features while preserving existing infrastructure definitions.

Core Features & Use Cases

  • Automated Translation: Converts Terraform HCL configurations and state into equivalent Pulumi code and stack state.
  • Provider Management: Identifies and installs necessary Pulumi providers, ensuring compatibility and correct versions.
  • Use Case: A team using Terraform for their AWS infrastructure needs to adopt Pulumi for better IaC management. This skill guides them through converting their existing Terraform projects to a fully functional Pulumi project.

Quick Start

Use the pulumi-terraform-to-pulumi skill to migrate the Terraform project located at /path/to/terraform/sources to a new Pulumi project in /path/to/pulumi/project using TypeScript.

Frequently Asked Questions about pulumi-terraform-to-pulumi

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

FAQPage Schema
How do I migrate Terraform HCL configurations to Pulumi?

Migrating Terraform HCL to Pulumi involves using a migration plugin to generate a draft state translation and iteratively refining the Pulumi source code to match the translated state and Terraform sources.

Can I convert my existing Terraform state file to a Pulumi stack?

Converting a Terraform state file to a Pulumi stack is possible; the migration process translates Terraform state into equivalent Pulumi stack state to ensure infrastructure consistency without recreating resources.

Does migrating from Terraform to Pulumi handle provider installation automatically?

Migrating from Terraform to Pulumi handles provider installation by identifying necessary Pulumi providers and installing them to ensure compatibility and correct versions.

What is the best way to move AWS infrastructure from Terraform to Pulumi code?

The best way to move AWS infrastructure from Terraform to Pulumi is to automate the translation of HCL configurations and state files, generating a functional Pulumi project while preserving existing infrastructure definitions.

How does the Terraform to Pulumi migration process ensure state consistency?

The migration process ensures state consistency by using a plugin to generate a draft state translation from Terraform sources, then iteratively refining the Pulumi source code to match the translated state.