bash-review

Analyze bash scripts for security, error handling, quoting, and portability issues.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/bismuthdigital/claude-project-template --skill bash-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bash-review
Source: https://github.com/bismuthdigital/claude-project-template/tree/main/.claude/skills/bash-review
Command: npx skills add https://github.com/bismuthdigital/claude-project-template --skill bash-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires shellcheck, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps ensure bash scripts are secure, error-free, and follow best practices, reducing the risk of runtime failures and security vulnerabilities.

Core Features & Use Cases

  • Automated Script Analysis: Reviews bash scripts for common pitfalls, security issues, and portability concerns.
  • Shellcheck Integration: Leverages shellcheck for static analysis when available.
  • Manual Review Fallback: Provides guidance for manual analysis if shellcheck is not installed.
  • Use Case: Before deploying a new automation script, use this Skill to perform a thorough review, catching potential bugs and security flaws.

Quick Start

Use the bash-review skill to analyze all shell scripts in the current directory.

Frequently Asked Questions about bash-review

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

FAQPage Schema
How do I review bash scripts for security vulnerabilities and quoting issues?

You can review bash scripts for security vulnerabilities and quoting issues by running automated static analysis using shellcheck, which checks for common pitfalls, error handling, and portability concerns.

What is the best way to check shell scripts for portability and error handling?

The best way to check shell scripts for portability and error handling is to use an analysis tool that integrates static checking with manual review guidance, identifying potential runtime failures before deployment.

Can I analyze recent git changes to bash scripts instead of the whole file?

Yes, you can analyze recent git changes to bash scripts. The analysis tool supports reviewing specified files, recent changes via git, or all scripts in a directory to catch potential bugs.

Do I need shellcheck installed to perform a bash code review?

You do not strictly need shellcheck installed to perform a bash code review. If shellcheck is not available, the tool provides a manual analysis fallback to guide your review.

How does automated static analysis work for shell scripting?

Automated static analysis for shell scripting works by parsing the code without executing it, checking for syntax errors, security flaws, and portability issues using tools like shellcheck.

What are common limitations when using shellcheck for bash script analysis?

A limitation of using shellcheck for bash script analysis is that it may not catch all complex runtime-specific security vulnerabilities, which is why manual analysis guidance is also provided.