shell-script-review

Identify and fix cross-shell compatibility issues in Bash and Zsh scripts.

1|2|Updated Sep 17, 2025
One-click install
npx skills add https://github.com/MAdrid1011/Zircon-VLIW --skill shell-script-review-madrid1011
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shell-script-review
Source: https://github.com/MAdrid1011/Zircon-VLIW/tree/main/.claude/skills/shell-script-review
Command: npx skills add https://github.com/MAdrid1011/Zircon-VLIW --skill shell-script-review-madrid1011

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shell scripting across Bash and Zsh can diverge in array indexing, path detection, and word splitting, causing non-portable scripts.

Core Features & Use Cases

  • Shell-neutral guidance for arrays, path detection, argument parsing, and globbing.
  • Practical workarounds to write portable scripts that behave the same in Bash and Zsh.
  • Use Case: When maintaining a repository of shell scripts, you can run this skill to identify shell-specific patterns and receive portability improvements.

Quick Start

Review a given shell script and generate portable, shell-neutral recommendations compatible with Bash and Zsh.

Frequently Asked Questions about shell-script-review

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

FAQPage Schema
Why does my shell script behave differently in Bash and Zsh?▼

Shell scripts behave differently in Bash and Zsh due to divergences in array indexing, path detection, and word splitting. Reviewing your script for cross-shell compatibility identifies these non-portable patterns and provides concrete rules to ensure predictable behavior.

How do I write shell scripts that are compatible with both Bash and Zsh?▼

To write shell scripts compatible with both Bash and Zsh, apply shell-neutral guidance for array handling, argument parsing, and globbing. This involves identifying shell-specific patterns and implementing practical workarounds that guarantee predictable behavior across both environments.

What are common cross-shell compatibility issues in array handling and globbing?▼

Common cross-shell compatibility issues in array handling and globbing include divergent array indexing and word splitting behaviors between Bash and Zsh. Identifying these discrepancies allows you to apply portable, shell-neutral rules and workarounds for predictable script execution.

Can I review existing shell scripts for portability without rewriting them from scratch?▼

You can review existing shell scripts for portability without a full rewrite by analyzing typical scripting tasks like path detection and argument parsing. This process identifies shell-specific patterns and generates targeted, shell-neutral recommendations compatible with Bash and Zsh.

What is the best way to ensure predictable argument parsing across different shell environments?▼

The best way to ensure predictable argument parsing across different shell environments is to apply shell-neutral guidance. Reviewing your scripts identifies non-portable argument parsing patterns and provides practical workarounds to maintain consistent behavior in both Bash and Zsh.