Agent skill

Writing Bash Scripts

by archibate in archibate/dotfiles-opencode

Create and refactor Bash scripts following conventions (strict mode, fct naming, quoting).

No licenceAuto-check passedDevelopment

Install Writing Bash Scripts

skills CLI
$ npx skills add archibate/dotfiles-opencode --skill writing-bash-scripts -a claude-code

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

GitHub CLI
$ gh skill install archibate/dotfiles-opencode writing-bash-scripts --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/archibate/dotfiles-opencode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/writing-bash-scripts .claude/skills/writing-bash-scripts && 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
writing-bash-scripts
GitHub stars
108
Used in
1 other repo
Token cost
~413 tokens
SKILL.md length
132 words
Files
5 (incl. scripts, references)
Skills in repo
34
Repo updated
First seen
Licence
None found

At a glance

Create and refactor Bash scripts following conventions (strict mode, fct naming, quoting).

  • Works in 5 steps: Copy… → Update the SCRIPT INFO / USAGE header… → Implement behavior in fct_execute_this,… → …
  • Creating shell scripts
  • SKILL.md covers Defaults and Workflow
  • Runs Shell scripts from its folder

What it does

Writing Bash Scripts is an agent skill from archibate/dotfiles-opencode. Create and refactor Bash scripts following conventions (strict mode, fct naming, quoting). Includes shellcheck linting. Use when creating shell scripts, refactoring existing scripts, debugging shell errors, or linting scripts.

Its SKILL.md is about 410 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/pref_bash.md`, `references/requirements.md` and `scripts/pref_bash_script_template.sh`).

It sits in Development, covering Shell scripting, Linting and formatting and Refactoring. It works with Bash. The repository describes itself as: Archibate's personal configuration for OpenCode.

When your agent uses it

  • Creating shell scripts
  • Refactoring existing scripts
  • Debugging shell errors
  • Linting scripts

Example prompts

  • “/writing-bash-scripts”

Requirements

  • A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Copy scripts/pref_bash_script_template.sh to the target path and rename it.
  2. Update the SCRIPT INFO / USAGE header blocks.
  3. Implement behavior in fct_execute_this, keep fct_main + trap structure.
  4. Follow the detailed conventions in references/pref_bash.md.
  5. Run shellcheck linting (see below).

What it can do on your machine

Read from SKILL.md and the folder at commit 46b6b23. 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

    Ships 2 files in scripts/ (Shell), which the agent can run.

    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

Writing Bash Scripts loads about 413 tokens when it runs, and up to ~4.3k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 132 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~413
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.3k

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 132 words (~413 tokens).

“Use this skill whenever the user asks to create/update/refactor a Bash script (.sh) or lint shell scripts.”

— opening of SKILL.md by archibate
name
writing-bash-scripts

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (scripts, references) in skills/writing-bash-scripts of archibate/dotfiles-opencode.

  • SKILL.md
  • references/pref_bash.md
  • references/requirements.md
  • scripts/pref_bash_script_template.sh
  • scripts/run_shellck.sh

Open the folder on GitHubat commit 46b6b23

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in archibate/dotfiles-opencode, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Writing Bash Scripts 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.

Writing Bash Scripts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Bash Scripts this skillarchibate/dotfiles-opencode1081 repos~413Automated safety check: PassNone
ShellCheck Configurationwshobson/agents40k11 repos~403Automated safety check: PassMIT
Linting Shell Scriptsagntcy/coffeeAgntcy112—~548Automated safety check: PassApache-2.0
Bash Script Validatorakin-ozer/cc-devops-skills319—~1.9kAutomated safety check: PassApache-2.0
Mole Bug Patternstw93/Mole70k—~2kAutomated safety check: PassGPL-3.0
Rust Best Practicesfarm-fe/farm5.6k3 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Master ShellCheck static analysis configuration and usage for shell script quality. Use when setting up linting infrastructure, fixing code issues, or…

    40k GitHub starsUsed in 11 repos~403 tokens
    DevelopmentAuto-check passed
  • Linting Shell Scripts

    agntcy/coffeeAgntcy

    Runs task shell:lint (shellcheck + shfmt) against every shell script in the repo and fixes what it reports.

    112 GitHub stars~548 tokensUpdated today
    DevelopmentAuto-check passed
  • Bash Script Validator

    akin-ozer/cc-devops-skills

    Validate, lint, audit, or fix bash/shell/.sh scripts via ShellCheck.

    319 GitHub stars~1.9k tokensUpdated 2 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.

    70k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook.

    5.6k GitHub starsUsed in 3 repos~1.1k tokens
    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 2 repos~1.2k tokens
    DevelopmentAuto-check passed

More from archibate/dotfiles-opencode

All 34 skills in this repo
  • Pueue

    archibate/dotfiles-opencode

    This skill should be used before running non-interactive long-running tasks, computation intensive tasks, background tasks, or needs guidance on the pueue CLI tool usage.

    108 GitHub starsUsed in 1 repo~637 tokens
    Auto-check passed
  • Show Image

    archibate/dotfiles-opencode

    Show images in terminal using the Kitty image protocol. An agent skill from archibate/dotfiles-opencode.

    108 GitHub starsUsed in 1 repo~596 tokens
    Auto-check passed
  • Glm Vision

    archibate/dotfiles-opencode

    This skill should be used when the user sends an image and asks to "analyze this image", "describe this picture", "what's in this image", or any request requiring visual understanding of images.

    108 GitHub stars~795 tokensUpdated 5 mo ago
    Auto-check passed
  • Show Image

    archibate/dotfiles-opencode

    Show images in terminal using the Kitty image protocol. An agent skill from archibate/dotfiles-opencode.

    108 GitHub starsUsed in 1 repo~622 tokens
    Auto-check passed
  • Tmux

    archibate/dotfiles-opencode

    Remote control tmux sessions for interactive CLIs (python, gdb, etc.) by sending keystrokes and scraping pane output.

    108 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Bilibili API

    archibate/dotfiles-opencode

    This skill should be used when the user asks to "use bilibili API", "download bilibili video", "get bilibili user info", "list bilibili favorites", "send bilibili danmaku", "upload video to…

    108 GitHub stars~2.1k tokensUpdated 5 mo ago
    Auto-check: warnings

Works with

Categories

Questions about Writing Bash Scripts

What does Writing Bash Scripts do?

Create and refactor Bash scripts following conventions (strict mode, fct naming, quoting). Writing Bash Scripts is an agent skill from archibate/dotfiles-opencode. Create and refactor Bash scripts following conventions (strict mode, fct naming, quoting).

When should I use Writing Bash Scripts?

Writing Bash Scripts fits situations like: creating shell scripts; refactoring existing scripts; debugging shell errors; linting scripts.

How do I install Writing Bash Scripts in Claude Code?

Run `npx skills add archibate/dotfiles-opencode --skill writing-bash-scripts -a claude-code`. Or copy the skill folder (skills/writing-bash-scripts in archibate/dotfiles-opencode) into .claude/skills/writing-bash-scripts in your project. Claude Code loads it when a task matches its description.

How do I install Writing Bash Scripts in Codex?

Run `npx skills add archibate/dotfiles-opencode --skill writing-bash-scripts -a codex`. Or copy the skill folder (skills/writing-bash-scripts in archibate/dotfiles-opencode) into .agents/skills/writing-bash-scripts in your project. Codex loads it when a task matches its description.

Can I use Writing Bash Scripts 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 archibate/dotfiles-opencode --skill writing-bash-scripts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-bash-scripts, .gemini/skills/writing-bash-scripts, .github/skills/writing-bash-scripts and .opencode/skills/writing-bash-scripts in your project.

What does Writing Bash Scripts need to run?

Going by SKILL.md and its folder, Writing Bash Scripts needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Writing Bash Scripts 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 Writing Bash Scripts 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Writing Bash Scripts use?

No licence was found for Writing Bash Scripts or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Writing Bash Scripts use?

About 413 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.9k tokens, read only when the agent opens those files.

What are the alternatives to Writing Bash Scripts?

Skills that share tags, products or a category with Writing Bash Scripts: ShellCheck Configuration (wshobson/agents, 40k stars), Linting Shell Scripts (agntcy/coffeeAgntcy, 112 stars), Bash Script Validator (akin-ozer/cc-devops-skills, 319 stars) and Mole Bug Patterns (tw93/Mole, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Bash Scripts?

archibate (a GitHub user) maintains it in archibate/dotfiles-opencode, which has 108 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on April 29, 2026.

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