# Review Shell Scripts

> Review all shell scripts against the Bash Script Convention. Use when you need to check script compliance or before committing changes.

- Skill: `powdream/review-shell-scripts` (Agent Skill)
- Install (CLI): `npx skillmds@latest add powdream/review-shell-scripts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/powdream/review-shell-scripts/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: powdream (https://skillmd.com/u/powdream)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/powdream/review-shell-scripts

---


# Review Shell Scripts

Review all shell scripts in the repository against the Bash Script Convention.

## Instructions

### Step 1: Find All Shell Scripts

Use `find` to locate all `.sh` files:

```bash
find . -name "*.sh" -type f
```

### Step 2: Run Shellcheck

For each script found, spawn a sub-agent to:

1. Run `shellcheck <script-path>`
2. Fix any issues found
3. Repeat shellcheck until no issues remain

### Step 3: Convention Review

Spawn sub-agents in parallel (2-3 scripts per agent) for convention review.

Follow the exact sub-agent prompt structure defined in AGENTS.md under "Bash
Script Review >> 2. Spawn a sub-agent". Fix any violations found.

### Step 4: Library Script Exceptions

Library scripts (like `utils.sh`) have different rules:

- No strict mode (`set -euo pipefail`) required
- No `main()` function required

### Step 5: Report Results

Report the final results summarizing:

- Number of scripts reviewed
- Issues found and fixed
- Any remaining issues that need manual attention

## Notes

- Reference: AGENTS.md "Bash Script Review" section
- The convention document (`doc/bash-script-convention.md`) takes precedence
  over the checklist above