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/resource-discovery.md
View on GitHub# Resource Discovery
Use this file when the main issue is which `kongctl get` path should be used.
## Core Rule
Use help and the live CLI surface to discover the correct read path instead of
guessing resource names or child-resource patterns.
## Discovery Order
1. `kongctl help`
2. `kongctl get --help`
3. `kongctl get <resource> --help`
4. inspect child-resource forms only after the parent resource type is proven
If the surface is broad and the correct `get` subcommand is unclear, extract
the current `kongctl get` subcommands from help output instead of guessing:
```bash
kongctl get --help | awk '
/^Available Commands:/ {capture=1; next}
capture && NF==0 {exit}
capture && $1 ~ /^[a-z0-9-]+$/ {print $1}
'
```
## Common Cases
| Need | Default pattern |
|---|---|
| List resources | `kongctl get <resource> -o json` |
| Get one resource | `kongctl get <resource> "<name-or-id>" -o json` |
| Query child resources | `kongctl get <parent> <child> --<parent>-name "<name>" -o json` |
Use these patterns as discovery anchors, not as proof that a specific resource
family exists in the current CLI version or scope.
## Child-Resource Guardrail
- Prove the parent resource family first.
- Use the parent command's help output to discover supported child resources.
- If the child result is empty, treat that as a possible "nothing under this
parent" result before assuming the path is wrong.
Minimal examples:
```bash
kongctl get portals --help
kongctl get portals pages --portal-name "<portal-name>" -o json
kongctl get apis documents --api-name "<api-name>" -o json
```
## What To Return
Return:
- which resource path is the right one
- whether the operator needs parent-child context
- whether a domain skill should own the diagnosis after the read
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 |