Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor

shellcheck-configuration — Claude Code skill: use and install

This skill guides ShellCheck setup and use for shell script analysis. Use it when adding CI/CD linting, fixing warnings, or checking script portability.

Install into Claude Code · Plugin marketplace All methods and platforms ↓ 
/plugin marketplace add wshobson/agents
/plugin install shell-scripting@claude-code-workflows
Open on GitHub

What shellcheck-configuration does

shellcheck-configuration helps apply ShellCheck to shell scripts, find common issues, understand warning codes, and set rules for a project. It covers linting in CI/CD, pre-commit hooks, editors, and development workflows.

The skill explains how to select the target shell, document exclusions for false positives, and use --enable=all with careful exceptions. Detailed patterns and worked examples are available in references/details.md when the basic navigation is not enough.

Install it when a project contains shell scripts and needs explicit static-analysis rules. Before using it, decide which shell each script targets and record why any warning is suppressed.

What it helps with

  • add ShellCheck linting to CI/CD
  • interpret ShellCheck warning and error codes
  • configure rules for bash or sh scripts
  • document exclusions for false positives
  • connect script checks to pre-commit hooks or an editor

Example prompts for the agent

  • Run ShellCheck on the project’s shell scripts and group the warnings by type.
  • Configure ShellCheck for the target shell, then document the exclusions for false positives.
  • Add ShellCheck to CI/CD and enable `--enable=all` with carefully chosen exceptions.

How to install shellcheck-configuration

1Plugin marketplace

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

This installs the whole shell-scripting plugin with all its skills

2Skills CLI (Vercel)

npx skills add wshobson/agents --skill shellcheck-configuration -a claude-code

3Manually: put the files in place

~/.claude/skills/shellcheck-configuration/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/shellcheck-configuration/

From the same set213

The whole set →
typescript-advanced-types Seth Hobson Guides an agent through advanced TypeScript types, from generics to conditional and mapped types. Use it for typed libraries, API clients, or strict configuration objects. Claude Code CX Codex Cursor 92,169installs tailwind-design-system Seth Hobson Helps build design systems with Tailwind CSS v4, from theme tokens to component variants. Use it when a project needs shared UI patterns. Claude Code CX Codex Cursor 70,180installs brand-landingpage Travis D. Elliott This skill interviews you about the product and its visual direction, then builds a landing page through Stitch. Use it when there’s no established design yet. Claude Code CX Codex Cursor 39,476installs python-testing-patterns Seth Hobson This skill guides Python testing with pytest, fixtures and mocks. Use it when building a test suite or tracking down failing checks. Claude Code CX Codex Cursor 36,943installs python-performance-optimization Seth Hobson This skill profiles Python code to locate CPU and memory bottlenecks. Use it when an application responds slowly or consumes too many resources. Claude Code CX Codex Cursor 35,675installs nextjs-app-router-patterns Seth Hobson This skill covers Next.js App Router patterns for rendering, routing, and data fetching. Use it when starting an App Router project or moving from Pages Router. Claude Code CX Codex Cursor 32,529installs api-design-principles Seth Hobson Use this skill to plan or review REST and GraphQL APIs. It helps when writing a specification or setting API conventions for a team. Claude Code CX Codex Cursor 30,348installs code-review-excellence Seth Hobson This skill guides pull request reviews, catches logic and security issues, and helps teams give specific feedback. Use it for review standards or developer mentoring. Claude Code CX Codex Cursor 30,193installs

Similar

dependabot official github A GitHub Copilot skill that helps write and tune .github/dependabot.yml: grouped updates, monorepo patterns, security updates. GitHub Copilot 4,400installs google-cloud-scc-query official google Reads active Security Command Center findings in Google Cloud and helps an agent inspect them before triage. Claude Code Gemini CLI CX Codex 3,600installs gke-alert-configuration official google Writes and validates Terraform alerting policies for GKE: SLO latency and error rates, memory saturation, CrashLoopBackOff, Node NotReady. Claude Code Gemini CLI CX Codex 3,600installs wizard Matt Pocock This skill creates an interactive bash wizard for manual setup steps, CI secrets, third-party dashboards, and one-off migrations. Claude Code 553,369installs hyperframes-cli heygen-com Controls HyperFrames video workflows from the CLI: audits layouts and contrast, edits timeline clips, captures snapshots, and renders locally or in cloud runtimes. Claude Code CX Codex Cursor +1 1,200,000installs setup-pre-commit Matt Pocock This skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. Claude Code 489,289installs using-git-worktrees Jesse Vincent Prepares an isolated workspace before feature work or plan execution. It checks the repository first, then uses native worktree support or Git. Claude Code CX Codex 217,153installs finishing-a-development-branch Jesse Vincent This skill checks the test suite and guides branch completion: merge locally, open a Pull Request, or leave the work in place. Claude Code CX Codex 214,439installs

Questions about shellcheck-configuration

How do I install shellcheck-configuration in Claude Code?

Run npx skills add wshobson/agents --skill shellcheck-configuration -a claude-code. The skill file is placed at ~/.claude/skills/shellcheck-configuration/SKILL.md.

What does shellcheck-configuration do?

It guides ShellCheck setup, shell script analysis, and warning review. It also covers CI/CD, pre-commit hooks, editor integration, and project-specific rule sets.

How should ShellCheck be configured for a project?

Set the target shell first, because bash should not be analyzed as sh. Then choose the rule set, document exclusions, and use --enable=all with deliberate exceptions when appropriate.

Source text

SKILL.md · MIT 
---
name: shellcheck-configuration
description: Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or ensuring script portability.
---

# 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

© Ryan Snodgrass · MIT · wshobson/agents

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor