Skip to main content
Pulumi logo Pulumi logo
  1. Docs
  2. Infrastructure AI
  3. Use your coding agent
  4. Agent Skills

Pulumi Agent Skills

    Install Pulumi skills to give your coding agent instructions for writing Pulumi programs, migrating infrastructure, and configuring Pulumi ESC. The agent loads the relevant instructions when you ask it to work on your repository. Pulumi skills follow the Agent Skills standard.

    Installation

    Claude Code

    In Claude Code, add the marketplace and install the Pulumi plugin:

    /plugin marketplace add pulumi/agent-skills
    /plugin install pulumi                        # Authoring, migration, and handoff skills
    

    If you only need migration or delegation, install the corresponding plugin instead of pulumi:

    /plugin install pulumi-migration              # Migration skills only
    /plugin install pulumi-delegation             # Handoff skill only
    

    Provider authors can also install pulumi-package-maintenance alongside any of these plugins:

    /plugin install pulumi-package-maintenance
    

    OpenAI Codex

    Register the marketplace, then install plugins from the Codex TUI:

    codex plugin marketplace add pulumi/agent-skills
    

    Run codex, open the plugin marketplace, and select pulumi for authoring, migration, and delegation skills. If you only need migration or delegation, select pulumi-migration or pulumi-delegation instead. Provider authors can also install pulumi-package-maintenance.

    Gemini CLI

    Install the latest published Pulumi extension, which includes authoring, migration, and delegation skills:

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

    To update the extension:

    gemini extensions update pulumi
    

    Other coding agents

    Use the skills installer to add the groups you need:

    npx skills add pulumi/agent-skills/pulumi --skill '*'       # Pulumi skills
    npx skills add pulumi/agent-skills/migration --skill '*'    # Migration skills
    npx skills add pulumi/agent-skills/delegation --skill '*'   # Handoff skill
    

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

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

    The installer supports Claude Code, Cursor, GitHub Copilot, Codex, Junie, and other coding agents. To install a group for a specific agent, use the --agent flag:

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

    Use an installed skill

    After installation, check that your coding agent lists the Pulumi skills in its available skills or plugin details. If they do not appear, follow your agent’s instructions for enabling the plugin or reloading the session.

    For example, open a Terraform project and ask:

    Use the pulumi-terraform-to-pulumi skill to review this Terraform project
    and propose a migration to Pulumi TypeScript. Identify the resources,
    state, and dependencies to preserve before making changes.
    

    Check the agent’s activity for the skill it loaded. How it displays the loaded skill depends on the coding agent.

    Available skills

    Skills are organized into four plugin groups: Migration, Pulumi, Package Maintenance, and Delegation.

    Migration plugin

    Convert and import infrastructure from other tools to Pulumi:

    SkillDescription
    pulumi-terraform-to-pulumiMigrate Terraform projects to Pulumi
    pulumi-cdk-to-pulumiMigrate AWS CDK applications to Pulumi
    cloudformation-to-pulumiMigrate AWS CloudFormation stacks/templates to Pulumi
    pulumi-arm-to-pulumiMigrate Azure ARM templates and Bicep to Pulumi
    pulumi-migrate-from-discovered-stackMigrate a CloudFormation or ARM stack that Pulumi Cloud’s Discovery feature has already found, using the discovered-stacks API

    Pulumi plugin

    Write Pulumi programs, work with secrets, and diagnose failed operations:

    SkillDescription
    pulumi-overviewChoose a Pulumi workflow and load the skills needed to complete it
    pulumi-best-practicesBest practices for writing reliable Pulumi programs
    pulumi-componentWrite reusable infrastructure components with ComponentResource
    pulumi-automation-apiBest practices for using Pulumi Automation API
    pulumi-escGuidance for working with Pulumi ESC (Environments, Secrets, and Configuration)
    pulumi-debug-failed-operationDiagnose a failed pulumi up or pulumi preview using its recorded errors
    package-usageAudit which stacks across an organization use a package and at what versions
    provider-upgradeUpgrade a Pulumi provider and review the resulting infrastructure changes

    Package maintenance plugin

    These skills help provider authors and bridge maintainers update Pulumi provider repositories:

    SkillDescription
    pulumi-upgrade-providerAutomate Pulumi provider repo upgrades with the upgrade-provider tool
    upstream-patchesManage upstream Terraform patch stacks in provider repos

    Delegation plugin

    Delegate work from your coding agent to Neo in Pulumi Cloud:

    SkillDescription
    pulumi-neo-handoffTransfer the current work to a Neo task with its goal, repository details, and conversation summary

    Contributing

    To report a problem, improve a workflow, or add a skill, see the agent-skills contribution guide.

      The infrastructure platform for humans and agents.