---
name: "k9s-terminal-cluster-management"
description: "Navigate, inspect, manage, and debug Kubernetes cluster resources rapidly from the terminal."
metadata:
  author: "Fernand Galiana"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "run k9s terminal ui"
  - "filter pods k9s"
  - "port forward k9s"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# K9s Interactive Terminal UI for Kubernetes Administration

Navigates clusters with K9s: resource filtering, viewing real-time pod logs, execing into containers, port forwarding, viewing resource benchmarks, editing YAML manifests, and customizing keybindings.

## When to Invoke
Invoke this skill whenever you need to:
- run k9s terminal ui
- filter pods k9s
- port forward k9s

## Execution SOP & Rules
1. Run k9s specifying context and namespace: k9s --context prod --namespace default.
2. Type : followed by resource name (e.g. :pods, :deploy, :svc) to switch resource views.
3. Press 'l' to view live logs, 's' to drop into an interactive shell, and 'e' to edit manifest in vim.
4. Press 'Shift-F' to set up instant port-forwarding to local host ports.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.