# 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.

- Skill: `majiayu000/shellck` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/shellck`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/shellck/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/shellck

---


# 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:

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

Run against specific files or directories:

```bash
$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.