mcpbeat

Shellck

instructa/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.

833 tokens
context cost
the whole folder, loaded on every use
3
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
131
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/instructa/agent-skills --skill shellck

What comes with it

2 127 bytes besides the instruction
README.md
scripts/run_shellck.sh

The instruction itself

7 sections, as written by the author

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.

How to use it

Copy the folder

Take instructa/shellck from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.