Agent skill
bash-51-features
Bash 5.1 release features and improvements with practical examples. Use when working with Bash 5.1 features, epoch time variables, redirection enhancements, or when user asks about Bash 5.1 changes, new features, or version-specific capabilities.
Install this agent skill to your Project
npx add-skill https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/bash-development/skills/bash-51-features
SKILL.md
Bash 5.1 Features and Improvements
Released in December 2020, Bash 5.1 introduced several notable features and improvements for modern shell scripting.
New Shell Variables
EPOCHSECONDS and EPOCHREALTIME
Two new special variables for accessing current time:
# Get current Unix timestamp in seconds
echo "Current timestamp: ${EPOCHSECONDS}"
# Get current Unix timestamp with microsecond precision
echo "High precision timestamp: ${EPOCHREALTIME}"
# Practical example: Simple benchmarking
start="${EPOCHREALTIME}"
# ... some operation ...
sleep 0.5
end="${EPOCHREALTIME}"
duration=$(awk "BEGIN {print ${end} - ${start}}")
echo "Operation took ${duration} seconds"
# Example: Log with precise timestamps
log_message() {
printf '[%s.%06d] %s\n' \
"$(date -d "@${EPOCHSECONDS}" '+%Y-%m-%d %H:%M:%S')" \
"${EPOCHREALTIME#*.}" \
"$*"
}
log_message "Starting process"
Use cases:
- Precise performance measurement
- High-resolution timestamps for logging
- Avoiding external
datecommand calls - Microsecond-precision timing in scripts
SRANDOM Variable
Cryptographically strong random numbers:
# Generate secure random number (if available)
if [[ -n "${SRANDOM}" ]]; then
secure_random="${SRANDOM}"
echo "Secure random: ${secure_random}"
else
echo "SRANDOM not available (requires getrandom/getentropy)"
fi
# Practical example: Generate temporary file with secure random name
temp_file="/tmp/secure_${SRANDOM}_${EPOCHSECONDS}.tmp"
Note: SRANDOM requires system support for getrandom() or getentropy() syscalls.
Improved Redirection Syntax
{varname} Redirection
Assign file descriptor to variable for better file handle management:
# Open file descriptor and store in variable
exec {fd}< input.txt
while IFS= read -r -u "${fd}" line; do
echo "Read: ${line}"
done
exec {fd}<&- # Close the file descriptor
# Practical example: Multiple file handles
exec {input_fd}< data.txt
exec {output_fd}> results.txt
exec {error_fd}> errors.txt
process_data() {
while IFS= read -r -u "${input_fd}" line; do
if validate_line "${line}"; then
echo "Processed: ${line}" >&"${output_fd}"
else
echo "Error: ${line}" >&"${error_fd}"
fi
done
}
process_data
exec {input_fd}<&-
exec {output_fd}>&-
exec {error_fd}>&-
Benefits:
- Named file descriptors instead of magic numbers
- Automatic FD allocation avoids conflicts
- More readable and maintainable code
- Easier tracking of open file handles
Array Enhancements
Improved Associative Array Handling
Better support for complex array operations:
# Declare associative array with typeset
declare -A config=(
[host]="localhost"
[port]="8080"
[debug]="true"
)
# Enhanced array expansion
for key in "${!config[@]}"; do
printf '%s=%s\n' "${key}" "${config[${key}]}"
done
# Practical example: Configuration parser
parse_config() {
declare -gA app_config
local line key value
while IFS='=' read -r key value; do
[[ "${key}" =~ ^[[:space:]]*# ]] && continue # Skip comments
[[ -z "${key}" ]] && continue # Skip empty lines
# Trim whitespace
key="${key#"${key%%[![:space:]]*}"}"
key="${key%"${key##*[![:space:]]}"}"
value="${value#"${value%%[![:space:]]*}"}"
value="${value%"${value##*[![:space:]]}"}"
app_config["${key}"]="${value}"
done < config.ini
}
Multidimensional Array Support
Improved handling of nested array structures.
Code examples
Readline 8.1 Integration
Enhanced text editing and command-line interaction:
Key Bindings and History
# Configure readline in ~/.inputrc
# Enable case-insensitive completion
set completion-ignore-case on
# Enable visible stats for completions
set visible-stats on
# Show all completions immediately
set show-all-if-ambiguous on
# Use colors for completion matching
set colored-completion-prefix on
Improved History Search
# In your script or .bashrc
# Bind Ctrl+R for reverse incremental search (default, but enhanced in 5.1)
bind '"\C-r": reverse-search-history'
# Bind Ctrl+S for forward incremental search
bind '"\C-s": forward-search-history'
# Improved history handling
shopt -s histappend # Append to history
shopt -s cmdhist # Multi-line commands as one entry
HISTCONTROL=ignoreboth # Ignore duplicates and leading spaces
HISTSIZE=10000
HISTFILESIZE=20000
Signal Handling Improvements
Better signal propagation in subshells and process substitutions:
# Enhanced trap handling in subshells
cleanup() {
echo "Cleaning up..." >&2
rm -f "${temp_file}"
exit 130 # 128 + SIGINT
}
trap cleanup SIGINT SIGTERM
temp_file=$(mktemp)
# Signal properly propagates through pipelines
long_running_task | process_output &
pid=$!
# Wait for background job with proper signal handling
wait "${pid}" 2>/dev/null
exit_code=$?
if [[ ${exit_code} -gt 128 ]]; then
signal=$((exit_code - 128))
echo "Process terminated by signal ${signal}" >&2
fi
Bug Fixes and Edge Cases
Subshell Handling
Improved behavior when spawning subshells:
# More reliable subshell variable inheritance
outer_var="parent"
(
# Subshell now more reliably inherits parent variables
echo "In subshell: ${outer_var}"
inner_var="child"
)
# outer_var still accessible, inner_var is not
echo "After subshell: ${outer_var}"
Pattern Matching Edge Cases
Fixed edge cases in glob pattern matching:
# More reliable glob matching with special characters
shopt -s nullglob # Empty expansion for non-matching globs
shopt -s extglob # Extended pattern matching
# Example: Match files but handle no matches gracefully
files=(*.txt)
if [[ ${#files[@]} -eq 0 ]]; then
echo "No .txt files found"
else
printf 'Found: %s\n' "${files[@]}"
fi
Performance Improvements
- Faster variable expansion in loops
- Optimized array operations
- Reduced memory usage for large arrays
- Improved efficiency in pattern matching
Compatibility Notes
Upgrading from Bash 5.0
Most scripts are compatible, but note:
EPOCHSECONDSandEPOCHREALTIMEare new - check for existence if targeting older versionsSRANDOMmay not be available on all systems- Some obscure edge cases in expansion behavior were fixed
Version Check
# Check Bash version before using 5.1 features
if [[ "${BASH_VERSINFO[0]}" -ge 5 ]] && [[ "${BASH_VERSINFO[1]}" -ge 1 ]]; then
# Safe to use Bash 5.1 features
timestamp="${EPOCHSECONDS}"
else
# Fallback for older versions
timestamp=$(date +%s)
fi
References
- Bash NEWS file - Official release notes
- GNU Bash 5.1 Release - Source distribution
- Bash man page:
man bash(section on version-specific features)
Additional Resources
For broader Bash development patterns and best practices, see:
- ../bash-development/SKILL.md - Core Bash development patterns
- ../bash-portability/SKILL.md - Cross-version compatibility
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ccc
This skill should be used when code search is needed (whether explicitly requested or as part of completing a task), when indexing the codebase after changes, or when the user asks about ccc, cocoindex-code, or the codebase index. Trigger phrases include 'search the codebase', 'find code related to', 'update the index', 'ccc', 'cocoindex-code'.
agent-browser
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.
delegate
Quick delegation template for sub-agent prompts. Use when assigning work to a sub-agent, before invoking the Agent tool, or when preparing prompts for specialized agents. Provides the WHERE-WHAT-WHY framework. For comprehensive delegation guidance, activate the agent-orchestration how-to-delegate skill.
swarm-spawning
Spawn agents and teammates in Claude Code swarms. Use when choosing between subagents vs teammates, selecting agent types (Explore, Plan, general-purpose, plugin agents), configuring spawn backends (in-process, tmux, iterm2), or setting environment variables for spawned agents.
knowledge-explorer
Manage the research/ knowledge base (KB) of tool and library research entries. Use when browsing KB topics, adding new research entries, updating existing entries with dated revisions, fetching GitHub repo metadata into a draft KB entry, or migrating old-format entries to skill-spec frontmatter. Triggers on tasks like "what do we have on X", "add this to the KB", "update the KB entry for Y", "fetch github info for owner/repo", or "migrate old entries".
design-anti-patterns
Enforce anti-AI UI design rules based on the Uncodixfy methodology. Use when generating HTML, CSS, React, Vue, Svelte, or any frontend UI code. Prevents "Codex UI" — the generic AI aesthetic of soft gradients, floating panels, oversized rounded corners, glassmorphism, hero sections in dashboards, and decorative copy. Applies constraints from Linear/Raycast/Stripe/GitHub design philosophy: functional, honest, human-designed interfaces. Triggers on: UI generation, dashboard building, frontend component creation, CSS styling, landing page design, or any task producing visual interface code.
Didn't find tool you were looking for?