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
• Gemini CLI

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:

Pulumi Skills

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

Package Maintenance Skills

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

Delegation Skills

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

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 codex, open the plugin marketplace with /plugins, and pick pulumi-migration, pulumi, pulumi-delegation, or pulumi-package-maintenance. As in Claude Code, pulumi is the combined plugin with all end-user skills; do not combine it with pulumi-migration or pulumi-delegation.

Gemini CLI

Install the latest published Pulumi extension:

gemini extensions install https://github.com/pulumi/agent-skills

The extension includes the Pulumi, migration, and Neo handoff skills. To update it:

gemini extensions update pulumi

Universal (all agents)

Install all end-user skills by installing each plugin group:

npx skills add pulumi/agent-skills/pulumi --skill '*'       # 9 Pulumi skills
npx skills add pulumi/agent-skills/migration --skill '*'    # 5 migration skills
npx skills add pulumi/agent-skills/delegation --skill '*'   # 1 Neo handoff skill

The universal skills CLI discovers these group paths separately. It does not
read the combined plugin manifest at the repository root.

Provider authors can also install the separate package-maintenance group:

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

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

Usage Examples

General Pulumi Infrastructure

Ask your AI assistant:

Use pulumi do to create an S3 bucket and a Cloudflare DNS record

The assistant will use the pulumi-overview skill and route to specialized skills when needed.

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

• Pulumi Documentation
• Agent Skills Specification
• Pulumi ESC Documentation

{
  "name": "pulumi-agent-skills",
  "owner": {
    "name": "Pulumi"
  },
  "metadata": {
    "description": "Official Pulumi agent skills for infrastructure as code workflows",
    "version": "1.0.0"
  },
  "plugins": [
    {
      "name": "pulumi-migration",
      "source": "./migration",
      "description": "Convert and import infrastructure from Terraform, CDK, ARM, and CloudFormation to Pulumi",
      "category": "integration"
    },
    {
      "name": "pulumi",
      "source": "./",
      "description": "Teach your agent Pulumi: infrastructure as code in TypeScript, Python, Go, C#, Java, YAML, or HCL. Skills for writing and operating cloud infrastructure, migrating from Terraform, CloudFormation, CDK, and ARM, and delegating work to Pulumi Neo, Pulumi's AI platform engineer.",
      "category": "development"
    },
    {
      "name": "pulumi-delegation",
      "source": "./delegation",
      "description": "Hand off in-progress work from coding agents to Pulumi Neo",
      "category": "integration"
    },
    {
      "name": "pulumi-package-maintenance",
      "source": "./package-maintenance",
      "description": "Maintain Pulumi provider repositories: upgrade-provider runs and upstream Terraform patches",
      "category": "development"
    }
  ]
}