shellcheck-configuration

Configure ShellCheck linting rules for Bash and sh scripts.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Jhabbig/Habbig --skill shellcheck-configuration-jhabbig
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shellcheck-configuration
Source: https://github.com/Jhabbig/Habbig/tree/main/.claude/plugins/wshobson/shell-scripting/skills/shellcheck-configuration
Command: npx skills add https://github.com/Jhabbig/Habbig --skill shellcheck-configuration-jhabbig

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you configure and use ShellCheck so shell scripts are checked for bugs, portability issues, and quoting mistakes before they reach production.

Core Features & Use Cases

  • Linting Setup: Define project-level ShellCheck settings for Bash, POSIX sh, and mixed shell codebases.
  • Error Triage: Understand common warning codes and decide whether to fix, suppress, or refactor.
  • Workflow Integration: Add ShellCheck to pre-commit hooks, editor tooling, and CI pipelines for continuous script quality checks.
  • Use Case: A team maintaining deployment scripts can apply this Skill to standardize lint rules, reduce shell regressions, and keep scripts portable across environments.

Quick Start

Ask the skill to set up ShellCheck for your shell project and recommend the right configuration, exclusions, and CI integration steps.

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 for a Bash and POSIX sh project?

To configure ShellCheck, define project-level settings that specify the target shell and select applicable linting rules. This setup catches quoting mistakes and portability issues across mixed Bash and POSIX sh codebases.

What's the best way to add shell script linting to a CI pipeline?

Adding shell script linting to a CI pipeline requires integrating ShellCheck to run continuous quality checks during builds. This automatically scans scripts for bugs and portability problems before they reach production.

How do I suppress ShellCheck false positives for specific warning codes?

Suppress ShellCheck false positives by configuring rule exclusions for specific warning codes in your project settings. This lets you triage errors and decide whether to fix, suppress, or refactor the flagged shell script.

Does ShellCheck work with pre-commit hooks for local development?

Yes, ShellCheck works with pre-commit hooks for local development by integrating into editor tooling and workflows. This catches shell script regressions locally before code is committed.

Why does ShellCheck report portability problems in my shell scripts?

ShellCheck reports portability problems when it detects syntax incompatible across different shell environments. Configuring the shell-target setting helps identify and resolve these cross-environment issues.