Package Usage

You're managing a Pulumi organization with dozens of stacks and need to know which ones are still running an old version of a shared component package. This skill queries the registry API and your org's package usage data to build a table showing exactly which projects and stacks are behind. It's purpose built for cross-stack audits, not for actually performing the upgrade (that's a different skill). The workflow is straightforward: fetch the latest version, pull usage across all stacks, compare, and surface the laggards. Most useful when you're about to publish breaking changes to an internal package or coordinating a rollout and need to know the blast radius first.

skills.sh installs: 860
GitHub stars: 79
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add pulumi/agent-skills --skill package-usage --agent claude-code

Installs into .claude/skills of the current project.

Files

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 package
stacks: 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.

SKILL.md on GitHub

Details

Repository: github.com/pulumi/agent-skills
Categories: Frontend Development, DevOps & CI/CD, AI & Agent Building, Productivity & Planning, Cloud & Infrastructure
First seen: Jun 3, 2026

More from pulumi/agent-skills

All 12