clean-shell

Installation
SKILL.md

Clean Shell

Shell-specific conventions for writing, hardening, reviewing, and testing scripts. The core rules below always apply. Load the one reference file matching the task; don't load them all.

Task touches File
Scripts that run as root or mutate live systems: deploy/apply, firewall/sshd/sudoers edits, systemd oneshot+timer units, ssh remote-exec, rollback, cleanup traps, idempotency, parsing input a foreign process controls (/proc, argv, filenames), checking a path stays under a directory references/defensive.md
.shellcheckrc, # shellcheck disable= directives, severity floors, exit codes, CI gating references/shellcheck.md
Bats tests: .bats files, run, setup/teardown, PATH-stub mocking, parallel jobs references/bats.md

Core Rules

Installs
10
GitHub Stars
7
First Seen
Jul 19, 2026