How can I force consistent array indexing in both shells?

By using the command '[ -n "$ZSH_VERSION" ] && setopt KSH_ARRAYS', you can force Zsh to use 0-based indexing, making it compatible with Bash logic.

What is the safest way to detect a script's own path?

Since BASH_SOURCE only works in Bash, this skill provides a logic snippet that checks for BASH_SOURCE, ZSH_VERSION (%x), and falls back to $0 for universal path detection.

Why do scripts behave differently in Bash versus Zsh?

Bash and Zsh differ in fundamental ways, including array indexing (0-based vs 1-based), word splitting on unquoted variables, and how they handle recursive globbing.

Why should I avoid using 'path' as a variable name?

In Zsh, the lowercase variable $path is an array tied directly to the system $PATH. Assigning a value to it can accidentally break your shell's ability to find commands.

Does this skill help with shell script linting?

Yes, it acts as a specialized reviewer that focuses specifically on portability and compatibility issues that generic linters might miss.

Shell Script Compatibility Review

Name: Shell Script Compatibility Review
Author: ayazhankadessova

byayazhankadessova

0•

Herramientas para Desarrolladores

Reviews and optimizes shell scripts to ensure consistent behavior and compatibility across Bash and Zsh environments.

This skill equips Claude with a specialized knowledge base for identifying and resolving syntax and behavioral discrepancies between Bash and Zsh. It enables the AI to audit shell scripts for common pitfalls such as array indexing differences, word splitting inconsistencies, and environment variable traps like the $path conflict. By applying standardized workarounds and portability best practices, this skill ensures that your automation scripts and CLI utilities run reliably across different operating systems and user configurations without modification.

Características Principales

01Word splitting and recursive globbing behavioral fixes

02Standardized array indexing alignment using KSH_ARRAYS

030 GitHub stars

04Cross-shell compatibility analysis for Bash and Zsh syntax

05Best practice enforcement for variable quoting and naming conventions

06Robust script-path detection for reliable self-location logic

Casos de Uso

01Refactoring shell utilities to eliminate environment variable name collisions and indexing bugs

02Writing portable CI/CD automation scripts that function across diverse runner environments

03Auditing legacy Bash scripts to ensure they work for modern macOS (Zsh) users

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ayazhankadessova/essential-skills shell-script-review

For use in Claude.ai and ChatGPT

Download Skill