Skip to content
Skills Library
Programming · Review & audit

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.

Licence
Apache-2.0
Last repository change
18.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
20
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 18.10.2026, without references to retired models or APIs.

Licence

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

  1. Input
  2. Output Specification
  3. Execution Scope
  4. Reference Files Guide
  5. Workflow
Original SKILL.md headings · 65 lines, 338 words
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.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.