PlugWiki

shellcheck-configuration Skill for Claude Code: Set Up ShellCheck

Teaches Claude to set up ShellCheck for your shell scripts, read its error codes, fix or suppress warnings and run it in CI or a pre-commit hook.

Installs
11.8K
on skills.sh
Stars
42.1K
on GitHub
Files
1
besides SKILL.md
Updated
Oct 2026
last repo commit

shellcheck-configuration gives Claude a working guide to ShellCheck, the static analyzer for shell scripts. It covers installing ShellCheck, a project .shellcheckrc, environment variables, common error codes in four ranges (SC1000, SC2000, SC2100 and SC3000), and fixes for frequent violations like unquoted variables. It also covers pre-commit hooks, GitHub Actions and GitLab CI, suppressing warnings with comments, and output formats.

The SKILL.md itself is a short summary. The detail is in references/details.md, which Claude reads when needed. The folder holds 2 Markdown files and no scripts.

Good for

  • Developers who write Bash or POSIX shell scripts
  • Teams adding shell linting to GitHub Actions or GitLab CI
  • Anyone facing a wall of ShellCheck warnings who wants them explained

Install shellcheck-configuration

Claude Code

  1. 1

    Copy this prompt.

    Install the shellcheck-configuration skill in Claude Code. Run this command:

/plugin marketplace add wshobson/agents
/plugin install shell-scripting@claude-code-workflows

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The shell-scripting plugin adds 2 more shell skills and 2 agents (bash-pro and posix-shell-pro). The skills-only route installs just this skill, without the plugin's agents or commands (README).

Built from the package data we hold. Not yet tested by us.

What's in the skill

When it loads

Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or ensuring script portability.

Sections in SKILL.md

  1. When to Use This Skill
  2. Detailed patterns and worked examples
  3. Best Practices

Key facts

Author
Ryan Snodgrass
Repo
wshobson/agents
License
MIT
Installs on skills.sh
11,784 (Nov 2, 2026)
GitHub stars
42,081 (Nov 2, 2026), whole repo
Last commit
Oct 30, 2026 (repo)
Files in the skill folder
2 files including SKILL.md
Part of
shell-scripting plugin: 2 agents, 3 skills
Works in
Claude Code and Codex plugins; skills-only installers for other tools

What it includes

  • Install steps for Homebrew, apt-get and from source.

    Runs system installs, so approve each command.

    Runs code · ShellCheck installation

  • A project .shellcheckrc and environment variables.

    Sets the target shell, optional checks and disabled warnings.

    Write · Configuration files

  • Explains SC1000, SC2000, SC2100 and SC3000 ranges.

    Parser errors, shell issues, quoting issues and POSIX compliance.

    Error code guide

  • Strict POSIX, Bash development and CI configurations.

    Example scripts for each.

    Practical configurations

  • A script for .git/hooks/pre-commit that lints staged .sh files.

    Writes a git hook into your repo if you ask for it.

    Write · Pre-commit hook

  • GitHub Actions and GitLab CI examples.

    The Actions job runs sudo apt-get install shellcheck.

    Write · CI templates

  • Inline disable comments and source directives.

    Best practice in the SKILL.md: document why a warning is suppressed.

    Suppressing warnings

  • Before and after examples for SC2086, SC2181, SC2015, SC2016 and SC2009.

    Unquoted variables, exit code checks and quoting.

    Common fixes

  • Parallel checks, a result cache, and default, gcc, json and quiet formats.

    The cache example creates a .shellcheck_cache folder.

    Write · Performance and output

From the official docs

Permissions

Low risk

The skill's examples install packages with brew and apt-get, build ShellCheck from source, and write a git pre-commit hook and a cache folder. Approve each command and review the hook before you commit it.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Install commands use brew, apt-get and sudo

    references/details.md lists brew install shellcheck, apt-get install shellcheck, a git clone with make build and make install, and a GitHub Actions step with sudo apt-get install. Run them only where you intend to. github.com

  • It can add a git pre-commit hook

    The hook example lints staged .sh files and blocks the commit on failure. Review it before enabling. github.com

  • The cache example writes files

    The caching script creates a .shellcheck_cache folder in the working directory. Add it to .gitignore. github.com

Technical details
Scopes

  • Local shell commands

  • Files the examples create: .shellcheckrc, .git/hooks/pre-commit, CI files, .shellcheck_cache

Questions

What does shellcheck-configuration do?

It teaches Claude how to set up and use ShellCheck: install it, write a .shellcheckrc, understand error codes, fix violations and add it to CI or a pre-commit hook.

How do I install it?

Use the install box above. The README offers the shell-scripting plugin, which adds 2 more skills and 2 agents, or a skills-only install of just this skill.

Does it install ShellCheck itself?

It documents install commands for Homebrew, apt-get and a source build, so Claude may run them if you ask for setup. The skill does not run them on its own.

Does it work in Claude.ai, Codex or Cursor?

The README documents Claude Code and Codex plugins and a Cursor plugin marketplace, plus skills-only installers for other tools. It does not describe the Claude app.

Is it safe?

The skill bundles no scripts, but its examples install packages with brew, apt-get and sudo, build ShellCheck from source, create a git hook and make a cache folder. Check each command before approving it.

shellcheck-configuration vs bash-defensive-patterns?

This skill is about configuring the linter. The shell-scripting plugin also contains bash-defensive-patterns for writing safer scripts, and this SKILL.md does not mention it.

Information

updated Nov 2, 2026

Repository
wshobson/agents
Folder
plugins/shell-scripting/skills/shellcheck-configuration

wshobson/agentsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4
  1. wshobson/agents README · github.com
  2. shellcheck-configuration SKILL.md · github.com
  3. shellcheck-configuration details.md · github.com
  4. shell-scripting plugin.json · github.com

Updated Nov 2, 2026.