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.

주요 기능

01Reliable script path detection implementation patterns

02Automated detection of shell-specific array indexing conflicts

03Guidance on portable globbing and file searching techniques

04Cross-shell compatibility validation for Bash and Zsh environments

0537 GitHub stars

06Variable expansion and word-splitting safety checks

사용 사례

01Porting legacy Bash automation scripts to modern macOS environments using Zsh

02Standardizing shell scripting best practices across a distributed engineering team

03Ensuring CI/CD scripts run consistently across diverse containerized runners

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add synthesys-lab/agentize shell-script-review

For use in Claude.ai and ChatGPT

Download Skill