Agent Skills › instructa/agent-skills › shellck

shellck

GitHub

用于在编辑或调试Shell脚本后运行shellcheck进行静态分析，自动检测语法错误、未定义变量及引用问题，提升脚本质量。

skills/shell/shellck/SKILL.md instructa/agent-skills

Trigger Scenarios

编辑Shell脚本后调试Shell脚本错误时需要对脚本仓库进行代码审查

Install

npx skills add instructa/agent-skills --skill shellck -g -y

More Options

Non-standard path

npx skills add https://github.com/instructa/agent-skills/tree/main/skills/shell/shellck -g -y

Use without installing

npx skills use instructa/agent-skills@shellck

指定 Agent (Claude Code)

npx skills add instructa/agent-skills --skill shellck -a claude-code -g -y

安装 repo 全部 skill

npx skills add instructa/agent-skills --all -g -y

预览 repo 内 skill

npx skills add instructa/agent-skills --list

SKILL.md

Frontmatter

{
    "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

Ensure shellcheck is installed.
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.