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:
| 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 plugin
Write Pulumi programs, work with secrets, and diagnose failed operations:
| Skill | Description |
|---|---|
| pulumi-overview | Choose a Pulumi workflow and load the skills needed to complete it |
| pulumi-best-practices | Best practices for writing reliable Pulumi programs |
| pulumi-component | Write reusable infrastructure components with ComponentResource |
| 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 | Diagnose a failed pulumi up or pulumi preview using its recorded errors |
| package-usage | Audit which stacks across an organization use a package and at what versions |
| provider-upgrade | Upgrade a Pulumi provider and review the resulting infrastructure changes |
Package maintenance plugin
These skills help provider authors and bridge maintainers update Pulumi provider repositories:
| Skill | Description |
|---|---|
| pulumi-upgrade-provider | Automate Pulumi provider repo upgrades with the upgrade-provider tool |
| upstream-patches | Manage upstream Terraform patch stacks in provider repos |
Delegation plugin
Delegate work from your coding agent to Neo in Pulumi Cloud:
| Skill | Description |
|---|---|
| pulumi-neo-handoff | Transfer 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.