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:

• Claude Code
• GitHub Copilot
• Cursor
• VS Code
• OpenAI Codex

Repository Structure

Skills are organized into four plugin groups:

pulumi-agent-skills/
├── migration/             # Convert and import from other tools
├── pulumi/                # Entry-point and specialized Pulumi skills
├── package-maintenance/   # Maintain Pulumi provider repositories
└── 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
pulumi-migrate-from-discovered-stack	Migrate a CloudFormation or ARM stack that Pulumi Cloud's Discovery feature has already found, using the discovered-stacks API

Pulumi Skills

Entry-point and specialized skills for writing and operating Pulumi infrastructure:

Skill	Description
pulumi-overview	Entry-point across pulumi do, IaC projects, and Pulumi Cloud; routes to specialized skills
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)
pulumi-debug-failed-operation	Debug a failed pulumi up or pulumi preview from the failure Pulumi already recorded
provider-upgrade	Safe workflows for upgrading Pulumi providers without unintended infrastructure changes
package-usage	Track which stacks across an organization use a package and at what versions
pulumi-context-api	Query the Pulumi Context API graph for relationship and impact-analysis questions across an organization's infrastructure

Package Maintenance Skills

Maintain Pulumi provider repositories (provider authors and bridge maintainers):

Skill	Description
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                        # All end-user skills: authoring, migration, and Neo handoff

The pulumi plugin bundles the authoring, migration, and delegation skill groups in one install. Prefer a subset? Install pulumi-migration or pulumi-delegation instead (not alongside pulumi, which already includes both). pulumi-package-maintenance is separate: it targets provider authors and combines fine with any of the others.

/plugin install pulumi-migration              # Migration skills only
/plugin install pulumi-delegation             # Neo handoff skill only
/plugin install pulumi-package-maintenance    # Provider-repo maintenance skills (for provider authors)

Declarative install via settings.json

To register the marketplace and enable plugins automatically (for a team or CI), add this to .claude/settings.json. The marketplace key must be pulumi-agent-skills: it has to match the name field in this repo's .claude-plugin/marketplace.json, and the same name is used as the @<marketplace> suffix in enabledPlugins:

{
  "extraKnownMarketplaces": {
    "pulumi-agent-skills": {
      "source": { "source": "github", "repo": "pulumi/agent-skills" }
    }
  },
  "enabledPlugins": {
    "pulumi@pulumi-agent-skills": true
  }
}

The pulumi plugin covers authoring, migration, and delegation. Swap in pulumi-migration or pulumi-delegation for a subset, or add pulumi-package-maintenance for provider-repo maintenance.

If you name the marketplace anything else (e.g. pulumi-skills), the plugins fail to resolve with Plugin '…' not found in marketplace '…'.

OpenAI Codex

codex plugin marketplace add pulumi/agent-skills

Once the marketplace is registered, install plugins from the Codex TUI: run `code