Menu
Validate shell scripts after editing. Apply when writing or modifying any shell script in local/bin/ or scripts/.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | shell-validate |
| description | Validate shell scripts after editing. Apply when writing or modifying any shell script in local/bin/ or scripts/. |
| user-invocable | false |
| allowed-tools | Bash, Read, Grep |
After editing any shell script in local/bin/, scripts/, or config/
(files with a #! shebang or # shellcheck shell= directive),
validate it:
/bin/sh or #!/usr/bin/env sh shebang -> POSIX, use sh -n/bin/bash or #!/usr/bin/env bash shebang -> Bash, use bash -n# shellcheck shell=bash directive (no shebang) -> use bash -n# shellcheck shell=sh directive (no shebang) -> use sh -nbash -nRun the appropriate syntax checker:
bash -n <file> # for bash scripts
sh -n <file> # for POSIX sh scripts
If syntax check fails, fix the issue before proceeding.
Run shellcheck <file>. The project .shellcheckrc already
disables SC2039, SC2166, SC2154, SC1091, SC2174, SC2016.
Only report and fix warnings that are NOT in that exclude list.
local/bin/fzf-tmux (vendor file)*.md files*.bats test files (Bats, not plain shell)Use for any question about a codebase, its architecture, file relationships, or project content — especially when graphify-out/ exists, where the question should be treated as a graphify query first. Turns any input (code, docs, papers, images, videos) into a persistent knowledge graph with god nodes, community detection, and query/path/explain tools.
Scaffold a new helper script in local/bin/ with proper boilerplate, msgr sourcing, and documentation tag.
Scaffold a bats test file in tests/<script>.bats matching a script in local/bin/<script>. Use when adding tests for an existing script that lacks coverage.
Scaffold a new theme handler in config/theme/handlers.d/<app>. Use when adding dark/light theme support for an app the orchestrator does not yet flip.
Validate fish scripts after editing. Apply when writing or modifying any .fish file in config/fish/.
Scaffold a new fish function in config/fish/functions/ with proper conventions and event handling.