troubleshooting

Diagnose and resolve development workflow errors using TROUBLESHOOTING.md guidance.

1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/silenvx/flow-development-program --skill troubleshooting-silenvx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: troubleshooting
Source: https://github.com/silenvx/flow-development-program/tree/main/examples/dekita/.claude/skills/troubleshooting
Command: npx skills add https://github.com/silenvx/flow-development-program --skill troubleshooting-silenvx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to diagnose and resolve errors, failures, and issues that arise during development workflows, including worktree problems, hook failures, CI/CD issues, and deployment challenges.

Core Features & Use Cases

  • Diagnostic workflow: Step-by-step guidance to identify root causes.
  • Hook/worktree remediation: Clear instructions to recover unresponsive worktrees and fix hook failures.
  • CI/CD and deployment reliability: Procedures to diagnose and recover from CI/CD and deployment problems.
  • Reference-driven guidance: Directs to TROUBLESHOOTING.md for in-depth context.

Quick Start

Run the troubleshooting plan on the current project to identify and fix the failing workflow.

Frequently Asked Questions about troubleshooting

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

FAQPage Schema
How do I troubleshoot CI/CD pipeline failures and deployment problems?▼

To troubleshoot CI/CD and deployment failures, run a structured diagnostic workflow that identifies root causes and provides actionable remediation steps to recover your pipelines quickly.

What is the best way to resolve git worktree blockages and hook errors?▼

Resolving worktree blockages and hook errors involves applying specific remediation instructions to recover unresponsive worktrees and fix failing hooks using a step-by-step diagnostic process.

Why does my development workflow need structured troubleshooting?▼

Structured troubleshooting standardizes how you diagnose and resolve errors, failures, and issues across development workflows, ensuring consistent root cause identification and safe operational recovery.

How do I load external references for operational incident response guidance?▼

You load external incident-response references by directing the troubleshooting workflow to read the TROUBLESHOOTING.md file, which provides in-depth context and actionable operational guidance.

What are the limitations of using a basic troubleshooting workflow for complex deployment issues?▼

A basic troubleshooting workflow provides step-by-step diagnostic guidance and safe workarounds for common CI/CD and worktree issues, but may lack advanced logic for highly complex, multi-service deployment failures.