cloudformation-to-pulumi

Converts AWS CloudFormation templates and stacks into import-ready Pulumi TypeScript programs with mapping tables and migration reports.

19|3|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/dirien/yet-another-agent-harness --skill cloudformation-to-pulumi-dirien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cloudformation-to-pulumi
Source: https://github.com/dirien/yet-another-agent-harness/tree/main/.claude/skills/cloudformation-to-pulumi
Command: npx skills add https://github.com/dirien/yet-another-agent-harness --skill cloudformation-to-pulumi-dirien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting AWS CloudFormation templates and stacks into a maintainable Pulumi program is error-prone and time-consuming, especially when preserving resource identities for imports and handling CloudFormation intrinsics, conditions, and custom resources. This Skill centralizes the workflow: it validates AWS credentials and region, extracts templates and stack inventories when needed, enforces CloudFormation logical IDs as Pulumi resource names, and guides the import process to achieve a zero-diff Pulumi preview. The output is a structured, import-ready Pulumi TypeScript program plus a PR-ready migration report.

Core Features & Use Cases

  • Complete resource coverage: Inventory CloudFormation resources and ensure each is represented or explicitly justified in the final report.
  • Naming and import strategy: Enforce CloudFormation Logical IDs as Pulumi resource names and prefer the aws-native provider to enable automated import with cdk-importer.
  • Manual, safe conversion: Map CloudFormation intrinsics, parameters, mappings, and conditions to Pulumi equivalents and handle custom resources with documented remediation.
  • Import tooling and validation: Use cdk-importer and cdk2pulumi helpers, run pulumi preview to verify zero-diff imports, and provide manual import guidance for failures.
  • Deliverables: Pulumi TypeScript files organized by file, a resource mapping table, custom resource summaries, an import plan, and a PR-ready migration report.

Quick Start

Use the cloudformation-to-pulumi skill to migrate the CloudFormation stack 'MyStack' in us-east-1 into a Pulumi TypeScript program and produce an import-ready migration plan.

Frequently Asked Questions about cloudformation-to-pulumi

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

FAQPage Schema
How do I migrate AWS CloudFormation templates to Pulumi?

Migrate CloudFormation templates to Pulumi by converting resources into TypeScript programs using aws-native and cdk-importer. The process enforces CloudFormation Logical IDs as Pulumi resource names, maps intrinsics and conditions, and validates imports to achieve a zero-diff preview.

What is the best way to import CloudFormation stacks into Pulumi without losing resources?

Importing CloudFormation stacks into Pulumi requires inventorying all stack resources and enforcing CloudFormation Logical IDs as Pulumi resource names. Using the aws-native provider with cdk-importer enables automated import, ensuring each resource is represented or explicitly justified in the migration report.

Does the CloudFormation to Pulumi conversion handle intrinsics, parameters, and custom resources?

CloudFormation to Pulumi conversion maps intrinsics, parameters, mappings, and conditions to Pulumi equivalents. Custom resources receive documented remediation guidance, while standard resources are converted using the aws-native provider for automated import preparation.

What deliverables do I get from converting a CloudFormation stack to a Pulumi program?

Converting a CloudFormation stack to Pulumi produces TypeScript files organized by resource, a resource mapping table, custom resource summaries, an import plan, and a PR-ready migration report detailing the complete resource coverage and conversion strategy.

How do I verify a zero-diff Pulumi preview after migrating from CloudFormation?

Verify a zero-diff Pulumi preview by running pulumi preview after using cdk-importer to import resources. If automated import fails, manual import guidance is provided to resolve mismatches and ensure the Pulumi state matches the existing AWS infrastructure.

Do I need AWS credentials and region confirmation to convert CloudFormation to Pulumi?

AWS credentials and region confirmation are required to convert CloudFormation to Pulumi. The workflow validates ESC credentials and the specific AWS region to extract stack templates and inventories accurately before generating the Pulumi TypeScript program.