{
  "markdown": "# Pulumi Agent Skills\n\nA collection of [Agent Skills](https://agentskills.io) for infrastructure as code workflows with Pulumi. These skills teach AI coding assistants how to help with infrastructure migrations, secret management, and code translation.\n\n## What are Agent Skills?\n\nAgent Skills are reusable knowledge packages that teach AI coding assistants domain-specific workflows. They follow the [agentskills.io](https://agentskills.io) open standard and work with:\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)\n- [GitHub Copilot](https://docs.github.com/en/copilot)\n- [Cursor](https://cursor.sh)\n- [VS Code](https://code.visualstudio.com/docs/copilot)\n- [OpenAI Codex](https://openai.com/api/)\n\n## Repository Structure\n\nSkills are organized into four plugin groups:\n\n```\npulumi-agent-skills/\n├── migration/             # Convert and import from other tools\n├── pulumi/                # Entry-point and specialized Pulumi skills\n├── package-maintenance/   # Maintain Pulumi provider repositories\n└── delegation/            # Hand off work to Pulumi Neo\n```\n\n## Available Skills\n\n### Migration Skills\n\nConvert and import infrastructure from other tools to Pulumi:\n\n| Skill | Description |\n|-------|-------------|\n| [pulumi-terraform-to-pulumi](migration/skills/pulumi-terraform-to-pulumi) | Migrate Terraform projects to Pulumi |\n| [pulumi-cdk-to-pulumi](migration/skills/pulumi-cdk-to-pulumi) | Migrate AWS CDK applications to Pulumi |\n| [cloudformation-to-pulumi](migration/skills/cloudformation-to-pulumi) | Migrate AWS CloudFormation stacks/templates to Pulumi |\n| [pulumi-arm-to-pulumi](migration/skills/pulumi-arm-to-pulumi) | Migrate Azure ARM templates and Bicep to Pulumi |\n| [pulumi-migrate-from-discovered-stack](migration/skills/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 |\n\n### Pulumi Skills\n\nEntry-point and specialized skills for writing and operating Pulumi infrastructure:\n\n| Skill | Description |\n|-------|-------------|\n| [pulumi-overview](pulumi/skills/pulumi-overview) | Entry-point across `pulumi do`, IaC projects, and Pulumi Cloud; routes to specialized skills |\n| [pulumi-best-practices](pulumi/skills/pulumi-best-practices) | Best practices for writing reliable Pulumi programs |\n| [pulumi-component](pulumi/skills/pulumi-component) | Guide for authoring ComponentResource classes |\n| [pulumi-automation-api](pulumi/skills/pulumi-automation-api) | Best practices for using Pulumi Automation API |\n| [pulumi-esc](pulumi/skills/pulumi-esc) | Guidance for working with Pulumi ESC (Environments, Secrets, and Configuration) |\n| [pulumi-debug-failed-operation](pulumi/skills/pulumi-debug-failed-operation) | Debug a failed `pulumi up` or `pulumi preview` from the failure Pulumi already recorded |\n| [provider-upgrade](pulumi/skills/provider-upgrade) | Safe workflows for upgrading Pulumi providers without unintended infrastructure changes |\n| [package-usage](pulumi/skills/package-usage) | Track which stacks across an organization use a package and at what versions |\n| [pulumi-context-api](pulumi/skills/pulumi-context-api) | Query the Pulumi Context API graph for relationship and impact-analysis questions across an organization's infrastructure |\n\n### Package Maintenance Skills\n\nMaintain Pulumi provider repositories (provider authors and bridge maintainers):\n\n| Skill | Description |\n|-------|-------------|\n| [pulumi-upgrade-provider](package-maintenance/skills/pulumi-upgrade-provider) | Automate Pulumi provider repo upgrades |\n| [upstream-patches](package-maintenance/skills/upstream-patches) | Manage upstream Terraform patch stacks in provider repos |\n\n### Delegation Skills\n\nHand off in-progress work from coding agents to Pulumi Neo:\n\n| Skill | Description |\n|-------|-------------|\n| [pulumi-neo-handoff](delegation/skills/pulumi-neo-handoff) | Transfer the current work to a Pulumi Neo task with goal, repository pointers, and a compacted conversation summary |\n\n## Installation\n\n### Claude Code Plugin System\n\n```bash\n/plugin marketplace add pulumi/agent-skills\n/plugin install pulumi                        # All end-user skills: authoring, migration, and Neo handoff\n```\n\nThe `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.\n\n```bash\n/plugin install pulumi-migration              # Migration skills only\n/plugin install pulumi-delegation             # Neo handoff skill only\n/plugin install pulumi-package-maintenance    # Provider-repo maintenance skills (for provider authors)\n```\n\n#### Declarative install via `settings.json`\n\nTo 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`](.claude-plugin/marketplace.json), and the same name is used as the `@<marketplace>` suffix in `enabledPlugins`:\n\n```json\n{\n  \"extraKnownMarketplaces\": {\n    \"pulumi-agent-skills\": {\n      \"source\": { \"source\": \"github\", \"repo\": \"pulumi/agent-skills\" }\n    }\n  },\n  \"enabledPlugins\": {\n    \"pulumi@pulumi-agent-skills\": true\n  }\n}\n```\n\nThe `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.\n\nIf you name the marketplace anything else (e.g. `pulumi-skills`), the plugins fail to resolve with `Plugin '…' not found in marketplace '…'`.\n\n### OpenAI Codex\n\n```bash\ncodex plugin marketplace add pulumi/agent-skills\n```\n\nOnce 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`.\n\n### Universal (all agents)\n\nInstall all end-user skills by installing each plugin group:\n\n```bash\nnpx skills add pulumi/agent-skills/pulumi --skill '*'       # 8 Pulumi skills\nnpx skills add pulumi/agent-skills/migration --skill '*'    # 5 migration skills\nnpx skills add pulumi/agent-skills/delegation --skill '*'   # 1 Neo handoff skill\n```\n\nThe universal `skills` CLI discovers these group paths separately. It does not\nread the combined plugin manifest at the repository root.\n\nProvider authors can also install the separate package-maintenance group:\n\n```bash\nnpx skills add pulumi/agent-skills/package-maintenance --skill '*'\n```\n\nThis works with Claude Code, Cursor, Copilot, Codex, and other agent tools.\n\n## Usage Examples\n\n### General Pulumi Infrastructure\n\nAsk your AI assistant:\n\n```text\nUse pulumi do to create an S3 bucket and a Cloudflare DNS record\n```\n\nThe assistant will use the `pulumi-overview` skill and route to specialized skills when needed.\n\n### Terraform to Pulumi Migration\n\nAsk your AI assistant:\n> \"Convert this Terraform configuration to Pulumi TypeScript\"\n\nThe assistant will use the `pulumi-terraform-to-pulumi` skill to produce idiomatic Pulumi code.\n\n### CDK to Pulumi Migration\n\nAsk your AI assistant:\n\n```text\nHelp me migrate my CDK application to Pulumi\n```\n\nThe assistant will use the `pulumi-cdk-to-pulumi` skill to guide you through the complete migration workflow.\n\n### Managing Secrets with ESC\n\nAsk your AI assistant:\n\n```text\nSet up AWS OIDC credentials using Pulumi ESC\n```\n\nThe assistant will use the `pulumi-esc` skill to help configure dynamic credentials.\n\n### Writing Components\n\nAsk your AI assistant:\n\n```text\nHelp me create a reusable Pulumi component for a web service\n```\n\nThe assistant will use the `pulumi-component` skill to guide you through component authoring best practices.\n\n### Upgrading Providers\n\nAsk your AI assistant:\n\n```text\nHelp me upgrade the Pulumi AWS provider safely without changing real infrastructure\n```\n\nThe assistant will use the `provider-upgrade` skill to guide you through a low-risk upgrade workflow.\n\n### Handing Off Work to Pulumi Neo\n\nAsk your AI assistant:\n\n```text\nHand this off to Neo to apply the staging migration in production\n```\n\nThe 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.\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on:\n\n- Writing new skills\n- Improving existing skills\n- Reporting issues\n\nAlso see [AGENTS.md](AGENTS.md) for agent-specific documentation on skill conventions, cross-skill references, and plugin structure.\n\n## License\n\nApache 2.0 - See [LICENSE](LICENSE) for details.\n\n## Resources\n\n- [Pulumi Documentation](https://www.pulumi.com/docs/)\n- [Agent Skills Specification](https://agentskills.io/specification)\n- [Pulumi ESC Documentation](https://www.pulumi.com/docs/esc/)\n",
  "bytes": 9249,
  "sha": "27041824cde1708f30d376063584b436016dc1cda97786f0ede4e8f2f805c0bb",
  "repo_slug": "pulumi/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_pulumi_agent_skills_pulumi_best_practice_cfbe963a/readme"
}