common-troubleshooting

Run a seven-step hypothesis-driven troubleshooting workflow for PostgreSQL/Kubernetes problems.

1|3|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/IldarMinaev/troubleshooting-skill --skill common-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: common-troubleshooting
Source: https://github.com/IldarMinaev/troubleshooting-skill/tree/main/skills/common-troubleshooting
Command: npx skills add https://github.com/IldarMinaev/troubleshooting-skill --skill common-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Structured, hypothesis-driven troubleshooting framework for PostgreSQL/Kubernetes problems that defines problem definition, investigation steps, and documented RCA.

Core Features & Use Cases

  • Seven-step investigation workflow (problem intake, symptom classification, focused checks, hypothesis refinement, root-cause confirmation, solution & verification, prevention & report) designed to coordinate multiple skills.
  • Delegates data collection and evidence gathering to existing skills, enabling repeatable RCA across deployments.
  • Suitable for vague symptoms or cross-cutting failures that span connections, storage, and performance in Kubernetes-managed PostgreSQL clusters.

Quick Start

Begin with Step 1: Problem Intake and use the recommended skills to gather evidence and validate hypotheses.

Frequently Asked Questions about common-troubleshooting

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

FAQPage Schema
How do I troubleshoot vague PostgreSQL failures in a Kubernetes cluster?

Troubleshoot vague PostgreSQL failures on Kubernetes by applying a hypothesis-driven, seven-step workflow that defines the problem, refines hypotheses, confirms root causes, and outputs a structured RCA for repeatable cross-cutting investigations.

What is a hypothesis-driven root cause analysis framework for databases?

A hypothesis-driven RCA framework enforces mandatory checkpoints across a seven-step process, moving from symptom classification to root-cause confirmation and prevention reporting while delegating evidence gathering to ensure traceable database investigations.

Can I use this structured troubleshooting workflow for connection and storage issues?

Yes, you can use this workflow for connection, storage, and performance issues in Kubernetes-managed PostgreSQL clusters. It handles cross-cutting failures by enforcing mandatory checkpoints and documenting evidence across multiple investigation areas.

How do I start an investigation using the seven-step workflow?

Start an investigation by completing Step 1: Problem Intake. The workflow then recommends specific skills to gather evidence and validate hypotheses, progressing through focused checks and root-cause confirmation to generate a documented RCA.

When should I use a structured RCA workflow instead of ad-hoc debugging?

Use a structured RCA workflow when problems are vague, span multiple areas like connections and storage, or require a documented investigation trail across a Kubernetes-backed PostgreSQL stack. It enforces repeatable, traceable checkpoints over ad-hoc debugging.