| name | kube-agent |
| description | Run kube-agent.sh — a lean Kubernetes manifest validator that produces agent-friendly output.
Use when: running Kubernetes manifest validation, kubeconform checks, kubeval checks, verifying K8s manifests before applying,
or when the user asks to validate Kubernetes YAML, run k8s checks, or check manifests.
Triggers on: kube agent, kubernetes validate, kubeconform, kubeval, k8s checks, validate manifests.
|
| context | fork |
| allowed-tools | ["Bash(scripts/kube-agent.sh*)","Bash(RUN_*=* scripts/kube-agent.sh*)","Bash(KUBE_SCHEMAS_DIR=* scripts/kube-agent.sh*)","Bash(KUBE_IGNORE_MISSING_SCHEMAS=* scripts/kube-agent.sh*)","Bash(MAX_LINES=* scripts/kube-agent.sh*)","Bash(KEEP_DIR=* scripts/kube-agent.sh*)","Bash(FAIL_FAST=* scripts/kube-agent.sh*)","Bash(CHANGED_FILES=* scripts/kube-agent.sh*)","Bash(TMPDIR_ROOT=* scripts/kube-agent.sh*)"] |
Kube Agent
Run the kube-agent.sh script for lean, structured Kubernetes manifest validation output designed for coding agents.
Script Location
scripts/kube-agent.sh
Usage
Run Full Suite (validate)
scripts/kube-agent.sh
Run Individual Steps
scripts/kube-agent.sh validate
scripts/kube-agent.sh all
Environment Knobs
| Variable | Default | Description |
|---|
RUN_VALIDATE | 1 | Set to 0 to skip validate step |
KUBE_SCHEMAS_DIR | (empty) | Custom schema location for validator |
KUBE_IGNORE_MISSING_SCHEMAS | 0 | Set to 1 to skip resources with missing schemas (useful for CRDs, offline) |
FAIL_FAST | 0 | Set to 1 to stop after first failure (or use --fail-fast) |
CHANGED_FILES | (empty) | Space-separated changed file paths; scopes to matching manifests |
MAX_LINES | 40 | Max output lines printed per step (unlimited in CI) |
KEEP_DIR | 0 | Set to 1 to keep temp log dir on success |
Output Format
- Each step prints a header (
Step: validate)
- Results are
PASS, FAIL, or SKIP
- On failure, output is truncated to
MAX_LINES
- Full logs are saved to a temp directory (path printed in output)
- Overall result is printed at the end:
Overall: PASS or Overall: FAIL
Important Notes
- Prefers
kubeconform over kubeval; exits with code 2 if neither is installed
- Discovers
.yml/.yaml files containing both apiVersion: and kind:
- Excludes
.git/, .github/, node_modules/, and charts/ directories
CHANGED_FILES scopes validation to only the specified files- Reports SKIP when no Kubernetes manifests are found
- In CI (
CI=true), MAX_LINES defaults to unlimited; locally it defaults to 40
