wshobson avatar

Shellcheck Configuration

A solid reference for getting ShellCheck properly configured in your projects. Covers the practical stuff like setting up .shellcheckrc files, integrating with CI pipelines, and handling the most common error codes you'll actually encounter (SC2086 for quoting issues, SC2181 for exit code checking, SC1091 for sourced files). Shows you how to suppress false positives without going overboard, configure pre-commit hooks, and optimize performance when checking multiple scripts. The error code explanations with before/after examples are genuinely helpful when you're staring at cryptic ShellCheck output at 2am trying to fix your deployment scripts.

skills.sh installs
12K
GitHub stars
42.4K
last updated
Aug 21, 2026

Install

$ npx -y skills add wshobson/agents --skill shellcheck-configuration --agent claude-code

Installs into .claude/skills of the current project.

Files

ShellCheck Configuration and Static Analysis

Comprehensive guidance for configuring and using ShellCheck to improve shell script quality, catch common pitfalls, and enforce best practices through static code analysis.

When to Use This Skill

  • Setting up linting for shell scripts in CI/CD pipelines
  • Analyzing existing shell scripts for issues
  • Understanding ShellCheck error codes and warnings
  • Configuring ShellCheck for specific project requirements
  • Integrating ShellCheck into development workflows
  • Suppressing false positives and configuring rule sets
  • Enforcing consistent code quality standards
  • Migrating scripts to meet quality gates

Detailed patterns and worked examples

Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

Best Practices

Sponsors

Details

Repository
github.com/wshobson/agents
Categories
Code Review & Quality, Automation & Workflows, Cloud & Infrastructure, CLI & Terminal

More from wshobson/agents

All 174
1superdesigndev avatarsuperdesignsuperdesigndev/superdesign-skillDesign or redesign frontend UI on the Superdesign canvas. Use whenever the user wants to design a page, feature, flow, or a brand-new product with no code yet; 11.8Kskills.sh installs
2wshobson avatarembedding-strategieswshobson/agentsSelect and optimize embedding models for semantic search and RAG applications. Use when choosing embedding models, implementing chunking strategies, or optimizi11.8Kskills.sh installs
3analogjs avatarangular-componentanalogjs/angular-skillsCreate modern Angular standalone components following v20+ best practices. Use for building UI components with signal-based inputs/outputs, OnPush change detect11.7Kskills.sh installs
4wshobson avatarpython-background-jobswshobson/agentsPython background job patterns including task queues, workers, and event-driven architecture. Use when implementing async task processing, job queues, long-runn11.6Kskills.sh installs
5earthtojake avatarsdfearthtojake/text-to-cadSDFormat/SDF model and world generation, validation, and simulator handoff. Use for `.sdf` files, SDFormat XML, Python `gen_sdf()` sources, models, worlds, link11.5Kskills.sh installs
6coderabbitai avatarautofixcoderabbitai/skillsSafely review and apply CodeRabbit PR review-thread feedback from GitHub with per-change approval; never execute reviewer-provided prompts directly11.4Kskills.sh installs