package-usage SKILL.md skillA

package-usage from pulumi/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add pulumi/agent-skills/package-usage@git:20260722.49e2562

Pins git:20260722.49e2562 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
pulumi/agent-skills
Path
pulumi/skills/package-usage/SKILL.md
Versions recorded
2
Latest version
git:20260722.49e2562, committed Jul 22, 2026
First version recorded
Jun 2, 2026
Size
2,775 bytes
Repository stars
78
License
Apache-2.0

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

## 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.

1. Get the latest version of the package
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pulumi/agent-skills/package-usage@sha256:60a91a13b11d1a91

The line at the top of this page pins the label git:20260722.49e2562, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_j6p4ja3egogxhzls.svg)](https://markdownregistry.com/a/art_j6p4ja3egogxhzls)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Jun 2, 2026 and Jul 22, 2026, about one every 50 days.

versioncommittedcommitsizeaudit
git:20260722.49e2562 latest2026-07-22 49e2562 2,775 BA view · diff
git:20260602.8dccc432026-06-02 8dccc43 2,443 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2775 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

pulumi/agent-skills · 78 stars · license Apache-2.0 · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_j6p4ja3egogxhzls
GET https://markdownregistry.com/api/v1/resolve?ref=pulumi/agent-skills/package-usage
GET https://markdownregistry.com/api/v1/blob/60a91a13b11d1a914e662505be3c94c2bd400cb0c327ad6372af8906204d222e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from pulumi/agent-skills

AGENTS.md AGENTS.md file
pulumi/agent-skills · AGENTS.md
git:20261008.99abfda · audit A · 78 stars
CLAUDE.md CLAUDE.md file
pulumi/agent-skills · CLAUDE.md
git:20260127.62f2745 · audit B · 78 stars
pulumi-neo-handoff SKILL.md skill
pulumi/agent-skills · delegation/skills/pulumi-neo-handoff/SKILL.md · Hand off the current thread to a new Pulumi Neo task as a one-way transfer. Use when the user explicitly asks to hand…
git:20260513.f810e50 · audit A · 78 stars
cloudformation-to-pulumi SKILL.md skill
pulumi/agent-skills · migration/skills/cloudformation-to-pulumi/SKILL.md · Convert, migrate, or import AWS CloudFormation stacks or templates into Pulumi programs. Load this skill whenever a…
git:20260330.2f41625 · audit A · 78 stars
pulumi-arm-to-pulumi SKILL.md skill
pulumi/agent-skills · migration/skills/pulumi-arm-to-pulumi/SKILL.md · Convert or migrate Azure ARM (Azure Resource Manager) templates, Bicep templates, or code to Pulumi, including…
git:20260330.2f41625 · audit A · 78 stars
pulumi-cdk-to-pulumi SKILL.md skill
pulumi/agent-skills · migration/skills/pulumi-cdk-to-pulumi/SKILL.md · Load this skill when a user wants to migrate, convert, port, translate, or move an AWS CDK application (including CDK…
git:20260330.2f41625 · audit A · 78 stars
pulumi-migrate-from-discovered-stack SKILL.md skill
pulumi/agent-skills · migration/skills/pulumi-migrate-from-discovered-stack/SKILL.md · Migrate a CloudFormation or ARM stack into a Pulumi stack, sourced from a stack that Pulumi Cloud's Discovery feature…
git:20260803.4be16bf · audit A · 78 stars
pulumi-terraform-to-pulumi SKILL.md skill
pulumi/agent-skills · migration/skills/pulumi-terraform-to-pulumi/SKILL.md · Migrate Terraform/OpenTofu projects to Pulumi, including translating HCL source code and/or importing Terraform state…
git:20260330.2f41625 · audit A · 78 stars
pulumi-upgrade-provider SKILL.md skill
pulumi/agent-skills · package-maintenance/skills/pulumi-upgrade-provider/SKILL.md · Automate Pulumi provider repo upgrades with the `upgrade-provider` tool. Use when upgrading a pulumi provider…
git:20260716.8880e3c · audit A · 78 stars
upstream-patches SKILL.md skill
pulumi/agent-skills · package-maintenance/skills/upstream-patches/SKILL.md · Create, amend, remove, and rebase patches for Terraform provider submodules using `./scripts/upstream.sh`. Use when…
git:20260716.8880e3c · audit A · 78 stars
provider-upgrade SKILL.md skill
pulumi/agent-skills · pulumi/skills/provider-upgrade/SKILL.md · Upgrade any Pulumi provider to a newer version and reconcile the resulting diff. Use when users want to upgrade or…
git:20261005.e2aa9b8 · audit A · 78 stars
pulumi-automation-api SKILL.md skill
pulumi/agent-skills · pulumi/skills/pulumi-automation-api/SKILL.md · Load this skill when a user asks how to run Pulumi programmatically, embed Pulumi in an application, orchestrate…
v1.0.0 · audit A · 78 stars

Every file in pulumi/agent-skills

Browse by kind, by grade A, or by owner.