pulumi-context-api — скилл для Claude Code: что делает и установка
Опрашивает Pulumi Context API, чтобы строить граф инфраструктуры в Pulumi Cloud, оценивать влияние изменений и находить зависимости между стеками.
Apache-2.0 211 установок ★ 80 обновлён 2026-10-09
npx skills add pulumi/agent-skills --skill pulumi-context-api -a claude-codeЧто делает pulumi-context-api
Скилл учит агента исследовать граф ресурсов в Pulumi Cloud. Он отслеживает связи между компонентами. Агент оценивает зону влияния правок и находит брошенные ресурсы. В граф попадает и инфраструктура, обнаруженная через Pulumi Discovery, даже если сам Pulumi ею напрямую не управляет.
Сначала агент проверяет сессию на наличие встроенных инструментов graph_query и get_graph_schema. Если их нет, он загружает свежую схему запросов через CLI командой pulumi api GetGraphQuerySchema --output=markdown. Затем формирует JSON-селектор и отправляет запрос pulumi api GraphQuery -F orgName=<org> --input selector.json. Перед выдачей ответа агент проверяет сигналы полноты выборки: meta.resultMode, meta.visibility и pageInfo.continuationToken.
Без версии Pulumi CLI не ниже v3.243.0, активного pulumi login и тарифов Enterprise или Business Critical вызовы завершатся отказом. Граф возвращает только набор полей из схемы, а не полные свойства объектов. Поэтому для поиска значений свойств или отладки сбоев инструкция рекомендует обращаться к Resource Search или скиллу pulumi-debug-failed-operation.
Какие задачи решает
- Оценить зону влияния (blast radius) перед изменением ресурсов или выходов стека
- Найти зависимости, пересекающие границы стеков и облачных аккаунтов
- Обнаружить брошенные или неиспользуемые облачные ресурсы
- Выяснить версии и экземпляры провайдеров, управляющие инфраструктурой
Примеры запросов агенту
- Используй Pulumi Context API и покажи, что сломается при удалении стека networking в организации my-org.
- Найди через граф Pulumi все неиспользуемые ресурсы и выведи зависимости базы данных.
Как установить pulumi-context-api
1Через Skills CLI (Vercel)
npx skills add pulumi/agent-skills --skill pulumi-context-api -a claude-code2Вручную: положить файлы
~/.claude/skills/pulumi-context-api/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pulumi-context-api/
1Через Skills CLI (Vercel)
npx skills add pulumi/agent-skills --skill pulumi-context-api -a codex2Вручную: положить файлы
.agents/skills/pulumi-context-api/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pulumi/agent-skills --skill pulumi-context-api -a cursor2Вручную: положить файлы
.cursor/skills/pulumi-context-api/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pulumi/agent-skills pulumi/skills/pulumi-context-api2Вручную: положить файлы
.github/skills/pulumi-context-api/SKILL.md1Через Skills CLI (Vercel)
npx skills add pulumi/agent-skills --skill pulumi-context-api -a gemini-cli2Командой платформы
gemini skills install https://github.com/pulumi/agent-skills --path pulumi/skills/pulumi-context-apiВручную: положить файлы
.devin/skills/pulumi-context-api/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pulumi/agent-skills --skill pulumi-context-api -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о pulumi-context-api
Как установить pulumi-context-api в Claude Code?
Запустите команду npx skills add pulumi/agent-skills --skill pulumi-context-api -a claude-code. Она запишет файл скилла в ~/.claude/skills/pulumi-context-api/SKILL.md.
Чем Context API отличается от обычного Resource Search в Pulumi?
Resource Search находит отдельные ресурсы по имени или типу, но не умеет следовать по рёбрам графа. Context API предназначен для отслеживания связей, переходов между стеками и оценки зоны влияния изменений.
Что требуется для выполнения запросов через этот скилл?
Нужны Pulumi CLI версии v3.243.0 или выше, выполненный вход pulumi login и организация с тарифом Enterprise или Business Critical. Учётной записи также требуется роль с правом resources:search.
Исходный текст
SKILL.md · Apache-2.0
---
name: pulumi-context-api
description: |
Query the Pulumi Context API, a graph query interface over an
organization's infrastructure in Pulumi Cloud. Use when a question is
about relationships or reachability across resources and stacks: the
impact of a change ("what breaks if I change this?", blast radius), what
depends on a resource or a stack's outputs, which provider instances
manage which resources and at what versions, orphaned or unreferenced
resources, or references that cross stacks and cloud accounts, including
resources Pulumi doesn't manage. Don't load it for finding a single
resource by name, type, or property (Resource Search covers that), or for
update history and failure debugging (use skill
`pulumi-debug-failed-operation`).
---
# Query the Pulumi Context API
The Context API answers questions about an organization's cloud infrastructure
as a graph: what exists, what depends on what, what a change would affect. It
covers resources found through Pulumi Discovery, not just Pulumi-managed ones.
Prefer it over Resource Search whenever the question involves relationships.
Resource Search finds individual resources but cannot follow edges, so
answering "what depends on X" with repeated searches is slow and usually
incomplete.
Public preview, for organizations on the Enterprise and Business Critical
editions, and a role granting `resources:search` (the default Member and Admin
roles do).
## First: is a graph tool already in the session?
If one is — `graph_query` and `get_graph_schema`, under whatever prefix the
server registers them — call it and skip Steps 1 and 2. Compose the selector
from the `graph_query` tool's own description, which carries the grammar; the
tool resolves the organization and credentials itself and drains pagination for
you. When that description is not enough, `get_graph_schema` returns the live
field vocabulary and limits, and will serve the full Step 1 primer when asked
for it. Step 3 still governs what you do with the result.
Steps 1 and 2 are the path for an agent that has a shell and no such tool.
## Step 1: fetch the primer, always
Needs Pulumi CLI v3.243.0 or newer and an active `pulumi login`.
```bash
pulumi api GetGraphQuerySchema --output=markdown
```
This returns a self-contained guide to composing selectors — vocabulary, edge
types, engine caps, worked examples, pagination, completeness rules, the gates
that deny a query, and the traps that produce a confident wrong answer instead
of an error. It is served by the deployment that answers your queries, so it is
the contract, and it moves between schema versions. This skill bootstraps you
to it and stops there; everything below defers to it. Fetch it fresh in every
session — a primer remembered from earlier may describe a schema this
deployment no longer serves.
The operation takes no organization; one schema covers every org the login can
reach. `--output=json` on it returns the same contract as a machine-readable
payload, useful for reading `limits` or `fieldValues` programmatically, but
compose from the markdown.
**Read it in full — never truncate it with `head`, `tail`, or a byte cap.** A
clipped primer means malformed selectors and rejected queries.
### If this call fails
You have no primer yet, so handle it here rather than looking it up there:
| Response | Meaning |
|---|---|
| `401 Unauthorized` | no active `pulumi login`, or an expired token |
| `404 Not Found`, detail-free | a wrong path, or a deployment without the endpoint |
| `503 Service Unavailable` | transient — retry |
Entitlement gates are per-organization, so they cannot appear on this call —
they surface in Step 2, by which point the primer's "When it denies you" table
is in hand. If `pulumi api` doesn't know `GetGraphQuerySchema` at all, that is
not a gate: run `pulumi api list --refresh-spec` to refresh the cached spec,
then retry the fetch.
## Step 2: query
```bash
pulumi api GraphQuery -F orgName=<org> --input selector.json
```
The body is a JSON selector, not query text. Compose it from the primer you
just read, not from memory or from a grammar you recall from another session.
Name the org explicitly. Left off, `-F orgName` resolves from the selected
stack or the default org, which is often an individual account with no
entitlement; `pulumi whoami -v` lists every organization the login can reach.
A denial here names its gate — the primer's "When it denies you" table says
which are worth retrying and which to report to the user.
## Step 3: apply the primer's completeness rules before answering
Every response carries fidelity signals — currently `meta.resultMode`,
`meta.visibility`, and `pageInfo.continuationToken`; the primer names the
authoritative set. Read the primer's rules for them and follow them; the
remedies differ per signal and a stale paraphrase here would be worse than
none.
What matters most: **a completeness claim needs all of them clean.** Impact
analysis, "nothing depends on this", an exhaustive cleanup list, a total across
groups — none of these survive a truncated result, a trimmed traversal, or an
undrained page. When you can't get there, say what the answer does cover.
## Scope of the graph
Resources, stacks, and the relationships between them, trimmed to the stacks
and accounts the caller can see. The primer's "What it cannot answer yet"
section is the live boundary — check it before concluding a question is
unanswerable, and reach for a different API rather than approximating one of
those gaps with a graph query.
One boundary worth knowing up front, because it decides which API to use: the
graph returns a schema-declared subset of fields per node type, not full
resource property bags. The primer lists which fields each node type can match
on and which it can return; when the question needs the property values
themselves, they come back from Resource Search.
Human-readable reference:
[Context API overview](https://www.pulumi.com/docs/insights/context-api/) and
[query guide](https://www.pulumi.com/docs/insights/guides/context-api/).
© pulumi · Apache-2.0 · pulumi/agent-skills