shell-script-review
/shell-script-review
Review shell scripts for security, correctness, maintainability, and Bats suite pairing (TEST-00) with emphasis on operational safety. Use when reviewing shell script PRs requiring judgment beyond static checks, including whether paired Bats suites were added or updated per TEST-00.
- Author
- y-miyazaki ↗
- Repository
- terraform-aws-base ↗
- Licence
- Apache-2.0
- Last repository change
- 18.10.2026
Assessment and security
- Files in this package
- 20
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 18.10.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
Review shell scripts for security, correctness, maintainability, and Bats suite pairing (TEST-00) with emphasis on operational safety. Use when reviewing shell script PRs requiring judgment beyond static checks, including whether paired Bats suites were added or updated per TEST-00.
Original author description
Review shell scripts for security, correctness, maintainability, and Bats suite pairing (TEST-00) with emphasis on operational safety. Use when reviewing shell script PRs requiring judgment beyond static checks, including whether paired Bats suites were added or updated per TEST-00.
How it works
- Input
- Output Specification
- Execution Scope
- Reference Files Guide
- Workflow
SKILL.md preview
--- name: shell-script-review description: >- Review shell scripts for security, correctness, maintainability, and Bats suite pairing (TEST-00) with emphasis on operational safety. Use when reviewing shell script PRs requiring judgment beyond static checks, including whether paired Bats suites were added or updated per TEST-00. license: Apache-2.0 metadata: author: y-miyazaki version: "1.2.1" --- ## Input - Shell script files in PR (required) - Related Bats suites paired with changed scripts when present (recommended for TEST-00) - PR context: diff and commit messages (recommended) ## Output Specification Return structured Markdown in accordance with [references/common-output-format.md](references/common-output-format.md). That file is the source of truth for the output contract. ## Execution Scope - Systematically apply review checklist from [references/common-checklist.md](references/common-checklist.md) - Focus on checks requiring human/AI judgment (design, security, error handling patterns) - Do not modify script files or approve/merge PRs ### USE FOR: - review shell-script PRs for judgment beyond static checks - assess operational safety and script maintainability risks - review security-sensitive script changes requiring judgment - verify Bats suite pairing (TEST-00) against companion Bats rules (stem `bats`) ### DO NOT USE FOR: - execute `bash -n`, `shellcheck`, or validation scripts - perform auto-remediation in source files - review non-shell-only changes with no script impact ## Reference Files Guide - [common-checklist.md](references/common-checklist.md) (always read) - [common-output-format.md](references/common-output-format.md) (always read) - [common-troubleshooting.md](references/common-troubleshooting.md) (read on failure) - [category-global.md](references/category-global.md) (always read) - [category-security.md](references/category-security.md) (always read) - [category-error-handling.md](references/category-error-handling.md) (always read) - [category-anti-patterns.md](references/category-anti-patterns.md) (always read) - [category-code-standards.md](references/category-code-standards.md) (always read) - [category-dependencies.md](references/category-dependencies.md) (always read) - [category-documentation.md](references/category-documentation.md) (always read) - [category-function-design.md](references/category-function-design.md) (always read) - [category-logging.md](references/category-logging.md) (always read) - [category-testing.md](references/category-testing.md) (always read) ## Workflow 1. Read PR context and script intent. 2. Apply the full review checklist and collect failed/deferred ItemIDs. 3. Output required report sections per [references/common-output-format.md](references/common-output-format.md). Prioritize `SEC-*` findings first. Include file path, risk type, and concrete remediation for each issue. ### Error Handling | Condition | Severity | Action | | ------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------- | | `common-checklist.md` unavailable | Fatal | Stop, report missing dependency | | `common-output-format.md` unavailable | Recoverable | Note missing file; emit `## Checks Summary`, `## Checks (Failed/Deferred Only)`, and `## Issues` only | | PR contains only non-shell files | Recoverable | Report "no reviewable shell scripts" and stop | ### Examples - Prompt: `Review shell script changes for security and style` - Result: Structured report per [references/common-output-format.md](references/common-output-format.md); include TEST-00 pairing judgment when scripts change.
Files in this package (20)
- SKILL.md 4 KB
- eval.yaml 1 KB
- evals/tasks/shell-script-review-basic.yaml 1 KB
- evals/tasks/shell-script-review-boundary-guardrail.yaml 1 KB
- evals/tasks/shell-script-review-specific-check.yaml 1 KB
- evals/tasks/shell-script-review-structured-output.yaml 1 KB
- evals/tasks/shell-script-review-trigger-negative.yaml 1 KB
- references/category-anti-patterns.md 1 KB
- references/category-code-standards.md 1 KB
- references/category-dependencies.md 1 KB
- references/category-documentation.md 1 KB
- references/category-error-handling.md 2 KB
- references/category-function-design.md 1 KB
- references/category-global.md 1 KB
- references/category-logging.md 1 KB
- references/category-security.md 2 KB
- references/category-testing.md 1 KB
- references/common-checklist.md 2 KB
- references/common-output-format.md 4 KB
- references/common-troubleshooting.md 1 KB
Versions
The database has no other skills named shell-script-review.
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 732d4392204d (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100shell-script-validation
Validate shell scripts with bash -n and shellcheck for syntax safety and maintainability checks. Does not enforce Bats suite pairing (TEST-00) — companion stem `bats` covers pairing rules. Use when committing script changes, running CI validation, or debugging shellcheck findings in PRs. - 100shell-script-validation
Validate shell scripts with bash -n and shellcheck for syntax safety and maintainability checks. Does not enforce Bats suite pairing (TEST-00) — companion stem `bats` covers pairing rules. Use when committing script changes, running CI validation, or debugging shellcheck findings in PRs. - 100bats-testing-patterns
Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities. - 95bats-testing-patterns
Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities. - 100bats-testing-patterns
Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities. - 100bats-testing-patterns
Master Bash Automated Testing System (Bats) for comprehensive shell script testing. Use when writing tests for shell scripts, CI/CD pipelines, or requiring test-driven development of shell utilities.