review-shell-scripts

Audit .sh files with shellcheck and apply Bash Script Convention fixes.

Updated Jan 21, 2026
One-click install
npx skills add https://github.com/powdream/claude-plugins --skill review-shell-scripts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-shell-scripts
Source: https://github.com/powdream/claude-plugins/tree/main/.claude/skills/review-shell-scripts
Command: npx skills add https://github.com/powdream/claude-plugins --skill review-shell-scripts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps ensure all shell scripts in a repository comply with the Bash Script Convention by enabling automated auditing and fixes during development.

Core Features & Use Cases

  • Automated Script Audit: Scan all .sh files and verify they adhere to the Bash Script Convention.
  • ShellCheck Integration: Run shellcheck on each script and apply fixes or suggestions.
  • Parallel Review: Spawn multiple sub-agents to review scripts in parallel for faster feedback.
  • Library Script Exceptions: Library-like scripts (for example utils.sh) can have relaxed rules and are exempt from strict mode and main() requirements.

Quick Start

Run the skill at the repository root to locate all shell scripts, perform shellcheck checks, apply fixes, and generate a results report.

Frequently Asked Questions about review-shell-scripts

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

FAQPage Schema
How do I audit shell scripts in my repository for Bash convention compliance?

To audit shell scripts, run this skill at your repository root to automatically discover all .sh files, run shellcheck, and apply fixes to enforce Bash Script Convention compliance across your codebase.

Do I need shellcheck installed to run a Bash script convention audit?

Yes, you need a shell-enabled environment with shellcheck installed to execute the Bash script convention audit, run checks on each script, and apply automated fixes or suggestions to detected issues.

Can I exclude library shell scripts like utils.sh from strict mode and main() requirements?

Yes, library-like shell scripts such as utils.sh are exempt from strict mode and main() requirements, allowing them to have relaxed rules during the Bash convention audit while standard scripts remain fully enforced.

What is the best way to run shellcheck on multiple .sh files faster?

The best way to run shellcheck on multiple .sh files faster is using this skill's parallel review feature, which spawns multiple sub-agents to audit shell scripts concurrently for rapid feedback across your repository.

How does automated shell script code review handle convention violations?

Automated shell script code review handles convention violations by running shellcheck on each discovered .sh file, applying targeted fixes or suggestions to detected issues, and generating a comprehensive results report.

What types of shell scripts are supported by the Bash convention audit?

The Bash convention audit supports all standard .sh files found in a repository, while explicitly allowing library-like scripts to bypass strict mode rules and main() requirements through configured exceptions.