Kong/ai-marketplace / plugins/kong-konnect/skills/kongctl-query
kongctl-query
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.3 KB |
| references/auth-and-scope-checks.md | markdown | 1.7 KB |
| references/output-shaping.md | markdown | 1.9 KB |
| references/resource-discovery.md | markdown | 1.7 KB |
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
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |