A Bash script quality guide built around ShellCheck and shfmt. ShellCheck finds common shell-script mistakes, while shfmt formats shell code consistently.

Use it to lint and format Bash or POSIX shell scripts, understand ShellCheck warnings, exclude selected checks, and integrate checks with pre-commit hooks.

It helps detect unsafe or confusing shell code and keeps formatting consistent before scripts reach review or deployment.

bash-lint — Skill for Claude Code by Jamie-BitFlight/claude

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add Jamie-BitFlight/claude_skills --skill bash-lint

Clone the repo

git clone --depth 1 https://github.com/Jamie-BitFlight/claude_skills

Made for: Claude Code.

Or install bash-development, the plugin that ships this one along with the rest of its 8 skills, 2 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/jamie-bitflight/claude_skills/bash-lint/github.svg)](https://agentmods.dev/skills/jamie-bitflight/claude_skills/bash-lint)

Your own site

<a href="https://agentmods.dev/skills/jamie-bitflight/claude_skills/bash-lint"><img src="https://agentmods.dev/badge/skills/jamie-bitflight/claude_skills/bash-lint/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/jamie-bitflight/claude_skills/bash-lint"><img src="https://agentmods.dev/badge/skills/jamie-bitflight/claude_skills/bash-lint.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 60 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 2,106 The whole file, excluding the scripts and references it only reads on demand.

Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00060	$0.02106
Opus 5.5	$0.00024	$0.00842
Sonnet 5.5	$0.00012	$0.00421
Haiku 4.5	$0.00006	$0.00211

Measured 2mo ago against content hash 732219f5a9d1, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

bash-lint scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

rm -rf *

plugins/bash-development/skills/bash-lint/SKILL.md · 394 lines

How it starts

The opening of the file, as written. The whole thing — 394 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Bash Linting

Shellcheck and shfmt integration for bash script quality assurance.

Shellcheck

Installation

# Debian/Ubuntu
apt install shellcheck

# macOS
brew install shellcheck

# From source
cabal update && cabal install ShellCheck

Basic Usage

# Check single file
shellcheck script.sh

# Check multiple files
shellcheck *.sh

# With specific shell dialect
shellcheck --shell=bash script.sh
shellcheck --shell=sh script.sh

# Exclude specific rules
shellcheck --exclude=SC2086 script.sh
shellcheck --exclude=SC2086,SC2046 script.sh

# Output formats
shellcheck --format=gcc script.sh    # GCC-style
shellcheck --format=json script.sh   # JSON for tooling
shellcheck --format=diff script.sh   # Unified diff

Common Shellcheck Codes

Code	Issue	Fix
SC2086	Double quote to prevent globbing/splitting	`"$var"`
SC2046	Quote command substitution	`"$(cmd)"`
SC2006	Use `$()` instead of backticks	`$(cmd)`
SC2034	Variable appears unused	Remove or export
SC2155	Declare and assign separately	Split `local var; var=$(...)`
SC2164	Use `cd ... \|\| exit`	Handle cd failure
SC2181	Check exit status directly	`if cmd; then`
SC2129	Consider grouping writes	Use `{ } > file`
SC1090	Can't follow sourced file	Use `# shellcheck source=path`
SC2154	Variable referenced but not assigned	Initialize or declare

Shellcheck Directives

# Disable for next line
# shellcheck disable=SC2086
echo $unquoted_var

# Disable for entire file (at top)
# shellcheck disable=SC2086,SC2046

# Specify source file for sourcing
# shellcheck source=./lib/functions.sh
source "$SCRIPT_DIR/lib/functions.sh"

# Specify shell dialect
# shellcheck shell=bash

# Disable for block (not supported - use per-line)

Read the full file on GitHub · 394 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 394 lines · 60 tokens per session scan C 732219f5a9d1

Subscribe to this mod's changes

bash-lint is a skill published in the GitHub repository Jamie-BitFlight/claude_skills (67 stars, last pushed 19d ago), licensed MIT. It adds 60 tokens to every session and 2,106 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Debugging Languages

bash-lint next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
bash-lintJamie-BitFlight/claude_skills	Skill	67	19d ago	MIT	C	60	Claude Code
dotnet-reversezhaoxuya520/reverse-skill	Skill	44k	1mo ago	MIT	A	144	Claude Code
dart-run-static-analysisflutter/agent-plugins	Skill	3.2k	3d ago	BSD-3-Clause	A	43	Claude Code
agents-sdk-dotnet-debuggingmicrosoft/Agents	Skill	1.1k	yesterday	MIT	A	136	Claude Code
memory-optimizationbenchflow-ai/skillsbench	Skill	1.9k	4d ago	Apache-2.0	A	60	Claude Code, Codex
golang-error-handlingsamber/cc-skills-golang	Skill	3.8k	7d ago	MIT	A	144	Claude Code
prismer-python-debugpyPrismer-AI/PrismerCloud	Skill	1.4k	17d ago	MIT	A	19	Claude Code, Codex

bash-lint