shellcheck-configuration

Analyze shell scripts for portability and correctness issues using ShellCheck.

3|1|Updated Nov 5, 2025

Search Tags:#linting #configuration #shellcheck #static-analysis #ci-cd #portability #shell-script

Ready to run

npx skills add https://github.com/carlopezzuto/agents --skill shellcheck-configuration-carlopezzuto

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: shellcheck-configuration
Source: https://github.com/carlopezzuto/agents/tree/main/.claude/skills/shellcheck-configuration
Command: npx skills add https://github.com/carlopezzuto/agents --skill shellcheck-configuration-carlopezzuto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shell script quality can be brittle and error-prone without consistent analysis. This skill guides configuring and using ShellCheck to catch common mistakes, enforce portability, and improve reliability across projects.

Core Features & Use Cases

Installation and setup for ShellCheck on macOS, Linux, and CI environments.
Project-level configuration with .shellcheckrc and environment variables to tailor checks.
Comprehensive guidance on common errors (SC codes) and practical examples.
Integration patterns for CI workflows (GitHub Actions, GitLab CI) and pre-commit hooks.
Strategies for suppressing false positives and maintaining portable scripts.

Quick Start

Configure your repository to run ShellCheck on all shell scripts and start analyzing for issues.

Frequently Asked Questions about shellcheck-configuration

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

FAQPage Schema

How do I configure ShellCheck to enforce shell script quality in a CI pipeline?▼

Configure ShellCheck in CI pipelines by adding it to GitHub Actions or GitLab CI workflows to automatically analyze shell scripts, detecting portability and correctness issues during builds.

What is the best way to tailor static analysis checks for shell scripts in my repository?▼

Tailor static analysis for shell scripts by creating a project-level `.shellcheckrc` configuration file and setting optional environment variables to adjust checks and output formats.

Do I need to install ShellCheck locally to use pre-commit hooks for shell script linting?▼

Using ShellCheck pre-commit hooks requires installing the tool locally or in your development environment to analyze shell scripts and catch errors before committing code.

Why does ShellCheck report false positives on my shell scripts and how can I suppress them?▼

ShellCheck may report false positives due to specific script contexts; suppress these unwanted checks by applying specific SC code directives or adjusting your `.shellcheckrc` configuration.

Can I use ShellCheck to detect portability issues across different Unix environments?▼

Use ShellCheck to detect portability issues by analyzing shell scripts for compatibility problems, ensuring consistent behavior across different Unix environments like macOS and Linux.