Agent skill

Bash Scripting

by promovaweb in promovaweb/setupvibe

Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.

GPL-3.0Auto-check passedDevelopment

Install Bash Scripting

skills CLI
$ npx skills add promovaweb/setupvibe --skill bash-scripting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install promovaweb/setupvibe bash-scripting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/promovaweb/setupvibe.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/bash-scripting .claude/skills/bash-scripting && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bash-scripting
GitHub stars
101
Used in
4 other repos
Token cost
~1.2k tokens
SKILL.md length
396 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
GPL-3.0

At a glance

Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.

  • Works in 7 steps: Script Design → Script Structure → Core Implementation → …
  • Tasks that involve Shell scripting
  • SKILL.md covers Overview, Platform Notes, When to Use This Workflow and Workflow Phases, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bash Scripting is an agent skill from promovaweb/setupvibe. Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Shell scripting. It works with Bash and Linux. The repository describes itself as: O script definitivo de configuração de ambiente de desenvolvimento multiplataforma. The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Shell scripting

Example prompts

  • “/bash-scripting”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Script Design
  2. Script Structure
  3. Core Implementation
  4. Error Handling
  5. Logging
  6. Testing
  7. Documentation

What it can do on your machine

Read from SKILL.md and the folder at commit e86a16d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bash Scripting loads about 1.2k tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 396 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from promovaweb/setupvibe at commit e86a16d, republished under its GPL-3.0 licence (© promovaweb). 396 words, ~1,152 tokens.

Download SKILL.mdSave it as .claude/skills/bash-scripting/SKILL.md (or your agent's skills folder).
name
bash-scripting
description
Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.

Bash Scripting Workflow

Overview

Specialized workflow for creating robust, production-ready bash scripts with defensive programming patterns, comprehensive error handling, and automated testing.

Platform Notes

This is the Codex version of the skill.

  • Use rg for discovery and exec_command for shell validation.
  • Use apply_patch for manual script edits.
  • Use update_plan for multi-step script work.
  • Keep this skill functionally aligned with .claude/skills/bash-scripting.

When to Use This Workflow

Use this workflow when:

  • Creating automation scripts
  • Writing system administration tools
  • Building deployment scripts
  • Developing backup solutions
  • Creating CI/CD scripts

Workflow Phases

Phase 1: Script Design
Skills to Invoke
  • bash-pro - Professional scripting
  • bash-defensive-patterns - Defensive patterns
Actions
  1. Define script purpose
  2. Identify inputs/outputs
  3. Plan error handling
  4. Design logging strategy
  5. Document requirements
Copy-Paste Prompts
text
Use the `bash-pro` skill to design a production-ready Bash script.
Phase 2: Script Structure
Skills to Invoke
  • bash-pro - Script structure
  • bash-defensive-patterns - Safety patterns
Actions
  1. Add shebang and strict mode
  2. Create usage function
  3. Implement argument parsing
  4. Set up logging
  5. Add cleanup handlers
Copy-Paste Prompts
text
Use the `bash-defensive-patterns` skill to implement strict mode and error handling.
Phase 3: Core Implementation
Skills to Invoke
  • bash-linux - Linux commands
  • linux-shell-scripting - Shell scripting
Actions
  1. Implement main functions
  2. Add input validation
  3. Create helper functions
  4. Handle edge cases
  5. Add progress indicators
Copy-Paste Prompts
text
Use the `bash-linux` skill to implement system commands.
Phase 4: Error Handling
Skills to Invoke
  • bash-defensive-patterns - Error handling
  • error-handling-patterns - Error patterns
Actions
  1. Add trap handlers
  2. Implement retry logic
  3. Create error messages
  4. Set up exit codes
  5. Add rollback capability
Copy-Paste Prompts
text
Use the `bash-defensive-patterns` skill to add comprehensive error handling.
Phase 5: Logging
Show full SKILL.md (161 more words)Show less
Skills to Invoke
  • bash-pro - Logging patterns
Actions
  1. Create logging function
  2. Add log levels
  3. Implement timestamps
  4. Configure log rotation
  5. Add debug mode
Copy-Paste Prompts
text
Use the `bash-pro` skill to implement structured logging.
Phase 6: Testing
Skills to Invoke
  • bats-testing-patterns - Bats testing
  • shellcheck-configuration - ShellCheck
Actions
  1. Write Bats tests
  2. Run ShellCheck
  3. Test edge cases
  4. Verify error handling
  5. Test with different inputs
Copy-Paste Prompts
text
Use the relevant test skill or local test pattern to write script tests.
text
Use ShellCheck directly when available to lint Bash scripts.
Phase 7: Documentation
Skills to Invoke
  • documentation-templates - Documentation
Actions
  1. Add script header
  2. Document functions
  3. Create usage examples
  4. List dependencies
  5. Add troubleshooting section
Copy-Paste Prompts
text
Use the `documentation` skill to document Bash scripts.

Script Template

bash
#!/usr/bin/env bash
set -euo pipefail

readonly SCRIPT_NAME=$(basename "$0")
readonly SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)

log() { echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*"; }
error() { log "ERROR: $*" >&2; exit 1; }

usage() { cat <<EOF
Usage: $SCRIPT_NAME [OPTIONS]
Options:
    -h, --help      Show help
    -v, --verbose   Verbose output
EOF
}

main() {
    log "Script started"
    # Implementation
    log "Script completed"
}

main "$@"

Quality Gates

  • ShellCheck passes
  • Bats tests pass
  • Error handling works
  • Logging functional
  • Documentation complete
  • os-scripting - OS scripting
  • linux-troubleshooting - Linux troubleshooting
  • cloud-devops - DevOps automation

Regra Obrigatória — Markdown

Ao criar ou modificar qualquer arquivo .md, você DEVE invocar a skill /markdown-format antes de concluir a tarefa. As regras de formatação estão em MARKDOWN.md. Esta regra é inegociável e se aplica a qualquer skill, independente do seu escopo.

© promovaweb, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .codex/skills/bash-scripting of promovaweb/setupvibe.

Open the folder on GitHubat commit e86a16d

Used in 4 other repositories

We found 14 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 4 other GitHub owners. This page covers the copy in promovaweb/setupvibe, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Bash Scripting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bash Scripting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bash Scripting this skillpromovaweb/setupvibe1014 repos~1.2kAutomated safety check: PassGPL-3.0
Linux Shell Scriptingzebbern/claude-code-guide4.6k7 repos~3.1kAutomated safety check: NotesMIT
Os Scriptingaiskillstore/marketplace4303 repos~2.2kAutomated safety check: NotesNone
Shellpproenca/dot-skills214—~1.9kAutomated safety check: PassMIT
Mole Bug Patternstw93/Mole69k—~2kAutomated safety check: PassGPL-3.0
CLI DeveloperJeffallan/claude-skills12k1 repos~1.2kAutomated safety check: PassMIT

Similar skills

  • Linux Shell Scripting

    zebbern/claude-code-guide

    This skill should be used when the user asks to "create bash scripts", "automate Linux tasks", "monitor system resources", "backup files", "manage users", or "write production shell scripts".

    4.6k GitHub starsUsed in 7 repos~3.1k tokens
    DevelopmentAuto-check: notes
  • Os Scripting

    aiskillstore/marketplace

    Operating system and shell scripting troubleshooting workflow for Linux, macOS, and Windows.

    430 GitHub starsUsed in 3 repos~2.2k tokens
    DevelopmentAuto-check: notes
  • Shell

    pproenca/dot-skills

    Shell scripting best practices for writing safe, portable, and maintainable bash/sh scripts.

    214 GitHub stars~1.9k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    69k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • CLI Developer

    Jeffallan/claude-skills

    Walks through designing, building and polishing a command-line tool: user workflow and command hierarchy, implementation in commander, click, typer or cobra, completions and cross-platform testing.

    12k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • JSON Processing with jq

    charmbracelet/crush

    Explains the jq command built into Crush for querying, filtering and reshaping JSON, including its supported flags and where it differs from standard jq.

    29k GitHub stars~746 tokensUpdated today
    DevelopmentAuto-check passed

More from promovaweb/setupvibe

All 8 skills in this repo
  • Bash Defensive Patterns

    promovaweb/setupvibe

    Master defensive Bash programming techniques for production-grade scripts.

    101 GitHub starsUsed in 13 repos~572 tokens
    Auto-check passed
  • Bash Pro

    promovaweb/setupvibe

    Master of defensive Bash scripting for production automation, CI/CD pipelines, and system utilities.

    101 GitHub starsUsed in 9 repos~4.7k tokens
    Auto-check passed
  • Markdown Format

    promovaweb/setupvibe

    Enforce and apply SetupVibe Markdown formatting standards when creating or editing any .md file in the repository.

    101 GitHub stars~938 tokensUpdated 1 mo ago
    Auto-check passed
  • Documentation

    promovaweb/setupvibe

    Workflow mestre para gestão de documentação do SetupVibe. An agent skill from promovaweb/setupvibe.

    101 GitHub stars~477 tokensUpdated 1 mo ago
    Auto-check passed
  • Documentation

    promovaweb/setupvibe

    Workflow mestre para gestão de documentação do SetupVibe. An agent skill from promovaweb/setupvibe.

    101 GitHub stars~489 tokensUpdated 1 mo ago
    Auto-check passed
  • Make Changelog

    promovaweb/setupvibe

    Gerencia entradas no CHANGELOG.md seguindo Keep a Changelog.

    101 GitHub stars~470 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Bash Scripting

What does Bash Scripting do?

Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing. Bash Scripting is an agent skill from promovaweb/setupvibe. Bash scripting workflow for creating production-ready shell scripts with defensive patterns, error handling, and testing.

When should I use Bash Scripting?

Bash Scripting fits situations like: tasks that involve Shell scripting.

How do I install Bash Scripting in Claude Code?

Run `npx skills add promovaweb/setupvibe --skill bash-scripting -a claude-code`. Or copy the skill folder (.codex/skills/bash-scripting in promovaweb/setupvibe) into .claude/skills/bash-scripting in your project. Claude Code loads it when a task matches its description.

How do I install Bash Scripting in Codex?

Run `npx skills add promovaweb/setupvibe --skill bash-scripting -a codex`. Or copy the skill folder (.codex/skills/bash-scripting in promovaweb/setupvibe) into .agents/skills/bash-scripting in your project. Codex loads it when a task matches its description.

Can I use Bash Scripting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add promovaweb/setupvibe --skill bash-scripting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bash-scripting, .gemini/skills/bash-scripting, .github/skills/bash-scripting and .opencode/skills/bash-scripting in your project.

What does Bash Scripting need to run?

SKILL.md names no scripts, command-line tools or credentials: Bash Scripting is instructions for the agent only.

Does Bash Scripting access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bash Scripting safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bash Scripting use?

Bash Scripting is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bash Scripting use?

About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bash Scripting?

Skills that share tags, products or a category with Bash Scripting: Linux Shell Scripting (zebbern/claude-code-guide, 4.6k stars), Os Scripting (aiskillstore/marketplace, 430 stars), Shell (pproenca/dot-skills, 214 stars) and Mole Bug Patterns (tw93/Mole, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bash Scripting?

promovaweb (a GitHub organization) maintains it in promovaweb/setupvibe, which has 101 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 21, 2026.

Source: promovaweb/setupvibe on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.