skilld
All skills
wshobson avatar

/shellcheck-configuration

@be57c0b
by Seth Hobsonwshobson/agents40k stars
4,281

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

Ask your Agent

Use this Skill: https://skilld.dev/gh/wshobson/agents/shellcheck-configuration

This session only. Nothing lands on disk.

SKILL.md

≈51 tokens always: the name and description. ≈344 when used: this file. ≈2k more on demand in 1 file.

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

  1. Run ShellCheck in CI/CD - Catch issues before merging
  2. Configure for your target shell - Don't analyze bash as sh
  3. Document exclusions - Explain why violations are suppressed
  4. Address violations - Don't just disable warnings
  5. Enable strict mode - Use --enable=all with careful exclusions
  6. Update regularly - Keep ShellCheck current for new checks
  7. Use pre-commit hooks - Catch issues locally before pushing
  8. Integrate with editors - Get real-time feedback during development

Source: SKILL.md on GitHub

Third-party checks

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill provides comprehensive documentation and configuration examples for ShellCheck, a standard static analysis tool for shell scripts. It covers configuration files, CI/CD integration, and common error resolutions without introducing any security risks.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer6mo

    1/1 file flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at be57c0b. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 4 months ago

Topics

  • shellcheck
  • shell
  • bash
  • linting
  • static-analysis
  • ci-cd
  • code-quality
  • sh

README badge

README badge for wshobson/agents/shellcheck-configuration

What it does

Configures and integrates ShellCheck static analysis for shell script linting, covering error codes, rule suppression, CI/CD integration, and editor setup. Use when establishing shell script quality gates, analyzing existing scripts for issues, or enforcing portability standards across bash and sh targets.

Generated from the current SKILL.md.

Frequently asked

Does this skill cover ShellCheck configuration for specific shells like bash vs sh?
Yes. The skill includes guidance on configuring ShellCheck for your target shell and emphasizes not analyzing bash as sh.
Can I use this skill to suppress false positives in ShellCheck?
Yes. The skill covers suppressing false positives and configuring rule sets, including documentation of exclusions.
Does this skill help integrate ShellCheck into CI/CD pipelines?
Yes. The skill includes patterns for running ShellCheck in CI/CD, setting up linting infrastructure, and integrating with pre-commit hooks and editors.

Generated from the current SKILL.md. These answers refresh after source changes.