Why is shell-neutrality important for scripts?

Many production environments use Bash as the default shell, while modern developer environments like macOS use Zsh. Shell-neutral scripts ensure your automation works everywhere without manual intervention.

What is the danger of using the 'path' variable in Zsh?

In Zsh, the lowercase $path variable is an array tied to the $PATH environment variable. This skill flags its use to prevent accidental corruption of the system path.

How does this skill handle array indexing differences?

It suggests shell-neutral workarounds like using 'setopt KSH_ARRAYS' in Zsh or utilizing array traversal methods that work identically in both shells.

Can it help with script path detection?

Yes, it provides a reliable template to accurately detect a script's directory whether it is being executed directly or sourced, accounting for $BASH_SOURCE and Zsh-specific syntax.

Does it recommend specific shebangs?

The skill generally recommends using #!/bin/bash for better portability and provides configurations to ensure compatibility if the script is run in a Zsh context.

Shell Script Portability Review

Name: Shell Script Portability Review
Author: Synthesys-Lab

bySynthesys-Lab

•

デプロイメントとDevOps

Reviews and optimizes shell scripts to ensure cross-shell compatibility and consistent behavior between Bash and Zsh.

概要

The Shell Script Review skill helps developers create robust, shell-neutral scripts that function predictably across different operating systems and shell environments. By identifying common pitfalls such as array indexing discrepancies (0-based vs. 1-based), variable expansion differences, and inconsistent script path detection, this skill ensures that automation tools work seamlessly on both Linux (typically Bash) and macOS (typically Zsh). It provides actionable workarounds and implementation patterns to reduce environment-specific bugs in CI/CD pipelines and local development workflows.

主な機能

Reliable script path detection implementation patterns
Automated detection of shell-specific array indexing conflicts
Guidance on portable globbing and file searching techniques
Cross-shell compatibility validation for Bash and Zsh environments
37 GitHub stars
Variable expansion and word-splitting safety checks

ユースケース

Porting legacy Bash automation scripts to modern macOS environments using Zsh
Standardizing shell scripting best practices across a distributed engineering team
Ensuring CI/CD scripts run consistently across diverse containerized runners

概要

主な機能

Reliable script path detection implementation patterns
Automated detection of shell-specific array indexing conflicts
Guidance on portable globbing and file searching techniques
Cross-shell compatibility validation for Bash and Zsh environments
37 GitHub stars
Variable expansion and word-splitting safety checks

ユースケース

Porting legacy Bash automation scripts to modern macOS environments using Zsh
Standardizing shell scripting best practices across a distributed engineering team
Ensuring CI/CD scripts run consistently across diverse containerized runners