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.