المهارات shellcheck-configuration
📦

shellcheck-configuration

آمن

Configure ShellCheck for Shell Script Quality

متاح أيضًا من: wshobson

Shell scripts often contain subtle bugs and portability issues that are hard to catch manually. This skill provides comprehensive guidance on configuring and using ShellCheck to automatically detect and fix shell script problems.

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "shellcheck-configuration". How do I fix SC2086 in: for i in $list; do echo $i; done

النتيجة المتوقعة:

SC2086 warns about unquoted variables causing word splitting. Fix: use "$list" or "${list[@]}" for arrays. Corrected: for i in "$list"; do echo "$i"; done

استخدام "shellcheck-configuration". Create a .shellcheckrc for strict Bash validation

النتيجة المتوقعة:

Configuration that sets shell=bash, enables optional checks like require-variable-braces, and disables SC1091 (sourced files not found) as a project default.

استخدام "shellcheck-configuration". What are the most common ShellCheck errors to fix?

النتيجة المتوقعة:

Top 5: SC2086 (unquoted variables), SC1091 (sourced files), SC2154 (unset variables), SC2148 (tips), SC2164 (use cd with || exit). Each has specific fixes detailed in the skill.

التدقيق الأمني

آمن
v1 • 2/25/2026

All 111 static findings are false positives. The skill contains shell command examples used to demonstrate ShellCheck error codes (SC2086, SC1091, etc.). The scanner misidentified 'SC' as 'C2' keywords. URLs point to legitimate ShellCheck project resources. References to ~/.shellcheckrc and ~/.bashrc are standard config file paths, not malicious file access. The skill is purely educational documentation for ShellCheck static analysis tool.

1
الملفات التي تم فحصها
469
الأسطر التي تم تحليلها
5
النتائج
1
إجمالي عمليات التدقيق

مشكلات عالية المخاطر (1)

SKILL.md:80SKILL.md:110SKILL.md:113SKILL.md:116SKILL.md:119SKILL.md:122SKILL.md:125SKILL.md:129SKILL.md:132SKILL.md:137SKILL.md:140SKILL.md:144SKILL.md:183SKILL.md:218-219SKILL.md:286SKILL.md:292SKILL.md:296SKILL.md:307SKILL.md:318SKILL.md:333SKILL.md:347SKILL.md:357SKILL.md:424
False Positive: Scanner misidentified ShellCheck error codes as C2 keywords
The static scanner flagged 'C2 keywords' at multiple lines (80, 110, 113, 116, etc.), but these are actually ShellCheck error codes like SC2086, SC1091, SC2119. The scanner misread 'SC' as 'C2'. This is a documentation skill teaching users about ShellCheck error codes - no actual C2/malware content exists.
مشكلات متوسطة المخاطر (3)
SKILL.md:22SKILL.md:47-62SKILL.md:62-68
False Positive: Shell command examples are documentation content, not execution
The static scanner flagged 'external_commands' (73 occurrences) showing backticks, $(), and shell invocations. These are example shell script patterns shown in the skill to demonstrate what ShellCheck will detect. The skill is teaching users about ShellCheck - not executing these commands.
SKILL.md:55SKILL.md:466SKILL.md:467SKILL.md:468
False Positive: Network URLs are legitimate ShellCheck project resources
Hardcoded URLs point to github.com/koalaman/shellcheck and shellcheck.net - the official ShellCheck project and documentation. These are appropriate resources for a ShellCheck configuration skill.
SKILL.md:93SKILL.md:138
False Positive: Filesystem references are standard shell config paths
References to ~/.shellcheckrc and ~/.bashrc are standard configuration file paths in shell scripting. These are not malicious file access attempts - they are example configuration file locations.
مشكلات منخفضة المخاطر (1)
SKILL.md:263
False Positive: sudo apt-get install is legitimate installation instruction
Line 263 shows 'sudo apt-get install shellcheck' which is the standard way to install ShellCheck on Debian/Ubuntu systems. This is not privilege escalation for malicious purposes.
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
78
الأمان
100
الامتثال للمواصفات

ماذا يمكنك بناءه

DevOps Engineer: CI/CD Pipeline Setup

Set up automated shell script linting in GitHub Actions, GitLab CI, or other CI/CD systems to catch issues before deployment.

Software Developer: Script Quality Improvement

Fix existing shell script errors and improve portability across different Unix/Linux environments using ShellCheck guidance.

System Administrator: Team Code Standards

Enforce consistent code quality standards across team scripts with project-level configuration and pre-commit validation.

جرّب هذه الموجهات

Install ShellCheck 
How do I install ShellCheck on macOS, Ubuntu, or from source?
Understand Error Code 
What does ShellCheck error SC2086 mean and how do I fix it in my script?
Configure Project Settings 
Create a .shellcheckrc configuration file for a Bash project that enables strict checking but disables SC1091 and SC2119.
CI/CD Integration 
Show me how to integrate ShellCheck into a GitHub Actions workflow that checks all .sh files and fails the build if any issues are found.

أفضل الممارسات

  • Run ShellCheck in CI/CD pipelines to catch issues before merging
  • Configure the target shell correctly - do not analyze Bash scripts as POSIX sh
  • Document why specific warnings are suppressed using inline directives

تجنب

  • Disabling warnings without understanding why they appear
  • Analyzing scripts for wrong shell dialect (Bash as sh)
  • Ignoring ShellCheck output without addressing the underlying issue

الأسئلة المتكررة

What is ShellCheck?
ShellCheck is a static analysis tool that finds bugs, warnings, and issues in shell scripts. It supports Bash, sh, dash, ksh, and other POSIX shells.
How do I install ShellCheck?
On macOS: brew install shellcheck. On Ubuntu/Debian: apt-get install shellcheck. Or build from source at github.com/koalaman/shellcheck.
What do ShellCheck error codes mean?
Codes are grouped: SC1000-1099 (parser errors), SC2000-2099 (shell issues), SC2100-2199 (quoting), SC3000-3999 (POSIX compliance). Each code has specific guidance.
How do I suppress specific warnings?
Use inline directives: # shellcheck disable=SC2086. Or configure .shellcheckrc with disable=SC2086 to suppress project-wide.
Can ShellCheck catch security issues?
ShellCheck detects some security-related patterns like unquoted variables, but it is not a security scanner. Use dedicated security tools for vulnerability assessment.
How do I integrate ShellCheck with my editor?
Most editors have ShellCheck plugins: VS Code (vscode-shellcheck), Sublime Text, Vim (ale plugin), Emacs (flycheck). These provide real-time feedback.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/shellcheck-configuration

مرجع

main

بنية الملفات

📄 SKILL.md