scout-diagnose

Diagnose unhealthy Kubernetes resources and GitOps workflows with read-only commands.

14|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/confighub/cub-scout --skill scout-diagnose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scout-diagnose
Source: https://github.com/confighub/cub-scout/tree/main/skills/scout-diagnose
Command: npx skills add https://github.com/confighub/cub-scout --skill scout-diagnose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

cub-scout helps you interpret why Kubernetes or GitOps state looks unhealthy and decide what to do next, without making any changes.

Core Features & Use Cases

  • Interprets live symptoms: Turn questions like “why is this broken?” or “what does this error mean?” into actionable diagnosis guidance.
  • Guides remediation safely: Produces suggested remedies for a finding while explicitly avoiding any mutation of cluster state.
  • Finds known failure modes: Uses pattern detection to match symptoms against built-in Kubernetes and GitOps issue patterns.
  • Supports GitOps health checks: Diagnoses Flux and Argo pipeline health for stuck reconciles and source/app errors.

Quick Start

Ask: “Explain the Deployment api in namespace prod and tell me what’s wrong and the next read-only command I should run to investigate.”

Frequently Asked Questions about scout-diagnose

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

FAQPage Schema
How do I diagnose why a Kubernetes Deployment is unhealthy without making any changes?

Diagnose unhealthy Kubernetes resources by applying read-only kubectl commands to observe live cluster state and match symptoms against known failure patterns. This generates structured diagnosis outputs with suggested next-step remediation commands while strictly avoiding any mutations to cluster state.

Why is my GitOps reconciliation stuck in Flux or ArgoCD?

GitOps reconciliation gets stuck due to source synchronization errors or application health failures in pipelines like Flux or Argo. Diagnose these GitOps issues by analyzing pipeline health status and matching stuck reconcile symptoms against built-in GitOps failure patterns to identify the root cause.

Can I debug Kubernetes cluster issues from an offline scan or file input?

Yes, you can debug Kubernetes cluster issues from offline scan outputs or file inputs. The diagnosis process accepts live cluster observations as well as offline file inputs to interpret symptoms, explain errors, and recommend next-step investigation commands without requiring direct cluster connectivity.

What is pattern matching for Kubernetes failure detection?

Pattern matching for Kubernetes failure detection is the process of comparing observed cluster symptoms against a library of known issue patterns. It translates observed error states into actionable diagnosis guidance by identifying which built-in Kubernetes or GitOps failure mode matches your current unhealthy resource state.

Does read-only remediation for GitOps workflows allow applying patches?

No, read-only remediation for GitOps workflows does not allow applying patches or any mutations to cluster state. It restricts actions strictly to kubectl and GitOps read surfaces, focusing entirely on generating structured outputs with suggested remedies and next-step investigation commands rather than executing changes.