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.