Agent skill
forge-lang-bash
Bash/Shell scripting standards including shellcheck, shfmt, and bats testing. Use when working with shell scripts (.sh, .bash).
Install this agent skill to your Project
npx add-skill https://github.com/martimramos/claude-forge/tree/main/skills/languages/bash
SKILL.md
Bash/Shell Development
Testing
# Run bats tests
bats test/
# Run specific test file
bats test/test_script.bats
# Run with TAP output
bats --tap test/
Static Analysis
# ShellCheck (lint)
shellcheck script.sh
# Check all scripts
shellcheck *.sh scripts/*.sh
# Exclude specific rules
shellcheck -e SC2086 script.sh
Formatting
# Format with shfmt
shfmt -w script.sh
# Check without changing
shfmt -d script.sh
# Format all scripts
shfmt -w -i 4 *.sh
Project Structure
project/
├── bin/
│ └── main.sh
├── lib/
│ ├── utils.sh
│ └── config.sh
├── test/
│ ├── test_main.bats
│ └── test_utils.bats
└── README.md
Script Template
#!/usr/bin/env bash
#
# script.sh - Brief description
#
# Usage: script.sh [options] <args>
#
set -euo pipefail
IFS=$'\n\t'
# Constants
readonly SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
readonly SCRIPT_NAME="$(basename "${BASH_SOURCE[0]}")"
# Functions
usage() {
cat <<EOF
Usage: ${SCRIPT_NAME} [options] <args>
Options:
-h, --help Show this help message
-v, --verbose Enable verbose output
EOF
}
main() {
# Parse arguments
while [[ $# -gt 0 ]]; do
case "$1" in
-h|--help)
usage
exit 0
;;
-v|--verbose)
set -x
shift
;;
*)
break
;;
esac
done
# Main logic here
echo "Hello from ${SCRIPT_NAME}"
}
main "$@"
Bats Test Template
#!/usr/bin/env bats
setup() {
# Setup code runs before each test
load 'test_helper/bats-support/load'
load 'test_helper/bats-assert/load'
}
@test "script runs without error" {
run ./bin/main.sh
assert_success
}
@test "script shows help with -h" {
run ./bin/main.sh -h
assert_success
assert_output --partial "Usage:"
}
@test "script fails on invalid option" {
run ./bin/main.sh --invalid
assert_failure
}
TDD Cycle Commands
# RED: Write test, run to see it fail
bats test/
# GREEN: Implement, run to see it pass
bats test/
# REFACTOR: Clean up, ensure tests still pass
shellcheck *.sh && shfmt -d *.sh && bats test/
Best Practices
- Always use
set -euo pipefailat the start - Quote all variables:
"$var"not$var - Use
[[instead of[for conditionals - Prefer
$(command)over backticks - Use
localfor function variables - Add
readonlyfor constants
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
martimramos/claude-forge
forge-lang-c
C development standards including make, gcc/clang, valgrind, and cppcheck. Use when working with C files, Makefiles, or CMakeLists.txt.
martimramos/claude-forge
forge-lang-terragrunt
Terragrunt wrapper for Terraform with DRY configurations. Enforces plan-before-apply workflow. Use when working with terragrunt.hcl files.
martimramos/claude-forge
forge-lang-cpp
C++ development standards including make/cmake, g++/clang++, and static analysis. Use when working with C++ files (.cpp, .hpp, .cc, .hh).
martimramos/claude-forge
forge-lang-rust
Rust development standards including cargo test, clippy, and rustfmt. Use when working with Rust files, Cargo.toml, or Rust tests.
martimramos/claude-forge
forge-lang-ansible
Ansible automation safety practices. Enforces check-mode-first workflow. Use when working with playbooks, roles, or inventory files.
martimramos/claude-forge
forge-lang-typescript
TypeScript development standards including type checking, jest/vitest, eslint, and prettier. Use when working with TypeScript files, tsconfig.json, or .ts/.tsx files.
Didn't find tool you were looking for?