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.