Agent-Skills.md

Agent Skills: Shellck

Run shellcheck on shell scripts after editing scripts or when debugging shell errors. Use for linting scripts in a repo (especially scripts/), catching issues like set -u with unset vars, bad subshell usage, or quoting mistakes.

UncategorizedID: regenrek/agent-skills/shellck

Repository

regenrek/agent-skills
regenrek
21

Skill Files

Browse the full folder contents for shellck.

Download Skill

Loading file tree…

skills/shellck/SKILL.md

Skill Metadata

Name
shellck
Description
Run shellcheck on shell scripts after editing scripts or when debugging shell errors. Use for linting scripts in a repo (especially scripts/), catching issues like set -u with unset vars, bad subshell usage, or quoting mistakes.

Shellck

Overview

Provide a fast, repeatable shellcheck pass for repo scripts. Use this skill after editing shell scripts or when a script fails unexpectedly.

Workflow

  1. Ensure shellcheck is installed.
  2. From the repo root, run the helper script.

Quick start

Run against the default scripts/ directory:

$CODEX_HOME/skills/shellck/scripts/run_shellck.sh

Run against specific files or directories:

$CODEX_HOME/skills/shellck/scripts/run_shellck.sh scripts/perf-profiler
$CODEX_HOME/skills/shellck/scripts/run_shellck.sh scripts/ other/dir/some.sh

Behavior

  • If no paths are provided, it scans scripts/ for shell scripts.
  • If paths are provided, it accepts files or directories and filters to shell scripts by extension or shebang.
  • Exits non-zero on shellcheck failures.

Resources

scripts/

  • run_shellck.sh: shellcheck runner with sensible defaults and directory filtering.