The Complete Production SOP: How to Deploy and Run kube-capacity Resource Requests & Limits Overview in Autonomous AI Agents

---
name: "kube-capacity-resource-inspector"
description: "View a clear CLI summary of CPU and Memory requests, limits, and utilization across cluster nodes."
metadata:
  author: "Rob Scott"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "run kube-capacity"
  - "inspect k8s node requests limits"
  - "find overcommitted k8s nodes"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

#!/usr/bin/env bash
set -euo pipefail

if ! command -v kube-capacity &>/dev/null; then
  echo "Error: kube-capacity CLI not found in PATH." >&2
  exit 1
fi

# Validate read access to nodes without pulling large payloads
kubectl auth can-i get nodes --quiet || {
  echo "Error: Current context lacks read permissions for cluster nodes." >&2
  exit 1
}
echo "kube-capacity and Kubernetes credentials successfully verified."

# Execute node-level audit sorted by CPU requests, including utilization and available capacity
kube-capacity \
  --sort cpu.request \
  --available \
  --util \
  --output table

#!/usr/bin/env bash
# Simple lint verification script to confirm exit code and non-empty output
if [ ! -s /tmp/capacity_audit.json ]; then
  echo "Verification failed: Audit output is empty." >&2
  exit 1
fi
echo "Audit successfully parsed. Exiting 0."