operator-incident-evidence

Capture Kubernetes/GitOps incident evidence with fingerprinted receipts and bundle artifacts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of producing an audit-ready, structured evidence package for a Kubernetes/GitOps incident after the peak has passed, so the postmortem can be written with confidence rather than guesswork.

Core Features & Use Cases

  • Structured evidence capture: Composes trace + explain + compare three-way for affected resources to attribute what happened at the field level.
  • Connected-mode timelines: Captures ChangeSets/history and ConfigHub audit trails to connect operator-visible events to governed intent.
  • Fingerprintable receipts and validation: Generates immutable receipts via receipt verify --save and supports later receipt validate to prove evidence integrity.
  • Offline replay artifacts: Uses bundle and snapshot so reviewers can inspect what cub-scout observed at capture time, even after the cluster moves on.

Quick Start

Build the evidence package for last night's incident for namespace prod and the affected workload payments-api, saving receipts and a bundle for offline review.

Frequently Asked Questions about operator-incident-evidence

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

FAQPage Schema
How do I capture immutable evidence for a Kubernetes postmortem?

Capture immutable postmortem evidence by tracing affected resources, comparing live state to governed intent, and generating fingerprinted receipts. This process produces bundle and snapshot outputs that preserve what was observed at capture time for later audit validation.

How does offline replay work for GitOps incident artifacts?

Offline replay for GitOps incident artifacts works by using bundle and snapshot outputs to preserve the observed cluster state. Reviewers can inspect these captured artifacts later, even after the Kubernetes cluster has moved on and changed states.

What's the best way to attribute field-level changes during an incident?

Attribute field-level changes by composing a three-way trace, explain, and compare analysis for affected resources. This connects operator-visible events to governed intent using ChangeSets, history, and audit trails to determine exactly what happened.

How do I validate incident receipts after the cluster state changes?

Validate incident receipts after the cluster state changes by running a receipt validate command on the previously saved artifacts. This proves the evidence integrity of the immutable package generated during the initial capture.

Can I use read-only commands to capture Kubernetes incident evidence?

You can generate immutable incident evidence using read-only cub-scout commands. These commands safely trace resources and produce fingerprinted receipts without modifying the live Kubernetes cluster state.

When do I need to assemble an audit-ready evidence package for Kubernetes?

Assemble an audit-ready evidence package for Kubernetes when an incident peak has passed and you need to write a postmortem with confidence. It provides structured artifacts covering a time window, multiple resources, and connected-mode timelines for ownership and attribution.