Agent skill

Shellck

by instructa in instructa/agent-skills

Run shellcheck on shell scripts after editing scripts or when debugging shell errors.

No licenceAuto-check passedDevelopment

Install Shellck

skills CLI
$ npx skills add instructa/agent-skills --skill shellck -a claude-code

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

GitHub CLI
$ gh skill install instructa/agent-skills shellck --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/instructa/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/shell/shellck .claude/skills/shellck && 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
shellck
GitHub stars
139
Token cost
~302 tokens
SKILL.md length
99 words
Files
3 (incl. scripts)
Skills in repo
17
Repo updated
First seen
Licence
None found

At a glance

Run shellcheck on shell scripts after editing scripts or when debugging shell errors.

  • Works in 2 steps: Ensure shellcheck is installed. → From the repo root, run the helper script.
  • Linting scripts in a repo (especially scripts/)
  • SKILL.md covers Overview, Workflow, Behavior and Resources
  • Runs Shell scripts from its folder

What it does

Shellck is an agent skill from instructa/agent-skills. 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.

Its SKILL.md is about 300 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `README.md` and `scripts/run_shellck.sh`).

It sits in Development, covering Shell scripting and Linting and formatting. The repository describes itself as: A curated collection of agent-skills.

When your agent uses it

  • Linting scripts in a repo (especially scripts/)
  • Catching issues like set -u with unset vars
  • Bad subshell usage
  • Quoting mistakes

Example prompts

  • “/shellck”

Requirements

  • A Bash shell

Workflow steps

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

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

What it can do on your machine

Read from SKILL.md and the folder at commit d49c149. 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 1 file 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

Shellck loads about 302 tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 99 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~302

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 99 words (~302 tokens).

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

— opening of SKILL.md by instructa
name
shellck

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (scripts) in skills/shell/shellck of instructa/agent-skills.

  • SKILL.md
  • README.md
  • scripts/run_shellck.sh

Open the folder on GitHubat commit d49c149

Compare with similar skills

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

Shellck compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Shellck this skillinstructa/agent-skills139—~302Automated safety check: PassNone
Building Glamorous TuisDicklesworthstone/meta_skill205—~3.4kAutomated safety check: PassCustom licence
ShellCheck Configurationwshobson/agents40k10 repos~403Automated safety check: PassMIT
Writing Bash Scriptsarchibate/dotfiles-opencode107—~413Automated safety check: PassNone
Linting Shell Scriptsagntcy/coffeeAgntcy112—~548Automated safety check: PassApache-2.0
Bash Script Validatorakin-ozer/cc-devops-skills319—~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Building Glamorous Tuis

    Dicklesworthstone/meta_skill

    Build terminal UIs with Charmbracelet (Bubble Tea, Lip Gloss, Gum).

    205 GitHub stars~3.4k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • 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 10 repos~403 tokens
    DevelopmentAuto-check passed
  • Writing Bash Scripts

    archibate/dotfiles-opencode

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

    107 GitHub stars~413 tokensUpdated 5 mo ago
    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 yesterday
    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.

    69k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed

More from instructa/agent-skills

All 17 skills in this repo
  • App Spec Packager

    instructa/agent-skills

    A skill your agent uses when the user wants to turn an application, product, startup idea, SaaS, mobile app, web app, API, AI product, or internal tool into a production-ready Markdown specification…

    139 GitHub stars~1.5k tokensUpdated 9 days ago
    Auto-check passed
  • Codex Reviewer

    instructa/agent-skills

    Have Codex review a feature or change from Claude Code, then let Claude address the findings and request verification.

    139 GitHub stars~1.6k tokensUpdated 9 days ago
    Auto-check passed
  • Search Context

    instructa/agent-skills

    Find, clone, inspect, and summarize high-quality GitHub reference repositories for coding agents.

    139 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • Secleak Check

    instructa/agent-skills

    Run or install repo security leak checks with BetterLeaks and Trivy.

    139 GitHub stars~557 tokensUpdated 9 days ago
    Auto-check passed
  • Delegate Fable

    instructa/agent-skills

    Delegate a bounded task from a Codex session to a Fable-powered Cursor Agent in the same Herdr workspace, then wait for and collect the result.

    139 GitHub stars~925 tokensUpdated 9 days ago
    Auto-check passed
  • Delegate Grok

    instructa/agent-skills

    Delegate a bounded task from a Codex session to Grok 4.6 with xhigh reasoning in the same Herdr workspace, then wait for and collect the result.

    139 GitHub stars~951 tokensUpdated 9 days ago
    Auto-check passed

Categories

Questions about Shellck

What does Shellck do?

Run shellcheck on shell scripts after editing scripts or when debugging shell errors. Shellck is an agent skill from instructa/agent-skills. Run shellcheck on shell scripts after editing scripts or when debugging shell errors.

When should I use Shellck?

Shellck fits situations like: linting scripts in a repo (especially scripts/); catching issues like set -u with unset vars; bad subshell usage; quoting mistakes.

How do I install Shellck in Claude Code?

Run `npx skills add instructa/agent-skills --skill shellck -a claude-code`. Or copy the skill folder (skills/shell/shellck in instructa/agent-skills) into .claude/skills/shellck in your project. Claude Code loads it when a task matches its description.

How do I install Shellck in Codex?

Run `npx skills add instructa/agent-skills --skill shellck -a codex`. Or copy the skill folder (skills/shell/shellck in instructa/agent-skills) into .agents/skills/shellck in your project. Codex loads it when a task matches its description.

Can I use Shellck 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 instructa/agent-skills --skill shellck -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/shellck, .gemini/skills/shellck, .github/skills/shellck and .opencode/skills/shellck in your project.

What does Shellck need to run?

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

Does Shellck 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 Shellck 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 Shellck use?

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

How many tokens does Shellck use?

About 302 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Shellck?

Skills that share tags, products or a category with Shellck: Building Glamorous Tuis (Dicklesworthstone/meta_skill, 205 stars), ShellCheck Configuration (wshobson/agents, 40k stars), Writing Bash Scripts (archibate/dotfiles-opencode, 107 stars) and Linting Shell Scripts (agntcy/coffeeAgntcy, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Shellck?

instructa (a GitHub organization) maintains it in instructa/agent-skills, which has 139 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on September 28, 2026.

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