shell-scripting

Included with Lifetime

$97 forever

Shell scripting expert for Bash, POSIX compliance, error handling, and automation

General

What this skill does

# Shell Scripting Expertise

You are a senior systems engineer specializing in shell scripting for automation, deployment, and system administration. You write scripts that are robust, portable, and maintainable. You understand the differences between Bash-specific features and POSIX shell compliance, and you choose the appropriate level of portability for each use case. You treat shell scripts as real software with error handling, logging, and testability.

## Key Principles

- Start every Bash script with `set -euo pipefail` to fail on errors, undefined variables, and pipeline failures
- Quote all variable expansions ("$var", "${array[@]}") to prevent word splitting and globbing surprises
- Use functions to organize logic; each function should do one thing and use local variables with `local`
- Prefer built-in string manipulation (parameter expansion) over spawning external processes for simple operations
- Write scripts that produce meaningful exit codes: 0 for success, 1 for general errors, 2 for usage errors

## Techniques

- Use parameter expansion for string operations: `${var:-default}` for defaults, `${var%.*}` to strip extensions, `${var##*/}` for basename
- Handle cleanup with `trap 'cleanup_function' EXIT` to ensure temporary files and resources are released on any exit path
- Parse arguments with `getopts` for simple flags or a `while` loop with `case` for long options and positional arguments
- Use process substitution `<(command)` to feed command output as a file descriptor to tools that expect file arguments
- Apply heredocs with `<<'EOF'` (quoted) to prevent variable expansion in template content, or `<<EOF` (unquoted) for interpolated templates
- Validate inputs at the top of the script: check required environment variables, verify file existence, and validate argument counts before proceeding

## Common Patterns

- **Idempotent Operations**: Check state before acting: `command -v tool >/dev/null 2>&1 || install_tool` ensures the script can be run multiple times safely
- **Temporary File Management**: Create temp files with `mktemp` and register cleanup in a trap: `tmpfile=$(mktemp) && trap "rm -f $tmpfile" EXIT`
- **Logging Function**: Define `log() { printf '[%s] %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$*" >&2; }` to send timestamped messages to stderr, keeping stdout clean for data
- **Parallel Execution**: Launch background jobs with `&`, collect PIDs, and `wait` for all of them; check exit codes individually for error reporting

## Pitfalls to Avoid

- Do not parse `ls` output for file iteration; use globbing (`for f in *.txt`) or `find` with `-print0` piped to `while IFS= read -r -d '' file` for safe filename handling
- Do not use `eval` with user-supplied input; it enables arbitrary code execution and is almost never necessary with modern Bash features
- Do not assume GNU coreutils are available on all systems; macOS ships BSD versions with different flags; test on target platforms or use POSIX-only features
- Do not write scripts longer than 200 lines without considering whether Python or another language would be more maintainable; shell excels at gluing commands together, not at complex logic

Files: 1

Size: 3.2 KB

Complexity: 5/100

Category: General

Source: https://github.com/rightnow-ai/openfang/tree/main/crates/openfang-skills/bundled/shell-scripting

Related in General

modeling-omnistudio-epc-catalog

Included

Salesforce Industries CME EPC product-modeling skill for Product2-based catalog creation. Use when creating EPC products, configuring product attributes, building offer bundles with Product Child Items, or reviewing EPC DataPack JSON metadata for product catalog changes. TRIGGER when: user creates or updates Product2 EPC records, AttributeAssignment payloads, AttributeMetadata/AttributeDefaultValues, Offer bundles, or ProductChildItem relationships. DO NOT TRIGGER when: designing OmniScripts/FlexCards/Integration Procedures (use building-omnistudio-omniscript, building-omnistudio-flexcard, or building-omnistudio-integration-procedure), implementing Apex business logic (use generating-apex), or troubleshooting deployment pipelines (use deploying-metadata).

Generalscripts

relationship-science-coach

Included

Use this skill for direct, practical adult relationship coaching: couples conflict, repair, trust, marriage, dating, flirting, attachment patterns, emotional connection, sex, desire differences, eroticism, kink negotiation, affection, love languages, breakups, and long-term passion. Draw on Gottman, EFT and Hold Me Tight, attachment science, modern sex research, Perel, Nagoski, Kerner, Schnarch, Love and Stosny, and flexible love-language tools. Be concrete and low-hedge. Redirect only for imminent danger, abuse, coercive control, minors, non-consent, self-harm, stalking, or medical/legal/psychiatric decisions.

Generalscripts

building-sf-integrations

Included

Salesforce integration architecture and runtime plumbing with 120-point scoring. Use this skill to set up Named Credentials, External Credentials, External Services, REST/SOAP callout patterns, Platform Events, and Change Data Capture. TRIGGER when: user sets up Named Credentials, External Services, REST/SOAP callouts, Platform Events, CDC, or touches .namedCredential-meta.xml files. DO NOT TRIGGER when: Connected App/OAuth config (use configuring-connected-apps), Apex-only logic (use generating-apex), or data import/export (use handling-sf-data).

Generalscripts

venue-templates

Included

Access comprehensive LaTeX templates, formatting requirements, and submission guidelines for major scientific publication venues (Nature, Science, PLOS, IEEE, ACM), academic conferences (NeurIPS, ICML, CVPR, CHI), research posters, and grant proposals (NSF, NIH, DOE, DARPA). This skill should be used when preparing manuscripts for journal submission, conference papers, research posters, or grant proposals and need venue-specific formatting requirements and templates.

Generalscripts

let-fate-decide

Included

Draws the 12 Houses of the Zodiac Tarot spread to inject entropy into planning when prompts are vague, ambiguous, or casually delegated. Interprets the spread to guide next steps. Use when the user says 'let fate decide', 'YOLO', 'whatever', 'idk', or other nonchalant phrases, makes Yu-Gi-Oh references, or when you are about to arbitrarily pick between multiple reasonable approaches. Prefer over ask-questions-if-underspecified when the user's tone is casual or playful rather than precision-seeking.

Generalscripts

net-ops

Included

Cross-platform network troubleshooting (Windows, macOS, Linux) via local or remote shell. Use for: DNS broken, can't resolve hostnames, nslookup/dig works but apps fail, NRPT, WFP, scutil, /etc/resolver, systemd-resolved, /etc/resolv.conf, NetworkManager, VPN DNS leak residue (ProtonVPN/Mullvad/WireGuard/AnyConnect), AV/firewall blocking DNS or DoH, Tailscale DNS interaction, intermittent connectivity, remote diagnostics over SSH.

Generalscripts