shellck

The shellck skill provides a streamlined and repeatable method for running shellcheck on shell scripts within a repository. It is designed to assist developers in identifying and correcting common shell scripting errors, such as using unset variables with 'set -u', improper quoting, or incorrect subshell usage. By automating the linting process, shellck helps maintain consistent code quality and reduces the likelihood of runtime errors, especially in scripts that are frequently modified or critical to automated workflows.

This skill features a helper script that can be executed from the repository root. By default, it scans the 'scripts/' directory, but it also accepts specific files or directories as arguments. The tool intelligently filters targets based on file extensions or shebang lines to ensure only shell scripts are analyzed. It exits with a non-zero status when issues are detected, providing immediate feedback. The skill relies on the presence of shellcheck, making installation a prerequisite, but otherwise requires minimal configuration. The included runner script is designed with sensible defaults, allowing users to quickly incorporate it into their development workflow.

Shellck is ideal for developers and DevOps engineers who regularly write or maintain shell scripts and want to catch errors early. It is particularly useful in collaborative environments where multiple contributors edit scripts, as it enforces consistent best practices. Common use cases include verifying scripts after editing, performing pre-commit checks, debugging failing scripts, or integrating into CI/CD pipelines to automate quality checks. Its simplicity and focus on shell scripts make it a practical tool for anyone seeking to improve script reliability and maintainability.