bash-check

Validate shell scripts for syntax errors and ShellCheck issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/cuozg/oh-my-unity --skill bash-check
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bash-check
Source: https://github.com/cuozg/oh-my-unity/tree/main/skills/bash-check
Command: npx skills add https://github.com/cuozg/oh-my-unity --skill bash-check

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Validate shell scripts by detecting syntax errors and ShellCheck issues, reducing runtime failures and security risks.

Core Features & Use Cases

  • Syntax validation: uses bash -n to catch parse errors and ShellCheck to surface stylistic and correctness warnings.
  • Quality guardrails: identifies unquoted variables, unsafe substitutions, and common bash pitfalls to improve script reliability.
  • Use Case: before committing or deploying a shell script, run this skill to produce a concise findings report with severity, location, and recommended fixes.

Quick Start

Validate a target shell script by running the bash-check workflow to produce a findings report.

Frequently Asked Questions about bash-check

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

FAQPage Schema
How do I check a bash script for syntax errors before committing?▼

To check a bash script for syntax errors, run the validation workflow to parse scripts with bash -n and analyze them with ShellCheck, generating a structured findings report with severity, location, and recommended fixes.

What does ShellCheck linting detect in shell scripts?▼

ShellCheck linting detects unquoted variables, unsafe substitutions, and common bash pitfalls in shell scripts. It surfaces stylistic and correctness warnings to reduce runtime failures and improve overall script reliability.

Can I use static analysis for shell scripts in a CI pipeline?▼

Static analysis for shell scripts is fully applicable in CI pipelines and pre-commit hooks. The validation process detects syntax errors and ShellCheck issues across projects to prevent deploying unsafe shell code.

How do I audit existing shell code for unquoted variables and unsafe substitutions?▼

To audit existing shell code for unquoted variables and unsafe substitutions, run the bash-check workflow. It analyzes target scripts and produces a concise findings report detailing quality guardrails and recommended fixes.

Do I need ShellCheck installed to validate bash scripts?▼

Validating bash scripts requires both bash -n and ShellCheck to analyze scripts. These dependencies are necessary to catch parse errors and surface the stylistic warnings and correctness issues included in the findings report.