
pulumi / agent-skills
✓ Official★ 61A skill package that teaches your agent 12 capabilities — every one documented and browsable below, no GitHub required · by pulumi.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Convert, migrate, or import AWS CloudFormation stacks or templates into Pulumi programs. Load this skill whenever a user wants to move from CloudFormation to…
6 files — installable on its own
Track which stacks across a Pulumi organization use a specific package and at what versions. Use for cross-stack audits, identifying outdated or unmaintained…
4 files — installable on its own
A provider upgrade is a translation, not a change request.
6 files — installable on its own
Convert ARM templates, Bicep, or existing Azure resources to Pulumi infrastructure code. Handles complete ARM template conversion to Pulumi (TypeScript, Python, Go, C#, Java, or YAML) with support for parameters, variables, loops, conditionals, and nested templates Supports both azure-native (full API coverage) and azure (classic, simplified) providers; automatically selects the right provider for each resource Imports existing deployed Azure resources into Pulumi with zero-diff validation...
6 files — installable on its own
Programmatic orchestration of Pulumi infrastructure operations across multiple stacks and applications. Supports both local source (existing Pulumi projects) and inline source (embedded programs) architectures, enabling flexible deployment patterns from simple to complex multi-stack scenarios Handles multi-stack orchestration with dependency sequencing, parallel independent deployments, and cross-stack output passing for coordinated infrastructure provisioning Provides programmatic...
4 files — installable on its own
Comprehensive best practices for writing reliable, maintainable Pulumi infrastructure code. Avoid creating resources inside apply() callbacks; pass Output objects directly as inputs to preserve dependency tracking and preview visibility Use ComponentResource classes to group related resources into reusable logical units with proper parent-child hierarchy via parent: this Encrypt secrets from the start with --secret flag or config.requireSecret() to prevent credential leakage in state files...
4 files — installable on its own
Load this skill when a user wants to migrate, convert, port, translate, or move an AWS CDK application (including CDK stacks, constructs, or…
7 files — installable on its own
Reusable infrastructure components with multi-language support, sensible defaults, and composition patterns. Requires four core elements: extend ComponentResource , accept standard parameters, set parent: this on all children, and call registerOutputs() at the end of the constructor Args interfaces must use Input<T> wrappers, avoid union types and functions, and keep structures flat to support multi-language SDK generation Expose only essential outputs as public properties; hide...
4 files — installable on its own
Centralized secrets, configuration, and dynamic credentials management for Pulumi infrastructure and applications. Supports environment composition through imports and layering, with reserved keys for environmentVariables , pulumiConfig , and files Generates short-term credentials via OIDC for AWS, Azure, and GCP; integrates with AWS Secrets Manager, Azure Key Vault, HashiCorp Vault, and 1Password Core CLI commands include pulumi env init , pulumi env edit , pulumi env open (reveals...
4 files — installable on its own
Migrate Terraform/OpenTofu projects to Pulumi, including translating HCL source code and/or importing Terraform state into a Pulumi stack. Use when a user…
4 files — installable on its own
Automate Pulumi provider repo upgrades with the `upgrade-provider` tool. Use when upgrading a pulumi provider repository to a new upstream version, running…
6 files — installable on its own
Create, amend, remove, and rebase patches for Terraform provider submodules using `./scripts/upstream.sh`. Use when `upgrade-provider` or manual patch work…
3 files — installable on its own
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 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 NeoAvailable 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 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) |
| 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 |
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-migration # Install migration skills
/plugin install pulumi # Install Pulumi skills (overview + specialized)
/plugin install pulumi-delegation # Install delegation skills (Neo handoff)
/plugin install pulumi-package-maintenance # Install provider-repo maintenance skillsDeclarative 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-migration@pulumi-agent-skills": true,
"pulumi@pulumi-agent-skills": true,
"pulumi-delegation@pulumi-agent-skills": true,
"pulumi-package-maintenance@pulumi-agent-skills": true
}
}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-skillsOnce 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.
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/pulumi --skill '*' # 7 pulumi skills (overview + specialized)
npx skills add pulumi/agent-skills/delegation --skill '*' # 1 delegation skill
npx skills add pulumi/agent-skills/package-maintenance --skill '*' # 2 package-maintenance skillsThis 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 recordThe 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 PulumiThe 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 ESCThe 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 serviceThe 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 infrastructureThe 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 productionThe 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
Install the whole package (12 skills):
npx skills add https://github.com/pulumi/agent-skillsOr install a single skill:
npx skills add https://github.com/pulumi/agent-skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.