troubleshoot

Guide users through a search-first diagnostic workflow for reported errors across environments.

19|5|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/digital-stoic-org/agent-skills --skill troubleshoot-digital-stoic-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/digital-stoic-org/agent-skills/tree/main/dstoic/skills/troubleshoot
Command: npx skills add https://github.com/digital-stoic-org/agent-skills --skill troubleshoot-digital-stoic-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you quickly diagnose and resolve errors by guiding a structured, search-first workflow that reduces time-to-fix.

Core Features & Use Cases

  • Guided troubleshooting workflow: load learnings, search for patterns, qualify questions, diagnose, investigate, and learn.
  • Reusable protocols: mental models, isolation, and root cause drills to narrow down root cause.
  • Use case: When a user reports an error in a running system, the assistant guides the user through a deterministic diagnostic sequence to isolate and fix issues.

Quick Start

Describe the symptom to start the troubleshooting workflow.

Frequently Asked Questions about troubleshoot

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

FAQPage Schema
How do I debug a failing deployment or runtime error in a cloud environment?

To debug a failing deployment, this skill applies a search-first diagnostic workflow to guide systemic triage of user-reported errors across local, containerized, and cloud environments. It executes a deterministic sequence to isolate root causes and reduce time-to-fix.

What is the best way to triage user-reported errors systematically?

The best way to triage user-reported errors is using a structured diagnostic sequence that loads learnings, searches for patterns, qualifies questions, diagnoses, investigates, and learns. This guided workflow ensures you narrow down the root cause methodically.

How does a search-first troubleshooting workflow speed up bug diagnosis?

A search-first troubleshooting workflow speeds up bug diagnosis by loading existing learnings and searching for known patterns before asking qualifying questions. This approach applies reusable protocols like mental models and isolation drills to avoid repeating past debugging mistakes.

Can I use this guided workflow for local and containerized debugging sessions?

Yes, you can use this guided workflow for interactive debugging sessions, bug reports, and failing deployments across local, containerized, and cloud environments. It applies a deterministic diagnostic sequence regardless of your specific infrastructure scale.

What reusable protocols are available for root cause isolation?

Reusable protocols for root cause isolation include mental models, isolation drills, and root cause diagnostics. These protocols are integrated into the troubleshooting workflow to help narrow down the exact issue during interactive debugging sessions.

Why does my troubleshooting workflow require qualifying questions during diagnosis?

Qualifying questions are required during diagnosis to systematically narrow down the problem space after searching for existing patterns. This deterministic step ensures the investigation targets the correct root cause rather than chasing unrelated symptoms in running systems.