troubleshooting-guide

Generate structured troubleshooting guides with diagnostic steps and solutions.

19|5|Updated Nov 23, 2025
One-click install
npx skills add https://github.com/Nir-Bhay/markups --skill troubleshooting-guide-nir-bhay
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting-guide
Source: https://github.com/Nir-Bhay/markups/tree/main/.agents/skills/troubleshooting-guide
Command: npx skills add https://github.com/Nir-Bhay/markups --skill troubleshooting-guide-nir-bhay

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides structured, step-by-step guidance for diagnosing and resolving technical issues, reducing downtime and user frustration.

Core Features & Use Cases

  • Diagnostic Procedures: Creates detailed, logical troubleshooting flows.
  • FAQ & Problem Resolution: Generates comprehensive guides for common and complex problems.
  • Use Case: A user encounters a persistent network connectivity issue. They can use this Skill to generate a guide that systematically checks physical connections, IP configurations, firewall rules, and application-level issues, leading them to the root cause.

Quick Start

Generate a troubleshooting guide for a "database connection failed" error.

Frequently Asked Questions about troubleshooting-guide

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

FAQPage Schema
How do I create a structured troubleshooting guide for a network connectivity issue?

To create a troubleshooting guide for a network connectivity issue, define the problem statement, list symptoms and error messages, then establish logical diagnostic steps to systematically check physical connections, IP configurations, and firewall rules to find the root cause.

What should be included in a technical diagnostic procedure for API failures?

A technical diagnostic procedure for API failures should include a clear problem statement, observed symptoms, specific error messages, step-by-step diagnostic actions, targeted solutions, verification methods, rollback instructions, and defined escalation paths.

How do I structure FAQs for resolving database connection errors?

Structure FAQs for database connection errors by pairing common symptoms and specific error messages with direct solutions, followed by verification steps and rollback instructions to ensure comprehensive problem resolution and system stability.

Can I generate rollback instructions and escalation paths for complex technical support issues?

Yes, you can generate rollback instructions and escalation paths for complex technical support issues. The guide creates structured procedures that detail recovery actions and define escalation paths for unresolved diagnostic scenarios.

What is the best way to document step-by-step solutions for technical problem resolution?

The best way to document step-by-step solutions for technical problem resolution is using structured templates that logically sequence problem statements, diagnostic steps, applied fixes, and verification procedures to reduce downtime and user frustration.