skills.rest
sizukutamago
sizukutamagoCOMMUNITY
Explore all skills by this author →
GitHub

shell-debug

Diagnose shell script failures through reproduce, isolate, observe, fix, and verify steps.

Updated Feb 4, 2026
Search Tags:#debugging#tmux#diagnostics#scripting#shell#ci
One-click install
npx skills add https://github.com/sizukutamago/dev-tools-plugin --skill shell-debug
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shell-debug
Source: https://github.com/sizukutamago/dev-tools-plugin/tree/main/skills/shell-debug
Command: npx skills add https://github.com/sizukutamago/dev-tools-plugin --skill shell-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging shell scripts and one-liners can be error-prone and time-consuming. This skill provides a structured workflow to reproduce, isolate, observe, fix, and verify issues efficiently.

Core Features & Use Cases

  • Reproducible workflows: Step-by-step guidance to reproduce issues with minimal inputs.
  • Isolation and observation: Techniques to split pipelines and visualize outputs for precise fault localization.
  • Kaizen handoff: Clear criteria for transferring recurring issues to a kaizen process.
  • Targeted debugging strategies: Quoting/expansion issues, tmux automation scripts, and CI/git hooks are covered.
  • Use Case: A failing shell pipeline with multiple filters (awk, sed, grep) can be diagnosed quickly using staged outputs and minimal reproducible inputs.

Quick Start

Follow the steps in SKILL.md to reproduce and diagnose a shell script issue. Start by confirming the environment, then provide a minimal reproducible example to the AI, and iterate through the stages of reproduction, isolation, observation, fixing, and verification.

Frequently Asked Questions about shell-debug

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

FAQPage Schema
How do I debug a failing shell script pipeline with multiple filters?▼

To debug a shell script pipeline, you need a structured workflow to reproduce, isolate, and observe failures. Split pipelines and visualize staged outputs for precise fault localization across filters like awk, sed, and grep.

What is the best way to diagnose quoting and expansion issues in bash scripts?▼

Diagnosing quoting and expansion issues in bash scripts requires a stepwise process: reproduce the error with minimal inputs, isolate the problematic segment, observe the expansion behavior, apply a fix, and verify the result.

Can I use a systematic workflow to debug tmux automation scripts?▼

Yes, you can debug tmux automation scripts using a reproducible workflow. The process targets tmux automation specifically, guiding you through environment confirmation, minimal reproduction, and staged observation to fix failures.

How do I troubleshoot shell script failures in git hooks and CI pipelines?▼

Troubleshooting shell script failures in git hooks and CI pipelines involves confirming the execution environment, providing a minimal reproducible example, and iterating through stages of reproduction, isolation, observation, fixing, and verification.

When should I move a recurring shell debugging issue to a kaizen process?▼

You should move a recurring shell debugging issue to a kaizen process when the same failure patterns repeat. Clear kaizen handoff criteria are applied after verifying a fix, transferring the recurring issue for continuous improvement.

Related Skills

Explore More Software Engineering Skills→
crazymsncrazymsn
22

pacsomatic

Validate inputs and generate a samplesheet, params YAML, and launcher script for pacsomatic runs.

Community
Advanced
githubgithub
37.6k

meeting-minutes

Generate standardized meeting minutes with decisions and action items.

Official
Basic
DingTalk-Real-AIDingTalk-Real-AI
2.1k

dws-cli

Script DingTalk operations and batch-manage organizational data via CLI commands.

Official
Intermediate
iliaaliliaal
30

ia-linux-bash-scripting

Generate Linux Bash scripts compliant with ShellCheck and shfmt.

Community
Advanced