What problem does it solve?
Many shell scripts contain portability bugs, quoting and word-splitting issues, and inconsistent linting rules that cause runtime failures or CI flakiness; this skill centralizes guidance for configuring ShellCheck to detect and remediate those problems across projects.
Core Features & Use Cases
- Static analysis guidance: Explains ShellCheck warnings, error codes, and practical fixes to improve script quality.
- Configuration examples: Shows .shellcheckrc settings, environment variables, and recommended rule sets for different shells.
- CI and workflow integration: Provides patterns for pre-commit hooks, GitHub Actions, GitLab pipelines, parallel checking, and caching strategies.
- Suppression and portability: Advises on suppressing false positives, using external sources, and writing POSIX-compatible scripts for broader compatibility.
- Output and automation: Covers GCC/JSON/quiet formats and approaches to integrate ShellCheck output into automated pipelines and reporting.
Quick Start
Run ShellCheck across your repository and fail the CI build if any lint issues are found.