Agent Skills

provider-upgrade

Installation
CLI
npx skills add https://github.com/pulumi/agent-skills --skill provider-upgrade

Install this skill with the CLI and start using the SKILL.md workflow in your workspace.

Last updated 6/15/2026

Pulumi Agent Skills

A collection of Agent Skills for infrastructure as code workflows with Pulumi. These skills teach AI coding assistants how to help with infrastructure migrations, secret management, and code translation.

What are Agent Skills?

Agent Skills are reusable knowledge packages that teach AI coding assistants domain-specific workflows. They follow the agentskills.io open standard and work with:

Repository Structure

Skills are organized into two plugin groups:

pulumi-agent-skills/
├── migration/          # Convert and import from other tools
├── authoring/          # Write quality Pulumi programs
└── delegation/         # Hand off work to Pulumi Neo

Available Skills

Migration Skills

Convert and import infrastructure from other tools to Pulumi:

Skill Description
pulumi-terraform-to-pulumi Migrate Terraform projects to Pulumi
pulumi-cdk-to-pulumi Migrate AWS CDK applications to Pulumi
cloudformation-to-pulumi Migrate AWS CloudFormation stacks/templates to Pulumi
pulumi-arm-to-pulumi Migrate Azure ARM templates and Bicep to Pulumi

Authoring Skills

Write quality Pulumi programs, components, automation, and secrets management:

Skill Description
pulumi-best-practices Best practices for writing reliable Pulumi programs
pulumi-component Guide for authoring ComponentResource classes
pulumi-automation-api Best practices for using Pulumi Automation API
pulumi-esc Guidance for working with Pulumi ESC (Environments, Secrets, and Configuration)
provider-upgrade Safe workflows for upgrading Pulumi providers without unintended infrastructure changes
pulumi-upgrade-provider Automate Pulumi provider repo upgrades
upstream-patches Manage upstream Terraform patch stacks in provider repos

Delegation Skills

Hand off in-progress work from coding agents to Pulumi Neo:

Skill Description
pulumi-neo-handoff Transfer the current work to a Pulumi Neo task with goal, repository pointers, and a compacted conversation summary

Installation

Claude Code Plugin System

/plugin marketplace add pulumi/agent-skills
/plugin install pulumi-migration     # Install migration skills
/plugin install pulumi-authoring     # Install authoring skills
/plugin install pulumi-delegation    # Install delegation skills (Neo handoff)

OpenAI Codex

codex plugin marketplace add pulumi/agent-skills

Once the marketplace is registered, install plugins from the Codex TUI: run codex, open the plugin marketplace, and pick pulumi-migration, pulumi-authoring, or pulumi-delegation.

Universal (all agents)

Install all skills:

npx skills add pulumi/agent-skills --skill '*'

Or install individual plugin groups:

npx skills add pulumi/agent-skills/migration --skill '*'     # 4 migration skills
npx skills add pulumi/agent-skills/authoring --skill '*'     # 7 authoring skills
npx skills add pulumi/agent-skills/delegation --skill '*'    # 1 delegation skill

This works with Claude Code, Cursor, Copilot, Codex, and other agent tools.

Usage Examples

Terraform to Pulumi Migration

Ask your AI assistant:

"Convert this Terraform configuration to Pulumi TypeScript"

The assistant will use the pulumi-terraform-to-pulumi skill to produce idiomatic Pulumi code.

CDK to Pulumi Migration

Ask your AI assistant:

Help me migrate my CDK application to Pulumi

The assistant will use the pulumi-cdk-to-pulumi skill to guide you through the complete migration workflow.

Managing Secrets with ESC

Ask your AI assistant:

Set up AWS OIDC credentials using Pulumi ESC

The assistant will use the pulumi-esc skill to help configure dynamic credentials.

Writing Components

Ask your AI assistant:

Help me create a reusable Pulumi component for a web service

The assistant will use the pulumi-component skill to guide you through component authoring best practices.

Upgrading Providers

Ask your AI assistant:

Help me upgrade the Pulumi AWS provider safely without changing real infrastructure

The assistant will use the provider-upgrade skill to guide you through a low-risk upgrade workflow.

Handing Off Work to Pulumi Neo

Ask your AI assistant:

Hand this off to Neo to apply the staging migration in production

The assistant will use the pulumi-neo-handoff skill to package the goal, repository state, and conversation summary into a new Pulumi Neo task and return a task URL.

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines on:

  • Writing new skills
  • Improving existing skills
  • Reporting issues

Also see AGENTS.md for agent-specific documentation on skill conventions, cross-skill references, and plugin structure.

License

Apache 2.0 - See LICENSE for details.

Resources