package-usage
Track which stacks across a Pulumi organization use a specific package and at what versions. Use for cross-stack audits, identifying outdated or unmaintained package versions across many stacks, finding affected stacks before publishing breaking changes to a component package, or planning coordinated upgrade rollouts. Do NOT use for upgrading a cloud provider package (pulumi-aws, pulumi-azure-native, pulumi-gcp, pulumi-kubernetes, etc.) in a single project — use skill `provider-upgrade` instead. Do NOT use for general infrastructure creation, resource provisioning, or how-to questions about a package.
How do I install this agent skill?
npx skills add https://github.com/pulumi/agent-skills --skill package-usageIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a legitimate tool for Pulumi users to track and audit package versions across their infrastructure stacks using official Pulumi API endpoints. No malicious patterns, data exfiltration, or injection vulnerabilities were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
API Reference
Query the Pulumi Cloud API with the pulumi api CLI subcommand. It authenticates with your existing Pulumi credentials and returns JSON.
Get the latest version of a package
pulumi api /api/registry/packages -F name={package_name} -F orgLogin={orgName}
Include orgLogin with the user's organization name. Omit -F name=... to list all packages visible to the organization (useful when the user has not named a specific package). The response contains a packages array. Each entry has a version field (the latest version), plus name, publisher, source, and packageStatus.
Get stack usage for a package
pulumi api /api/orgs/{orgName}/packages/usage -F packageName={package_name}
Replace {orgName} with the org name from context, PULUMI_ORG, or ask the user. packageName is required; query one package at a time.
Response fields:
packageName: The queried packagestacks: Array of{stackName, projectName, version, lastUpdate}totalStacks: Total count
Workflow: Find outdated stacks
Use when the user wants to know which stacks are using an outdated version of a package.
- Get the latest version of the package
- Get stack usage for the package
- Compare each stack's
versionagainst the latest to identify outdated stacks - Present results using the output format below
Output Format
Present results as a markdown table followed by a summary line:
| Project | Stack | Current Version | Latest Version | Status |
|---------|-------|-----------------|----------------|--------|
| my-app | dev | 6.40.0 | 6.52.0 | Outdated |
| my-app | prod | 6.52.0 | 6.52.0 | Up-to-date |
2 of 2 stacks checked. 1 outdated.
Out of scope: upgrading a specific stack
This skill identifies outdated stacks. It does not perform the upgrade itself. For actually bumping a package version in a project — editing package.json, requirements.txt, pyproject.toml, go.mod, or Pulumi.yaml, running pulumi preview, and reconciling the diff — hand off to the provider-upgrade skill.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/pulumi/agent-skills/package-usage">View package-usage on skillZs</a>