ShellCheck Configuration
wshobson/agents
Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or…
Validate, lint, audit, or fix bash/shell/.sh scripts via ShellCheck.
$ npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install akin-ozer/cc-devops-skills bash-script-validator --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/akin-ozer/cc-devops-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/devops-skills-plugin/skills/bash-script-validator .claude/skills/bash-script-validator && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "bash-script-validator" agent skill from https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/bash-script-validator into .claude/skills/bash-script-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bash-script-validator", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/bash-script-validatorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install akin-ozer/cc-devops-skills bash-script-validator --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/akin-ozer/cc-devops-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/devops-skills-plugin/skills/bash-script-validator .agents/skills/bash-script-validator && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "bash-script-validator" agent skill from https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/bash-script-validator into .agents/skills/bash-script-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bash-script-validator", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install akin-ozer/cc-devops-skills bash-script-validator --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/akin-ozer/cc-devops-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/devops-skills-plugin/skills/bash-script-validator .cursor/skills/bash-script-validator && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "bash-script-validator" agent skill from https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/bash-script-validator into .cursor/skills/bash-script-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bash-script-validator", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/akin-ozer/cc-devops-skills.git --path devops-skills-plugin/skills/bash-script-validator--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install akin-ozer/cc-devops-skills bash-script-validator --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/akin-ozer/cc-devops-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/devops-skills-plugin/skills/bash-script-validator .gemini/skills/bash-script-validator && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "bash-script-validator" agent skill from https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/bash-script-validator into .gemini/skills/bash-script-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bash-script-validator", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install akin-ozer/cc-devops-skills bash-script-validatorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/akin-ozer/cc-devops-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/devops-skills-plugin/skills/bash-script-validator .github/skills/bash-script-validator && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "bash-script-validator" agent skill from https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/bash-script-validator into .github/skills/bash-script-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bash-script-validator", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install akin-ozer/cc-devops-skills bash-script-validator --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/akin-ozer/cc-devops-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/devops-skills-plugin/skills/bash-script-validator .opencode/skills/bash-script-validator && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "bash-script-validator" agent skill from https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/bash-script-validator into .opencode/skills/bash-script-validator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "bash-script-validator", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
bash-script-validatorValidate, lint, audit, or fix bash/shell/.sh scripts via ShellCheck.
Bash Script Validator is an agent skill from akin-ozer/cc-devops-skills. Validate, lint, audit, or fix bash/shell/.sh scripts via ShellCheck.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 19 other files, including scripts (for example `docs/awk-reference.md`, `docs/bash-reference.md` and `docs/common-mistakes.md`).
It sits in Development, covering Shell scripting and Linting and formatting. It works with Bash. The repository describes itself as: DevOps skills for Claude Code and Codex. The licence is Apache-2.0.
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 276af75. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 4 files in scripts/ (Shell), which the agent can run.
Shell commands in SKILL.md call:
bashshFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Bash Script Validator loads about 1.9k tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 825 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from akin-ozer/cc-devops-skills at commit 276af75, republished under its Apache-2.0 licence (© akin-ozer). 825 words, ~1,911 tokens.
.claude/skills/bash-script-validator/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.This skill validates Bash and POSIX shell scripts with layered checks:
bash -n or sh -n)Use the default flow below, then branch to fallbacks only when the environment is constrained.
Use this skill when the request includes script quality, linting, syntax checking, or shell portability work.
.sh file"Run commands from this skill directory:
cd devops-skills-plugin/skills/bash-script-validatorbash is available.bash scripts/validate.sh <script-path>For deterministic stage behavior, set the ShellCheck provider explicitly:
# Modes: auto (default), system, wrapper, disabled
VALIDATOR_SHELLCHECK_MODE=system bash scripts/validate.sh <script-path>Record:
0 clean, 1 warnings, 2 errors)SC####) when presentProgressive disclosure by issue type:
docs/shellcheck-reference.mddocs/common-mistakes.mddocs/bash-reference.mddocs/shell-reference.mddocs/grep-reference.md, docs/awk-reference.md, docs/sed-reference.md, docs/regex-reference.md (only when directly relevant)For each issue, include:
If the request includes patching files and write access is available, apply fixes in small batches grouped by issue type.
After each batch of edits, rerun the validator:
bash scripts/validate.sh <script-path>Rerun loop rules:
Use these branches only when the default flow cannot run as-is.
| Constraint | Fallback action | Reporting requirement |
|---|---|---|
shellcheck missing, wrapper available | Let scripts/validate.sh use scripts/shellcheck_wrapper.sh --cache automatically | State that wrapper mode was used |
shellcheck and wrapper unavailable | Run syntax + custom checks only (validator does this) | Explicitly call out reduced coverage and missing ShellCheck analysis |
| Python unavailable for wrapper | Skip wrapper path, keep syntax + custom checks | State why ShellCheck could not run |
| Target file is read-only | Provide precise patch suggestions without editing | Mark response as "advisory only" |
| Target file missing or unreadable | Stop and request a valid file path | Do not fabricate results |
| Binary/non-text input | Stop validation | Report unsupported input type |
Use subsection-level citations for every non-trivial fix.
Required citation format:
Reference: docs/<file>.md -> <Section> -> <Subsection>Examples:
Reference: docs/common-mistakes.md -> 1. Unquoted Variables -> SolutionReference: docs/shellcheck-reference.md -> SC2164: Use || exit After cdReference: docs/shell-reference.md -> POSIX Best Practices -> 5. Avoid BashismsCitation rules:
SC#### code and the matching section.Use this structure for deterministic output:
Validation ResultsCommand: bash scripts/validate.sh <script-path>Detected shell: <shell>Exit code: <code>Summary: <errors> errors, <warnings> warnings, <info> infoIssue: <short label> (Line <n>)Problem:<problematic snippet>Fix:<corrected snippet>Why: <short explanation>Reference: docs/<file>.md -> <Section> -> <Subsection>Rerun command: bash scripts/validate.sh <script-path>Exit code after fixes: <code>Remaining issues: <count or none># 1) Baseline validation
bash scripts/validate.sh examples/bad-bash.sh
# 2) Apply fixes to target script
# 3) Rerun validation
bash scripts/validate.sh examples/bad-bash.shExpected behavior: full syntax + ShellCheck + custom-check coverage, with iterative reruns until stable.
# Requires a system shellcheck binary.
bash scripts/run_ci_checks.shThis runner enforces VALIDATOR_REQUIRE_SHELLCHECK=1 and VALIDATOR_SHELLCHECK_MODE=system
so CI fails if the ShellCheck stage is skipped or unavailable.
# shellcheck unavailable and wrapper cannot run
bash scripts/validate.sh examples/bad-shell.shExpected behavior: syntax + custom checks still run. Report reduced coverage and list what must be revalidated once ShellCheck is available.
scripts/validate.sh: primary validator entrypointscripts/shellcheck_wrapper.sh: optional ShellCheck fallback using a cached Python virtual environmentValidation order in scripts/validate.sh:
0: no issues found1: warnings found2: errors foundLoad only what is needed:
docs/bash-reference.mddocs/shell-reference.mddocs/shellcheck-reference.mddocs/common-mistakes.mddocs/grep-reference.mddocs/awk-reference.mddocs/sed-reference.mddocs/regex-reference.mdThis skill update is complete when all are true:
© akin-ozer, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 16 other files (scripts) in devops-skills-plugin/skills/bash-script-validator of akin-ozer/cc-devops-skills.
Open the folder on GitHubat commit 276af75
Bash Script Validator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Bash Script Validator this skillakin-ozer/cc-devops-skills | 319 | — | ~1.9k | Automated safety check: Pass | Apache-2.0 | |
| ShellCheck Configurationwshobson/agents | 40k | 10 repos | ~403 | Automated safety check: Pass | MIT | |
| Writing Bash Scriptsarchibate/dotfiles-opencode | 107 | — | ~413 | Automated safety check: Pass | None | |
| Linting Shell Scriptsagntcy/coffeeAgntcy | 112 | — | ~548 | Automated safety check: Pass | Apache-2.0 | |
| Mole Bug Patternstw93/Mole | 69k | — | ~2k | Automated safety check: Pass | GPL-3.0 | |
| CLI DeveloperJeffallan/claude-skills | 12k | 1 repos | ~1.2k | Automated safety check: Pass | MIT |
wshobson/agents
Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or…
archibate/dotfiles-opencode
Create and refactor Bash scripts following conventions (strict mode, fct naming, quoting).
agntcy/coffeeAgntcy
Runs task shell:lint (shellcheck + shfmt) against every shell script in the repo and fixes what it reports.
tw93/Mole
A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.
Jeffallan/claude-skills
Walks through designing, building and polishing a command-line tool: user workflow and command hierarchy, implementation in commander, click, typer or cobra, completions and cross-platform testing.
charmbracelet/crush
Explains the jq command built into Crush for querying, filtering and reshaping JSON, including its supported flags and where it differs from standard jq.
akin-ozer/cc-devops-skills
Create, generate, or scaffold GitHub Actions workflows, action.yml, or .github/workflows CI/CD pipelines.
akin-ozer/cc-devops-skills
Create, scaffold, or generate Helm charts, Chart.yaml, values.yaml, templates, helpers.
akin-ozer/cc-devops-skills
Generate/create/scaffold Jenkinsfile — declarative, scripted, shared library, CI/CD pipelines.
akin-ozer/cc-devops-skills
Validate, lint, audit, or scan a Dockerfile for security and best practices.
akin-ozer/cc-devops-skills
Validate, lint, audit, fix GitHub Actions workflows (.github/workflows).
akin-ozer/cc-devops-skills
Validate, lint, audit, or check Jenkinsfiles and shared libraries.
Works with
Categories
Validate, lint, audit, or fix bash/shell/.sh scripts via ShellCheck. Bash Script Validator is an agent skill from akin-ozer/cc-devops-skills.sh scripts via ShellCheck.
Bash Script Validator fits situations like: tasks that involve Shell scripting; tasks that involve Linting and formatting.
Run `npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a claude-code`. Or copy the skill folder (devops-skills-plugin/skills/bash-script-validator in akin-ozer/cc-devops-skills) into .claude/skills/bash-script-validator in your project. Claude Code loads it when a task matches its description.
Run `npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a codex`. Or copy the skill folder (devops-skills-plugin/skills/bash-script-validator in akin-ozer/cc-devops-skills) into .agents/skills/bash-script-validator in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add akin-ozer/cc-devops-skills --skill bash-script-validator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bash-script-validator, .gemini/skills/bash-script-validator, .github/skills/bash-script-validator and .opencode/skills/bash-script-validator in your project.
Going by SKILL.md and its folder, Bash Script Validator needs a shell for the scripts in its folder and the command-line tools its instructions call (bash and sh). Our summary lists: Python 3; A Bash shell.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Bash Script Validator is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Bash Script Validator: ShellCheck Configuration (wshobson/agents, 40k stars), Writing Bash Scripts (archibate/dotfiles-opencode, 107 stars), Linting Shell Scripts (agntcy/coffeeAgntcy, 112 stars) and Mole Bug Patterns (tw93/Mole, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
akin-ozer (a GitHub user) maintains it in akin-ozer/cc-devops-skills, which has 319 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on July 26, 2026.
Source: akin-ozer/cc-devops-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.