cluster-ops

Inspect and recover Spacebot deployments in a Talos Kubernetes cluster.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/jrmatherly/spacebot --skill cluster-ops-jrmatherly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cluster-ops
Source: https://github.com/jrmatherly/spacebot/tree/main/.claude/skills/cluster-ops
Command: npx skills add https://github.com/jrmatherly/spacebot --skill cluster-ops-jrmatherly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides an operational runbook to diagnose, clean, redeploy, and validate Spacebot running in a Talos Kubernetes cluster so operators can recover from failures and confirm healthy operation.

Core Features & Use Cases

  • Cluster Health Checks: Consolidated status of pods, services, PVCs, endpoints, and Flux/Helm reconciliation for the ai namespace.
  • Logs & Debugging: Tail and inspect recent and previous container logs, diagnose CrashLoopBackOff, ImagePullBackOff, networking, and storage issues.
  • Clean, Redeploy & Validate: Guided safe cleanup workflow with Flux suspension, ordered resource deletion, forced reconciliation, rollout monitoring, and post-deployment health and metrics validation.
  • Use Case: When Spacebot enters CrashLoopBackOff after an image update, use this Skill to collect logs, verify PVC and network state, remove or repair faulty resources, force Flux to reconcile, and confirm endpoints and health checks are responding.

Quick Start

Run the cluster-ops status operation to produce a consolidated health dashboard of Spacebot pods, services, PVCs, and Flux reconciliation.

Frequently Asked Questions about cluster-ops

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot a CrashLoopBackOff in a Talos Kubernetes deployment?

Troubleshoot a CrashLoopBackOff in a Talos Kubernetes deployment by using kubectl and talosctl to inspect pod logs, verify PVCs, and check networking state. This Skill guides you through diagnosing container failures and inspecting recent or previous logs to identify the root cause.

How do I force Flux reconciliation after cleaning up faulty Kubernetes resources?

Force Flux reconciliation by suspending and resuming kustomizations, deleting targeted resources in order, and triggering forced reconciliation. This Skill provides a guided cleanup workflow to safely remove resources and monitor the subsequent rollout.

Can I view previous container logs to diagnose ImagePullBackOff in Kubernetes?

Yes, you can view previous container logs to diagnose ImagePullBackOff using kubectl log inspection commands. This Skill allows you to tail recent and previous container logs to troubleshoot image pull failures and storage issues.

What is the best way to validate health and metrics endpoints after a Kubernetes redeployment?

Validate health and metrics endpoints after a Kubernetes redeployment by checking consolidated pod, service, and endpoint status. This Skill performs post-deployment validation to confirm endpoints and health checks are responding correctly.

Does this cluster troubleshooting workflow support Talos and Flux recovery operations?

Yes, this cluster troubleshooting workflow supports Talos and Flux recovery operations using talosctl, kubectl, and flux commands. It specifically applies to cluster troubleshooting, redeployments, and Flux reconciliation within the ai namespace.