Kong/ai-marketplace / plugins/kong-konnect/skills/konnect-gateway-triage
konnect-gateway-triage
VerifiedUse when triaging Konnect Gateway control-plane and data-plane failures such as disconnected planes, missing rollout, or wrong environment slices; separate attachment, network, live-state drift, and traffic-path failures before handing off fixes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.1 KB |
| references/common-failure-signals.md | markdown | 2.2 KB |
| references/connection-bootstrap.md | markdown | 2.9 KB |
| references/live-vs-declarative-drift.md | markdown | 2.5 KB |
| references/traffic-path-vs-control-plane.md | markdown | 2.1 KB |
references/traffic-path-vs-control-plane.md
View on GitHub# Traffic Path vs Control Plane
Use this file when the control plane and data plane appear healthy but requests
still fail, route incorrectly, or miss the expected plugin behavior.
## Core Rule
Once connectivity is healthy, stop treating the issue as a registration
problem. Move to the request path and the live resource path.
## Inspection Order
1. Confirm the target service, route, or plugin is actually present live.
2. Confirm the request is hitting the intended hostname, path, and protocol.
3. Confirm the route match assumptions align with the real request.
4. Confirm the expected plugin is attached at the intended scope.
5. Confirm upstream or target behavior is not the real failure domain.
## Common Traffic-Side Signals
| Symptom | Likely branch |
|---|---|
| 404/route miss | hostname/path/method mismatch, wrong route, wrong control plane |
| Auth/plugin behavior missing | plugin not attached where expected, wrong route hit, stale rollout |
| Upstream errors after correct routing | upstream/target issue, not Konnect control-plane health |
| Only some requests fail | selective route match, partial rollout, label/environment split |
## Useful Distinctions
- Healthy plane plus missing route behavior is usually a resource or request
path problem.
- Healthy routing plus bad upstream response is not a Konnect control-plane
problem.
- Partial behavior across environments often means wrong labels, wrong
hostname, or wrong slice, not universal Gateway failure.
## Decision Rules
- If the expected route or plugin is missing live, go back to the drift branch
instead of guessing about request shape.
- If the request is hitting the wrong route, keep the diagnosis on route match
assumptions rather than reopening plane-health triage.
- If routing is correct and the upstream response is bad, hand off to the
upstream owner instead of treating it as a Konnect control-plane incident.
## What To Return
Return one primary traffic-path diagnosis:
- wrong route/service/plugin target
- request does not match intended route
- upstream failure after correct routing
- partial or stale rollout affecting only part of the traffic path
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 |