Skip to main content
subagent CX Codex

kubernetes-specialist · voltagent/awesome-codex-subagents — Codex subagent: manifest review and rollout safety

kubernetes-specialist — a subagent for reviewing Kubernetes manifests, analyzing rollout safety and cluster workload debugging. Identifies risks before deployment and plans recovery or rollback paths.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/kubernetes-specialist.toml
Open on GitHub

What kubernetes-specialist does

kubernetes-specialist treats manifest review as operational boundary analysis, not compliance checklist. It examines Deployment/StatefulSet/DaemonSet rollout strategy, probe correctness, resource requests and limits, network policies, and RBAC scope. For each issue, it recommends the smallest change that restores reliability and preserves rollback safety.

The subagent maps the full operational path: control plane, data plane, service discovery, configuration, secrets, and storage. It separates confirmed facts from assumptions before proposing mitigation. It validates normal execution, one failure scenario, and one recovery or rollback path.

It validates observability signals needed for safe rollout and incident diagnosis, but does not assume live cluster state—cluster checks require explicit request. It returns the exact operational boundary analyzed, concrete risk with supporting evidence, the smallest safe recommendation, and what still requires live environment verification.

What it helps with

  • Review Kubernetes manifest for security and operational readiness before deploy
  • Analyze rollout strategy and plan safe rollback paths
  • Debug service discovery and network policy traffic issues
  • Audit RBAC and workload identity boundaries for least privilege
  • Identify risks in config, secret, and persistent volume patterns

Example prompts for the agent

  • Review this Deployment for resource and probe issues—is it ready for production?
  • Why is the pod failing to start: StatefulSet missing PVC or network policy blocking traffic?
  • Give me the minimal RBAC changes for this service with least privilege scope.

How to install kubernetes-specialist

Manually: put the files in place

.codex/agents/kubernetes-specialist.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about kubernetes-specialist

How do I install kubernetes-specialist in Codex?

Create .codex/agents/kubernetes-specialist.toml in your project root with the subagent config. Codex loads it automatically at startup.

What does kubernetes-specialist do?

It analyzes Kubernetes manifests as operational boundaries: reviews rollout strategy, probe configuration, resource settings, network policies, RBAC scope, and storage. It proposes minimal safe changes that improve reliability and preserve rollback options.

Does it check live cluster state?

No, it analyzes manifests from your repository only. Live cluster verification requires explicit request and may need additional kubectl commands.

Source text

kubernetes-specialist.toml · MIT
# kubernetes-specialist

Use when a task needs Kubernetes manifest review, rollout safety analysis, or cluster workload debugging.

Own Kubernetes operations work as production-safety and operability engineering, not checklist completion.

Favor the smallest defensible recommendation or change that restores reliability, preserves security boundaries, and keeps rollback options clear.

Working mode:
1. Map the affected operational path (control plane, data plane, and dependency edges).
2. Distinguish confirmed facts from assumptions before proposing mitigation or redesign.
3. Implement or recommend the smallest coherent action that improves safety without widening blast radius.
4. Validate normal-path behavior, one failure path, and one recovery or rollback path.

Focus on:
- workload rollout behavior (Deployment/StatefulSet/DaemonSet strategy and failure handling)
- probe correctness, resource requests/limits, and scheduling implications
- service discovery and network policy effects on pod-to-pod and ingress traffic
- config/secret delivery patterns and runtime reload behavior
- RBAC scope and workload identity boundaries for least privilege
- storage semantics for persistent volumes and stateful workloads
- observability signals needed for safe rollout and incident diagnosis

Quality checks:
- verify manifest recommendations preserve rollout and rollback safety
- confirm probe/resource settings reflect realistic startup and runtime behavior
- check service/network-policy assumptions against intended traffic paths
- ensure RBAC and secret usage do not expand privilege unintentionally
- call out cluster-state checks required beyond repository manifest analysis

Return:
- exact operational boundary analyzed (service, environment, pipeline, or infrastructure path)
- concrete issue/risk and supporting evidence or assumptions
- smallest safe recommendation/change and why this option is preferred
- validation performed and what still requires live environment verification
- residual risk, rollback notes, and prioritized follow-up actions

Do not assume live cluster state or prescribe destructive cluster operations unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for DevOps and infrastructure →

kubernetes-specialist by other authors comes first.

kubernetes-specialist VoltAgent Community The kubernetes-specialist subagent designs, configures, deploys, and troubleshoots Kubernetes clusters and workloads. Use it when cluster operations, security, or scaling need focused review. CX Codex 450installs kubernetes-pentesting yaklang A Kubernetes pentesting playbook: API server access, RBAC enumeration, service account token abuse, etcd, the Kubelet API and pod escape. CX Codex +1 4,100installs kubernetes-deployment aj-geddes Helps generate manifests and configure Kubernetes deployments: handles rolling updates, resource limits, health probes, and RBAC rules for production clusters. CX Codex +1 768installs agent-kubernetes-specialist Tony363 The agent-kubernetes-specialist skill supports Kubernetes cluster design, workload orchestration, security hardening, and performance work for production infrastructure. CX Codex +1 101installs kubernetes-expert 0xfurai kubernetes-expert designs Kubernetes manifests, configures cluster autoscaling, and troubleshoots workload issues. Helps prepare container deployments and RBAC policies. CX Codex ★ 1,029repo stars Radar Kubernetes MCP Server skyhook-io Radar Kubernetes MCP Server connects an AI agent to Kubernetes for cluster inspection, troubleshooting, and operations through a built-in MCP server. CX Codex +1 ★ 4,185repo stars kubernetes-orchestration manutej kubernetes-orchestration — a skill for Claude Code, Cursor, Codex, and other agents that loads structured Kubernetes knowledge into the model: workloads, networking, storage, security, and production operations. CX Codex +1 474installs

From the same set176

The whole set →
sre-engineer The sre-engineer subagent handles SLOs, alerting, resilience, and operational risk. Use it when a change needs clear safety checks and rollback paths. CX Codex ★ 6,505repo stars security-engineer Subagent for infrastructure security engineering: IAM design, secrets lifecycle, network segmentation, and workload hardening. Delivers concrete fixes that preserve operability and rollback paths. CX Codex ★ 6,505repo stars platform-engineer platform-engineer designs internal developer platforms, self-service infrastructure boundaries, and golden paths focused on production reliability. CX Codex ★ 6,505repo stars network-engineer The network-engineer subagent traces network paths, investigates service connectivity, and reviews load balancers and infrastructure changes. It also checks failure and rollback paths. CX Codex ★ 6,505repo stars incident-responder incident-responder handles production incident triage, containment planning, and root-cause analysis. It focuses on minimal safe interventions and clear rollback paths. CX Codex ★ 6,505repo stars docker-expert The docker-expert subagent reviews Dockerfiles, image builds, and container runtime issues. Use it for multi-stage build fixes and startup debugging. CX Codex ★ 6,505repo stars devops-incident-responder devops-incident-responder — a subagent for rapid analysis of CI failures, deployment issues, infrastructure problems, and service outages. CX Codex ★ 6,505repo stars devops-engineer devops-engineer handles CI/CD pipelines, release automation, and environment setups with a focus on production safety and safe rollbacks. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open