Skip to content

Kong/ai-marketplace / plugins/kong-konnect/skills/kongctl-query

kongctl-query

Verified

Use when the user wants read-only `kongctl` queries against Konnect: prove auth or scope, discover the right `get` path, list or fetch resources, or shape JSON/YAML output. Do not use for `kongctl` plan/apply/sync or declarative authoring.

references/auth-and-scope-checks.md

View on GitHub
# Auth and Scope Checks

Use this file when a read-only query problem may actually be auth, profile,
region, or scope related.

## Core Rule

Do not assume a failed query means the resource path is wrong. Prove auth and
scope first.

## Quick Checks

- `kongctl version`
- `kongctl get organization -o json`
- `kongctl get me -o json`
- inspect `--profile` use and relevant `KONGCTL_*` overrides

Authentication defaults:

- Prefer `kongctl login` for interactive sessions.
- Use PAT or SPAT environment variables for non-interactive sessions only.
- Inspect variable names only. Never print variable values, tokens, or
  config-file secrets, and do not read credential files to diagnose auth.

Scope checks:

- Confirm whether a non-default `--profile <name>` is required.
- Treat org, region, and parent-resource boundaries as separate proof steps.
- If one read works and another is empty, do not assume the second path is
  invalid until the target scope is proven.

## Common Misreads

| Symptom | Likely interpretation |
|---|---|
| Empty results unexpectedly | wrong profile, region, or org slice |
| Query fails broadly | auth or endpoint problem |
| One resource family is visible, another is not | scope/product-surface issue, not always CLI syntax |

## Useful Narrow Follow-Ups

Use the smallest follow-up that isolates the context problem:

```bash
kongctl get organization -o json
kongctl get me -o json
```

If output defaults or profile behavior may be hiding the real problem, inspect:

```bash
env | grep -o '^KONGCTL_[A-Z0-9_]*'
```

## What To Return

Return:

- whether auth/scope is proven
- whether the query issue is environmental rather than structural
- whether another skill should take over once access is understood
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall