shellcheck-configuration
A guide to using ShellCheck for linting and enforcing best practices in shell scripts.
Install
mkdir -p .claude/skills/shellcheck-configuration && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/135" && unzip -o skill.zip -d .claude/skills/shellcheck-configuration && rm skill.zipInstalls to .claude/skills/shellcheck-configuration
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or ensuring script portability.Key capabilities
- →Integrate static analysis in CI/CD
- →Configure target shell environments
- →Define rule suppression criteria
- →Enable strict linting modes
- →Apply local pre-commit hooks
How it works
Wraps the ShellCheck engine to enforce specified linting rules and configuration profiles on shell scripts.
Inputs & outputs
When to use shellcheck-configuration
- →Setting up shell script linting for CI/CD
- →Fixing common shell script pitfalls
- →Configuring custom linting rules for different shells
About this skill
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
- Run ShellCheck in CI/CD - Catch issues before merging
- Configure for your target shell - Don't analyze bash as sh
- Document exclusions - Explain why violations are suppressed
- Address violations - Don't just disable warnings
- Enable strict mode - Use
--enable=allwith careful exclusions - Update regularly - Keep ShellCheck current for new checks
- Use pre-commit hooks - Catch issues locally before pushing
- Integrate with editors - Get real-time feedback during development
When not to use it
- →Analyzing non-shell code
- →Dynamic runtime script validation
Prerequisites
Limitations
- →Requires ShellCheck installation
- →False positives possible in complex scripts
How it compares
Provides a configured infrastructure for script quality rather than just running a manual check.
Compared to similar skills
shellcheck-configuration side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| shellcheck-configuration (this skill) | 9 | 2mo | No flags | Intermediate |
| wolf-scripts-core | 5 | 9mo | Review | Intermediate |
| final-release-review | 5 | 4mo | Review | Intermediate |
| fix | 5 | 6mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by wshobson
View all by wshobson →You might also like
wolf-scripts-core
Nice-Wolf-Studio
Core automation scripts for archetype selection, evidence validation, quality scoring, and safe bash execution
final-release-review
openai
Perform a release-readiness review by locating the previous release tag from remote tags and auditing the diff (e.g., v1.2.3...<commit>) for breaking changes, regressions, improvement opportunities, and risks before releasing openai-agents-python.
fix
Use when you have lint errors, formatting issues, or before committing code to ensure it passes CI.
verify
Use when you want to validate changes before committing, or when you need to check all React contribution requirements.
bash-defensive-patterns
wshobson
Master defensive Bash programming techniques for production-grade scripts. Use when writing robust shell scripts, CI/CD pipelines, or system utilities requiring fault tolerance and safety.
codex-review
davila7
Professional code review with auto CHANGELOG generation, integrated with Codex AI