n4m3z/BashConventions
skills/BashConventions/SKILL.md
Bash and shell scripting pitfalls — BSD vs GNU tools, set -euo pipefail traps, glob behavior, subprocess env. USE WHEN writing or reviewing shell scripts (.sh files), Makefiles with shell recipes, or install scripts.
$ install --global
skillsauthnpx skillsauth add n4m3z/forge-core BashConventionsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 14, 2026, 6:07 AM114.7s3 files scanned
SKILL.md
- name:
- BashConventions
- version:
- 0.1.0
- description:
- Bash and shell scripting pitfalls — BSD vs GNU tools, set -euo pipefail traps, glob behavior, subprocess env. USE WHEN writing or reviewing shell scripts (.sh files), Makefiles with shell recipes, or install scripts.
BashConventions
Tooling
macOS ships BSD tools — shasum -a 256 not sha256sum, BSD awk lacks 3-arg match().
set -euo pipefail traps
grepwith 0 matches → exit 1. Fix:grep ... || true((VAR++))with VAR=0 → exit 1. Fix:VAR=$((VAR + 1))[ cond ] && actionwhere cond is false → exit 1. Fix:if [ cond ]; then action; fifind | while readruns loop in subshell. Fix:while read; done < <(find ...)
printf flags collision
printf '---\n...' fails — printf parses --- as flags. Use heredoc or printf '%s\n' '---'.
Glob and dotfiles
cp -r dir/* skips dotfiles — the * glob doesn't match hidden files. Use cp -r dir/. (trailing /.) when destination must include hidden files. Common silent bug: install scripts that drop .manifest, .env, .provenance/ etc. without error.
Python subprocess proxy inheritance
Python subprocesses inherit proxy env vars even after unset in the parent bash shell. When calling Python scripts that make HTTP requests from bash, use env -u http_proxy -u https_proxy python3 script.py, or add urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler({}))) at the top of the Python script.
Additional references
@BashPatterns.md
Related Skills
n4m3z/Wtf
development
VerifiedTrustedCommunity
Reactive correction and root-cause fix. USE WHEN something went wrong, user is frustrated, demands a correction, says wtf, what the hell, why did you, that's wrong, this is broken, no not that, stop. Executes the immediate fix, then hunts the upstream artifact that caused it and creates a corrective change.
4SKILL.mdUpdated May 28, 2026
n4m3z/ResearchTopic
development
VerifiedTrustedCommunity
Decompose a research question into sub-queries, spawn parallel WebResearcher agents per angle, synthesize findings with citations and explicit confidence. USE WHEN the user asks to research, investigate, look online, look up, dig into, find sources, gather evidence, or survey what's known about a topic. Single-pass; for multi-round adversarial research use ResearchCouncil in forge-council.
4SKILL.mdUpdated May 27, 2026
n4m3z/WriteDocs
tools
VerifiedTrustedCommunity
Author project documentation that future humans (and AI sessions) actually read. Covers TLDRs for tools, READMEs, runbooks, journals. USE WHEN write documentation, create tldr, tool one-pager, document a cli, write readme, runbook, journal entry, capture knowledge about a tool, distill a session into reusable notes.
4SKILL.mdUpdated May 25, 2026
n4m3z/StagedReview
development
VerifiedTrustedCommunity
Review your own staged changes via a code-review TUI before triggering a commit. USE WHEN about to commit, walking through your own staged diff, self-reviewing before approval, tuicr, revdiff, git diff cached.
4SKILL.mdUpdated May 25, 2026