moai-lang-shell

Enforce POSIX shell scripting best practices with automated linting and testing.

1|Updated Jul 28, 2025

Search Tags:#bash #bats #shellcheck #shell #posix

Ready to run

npx skills add https://github.com/kivo360/quickhooks --skill moai-lang-shell-kivo360

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: moai-lang-shell
Source: https://github.com/kivo360/quickhooks/tree/main/.claude/skills/moai-lang-shell
Command: npx skills add https://github.com/kivo360/quickhooks --skill moai-lang-shell-kivo360

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates shell scripting errors by enforcing POSIX compliance, security best practices, and comprehensive testing.

Use Case: Automatically set up a Python development environment with uv, pytest, ruff, and mypy integration.

Quick Start

Create a bash script that safely processes user input and includes comprehensive bats-core tests.

Quick Start

Create a shell script that safely processes user input and includes comprehensive test coverage.

Quick Start

Write a shell script to automate deployment with proper error handling and validation checks.

Frequently Asked Questions about moai-lang-shell

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I write shell scripts that pass linting and testing automatically?▼

Shell scripts benefit from automated linting with ShellCheck and testing with bats-core. This Skill enforces POSIX compliance, security best practices, and comprehensive test coverage across your codebase, catching errors before deployment and ensuring scripts meet quality gates.

What's the best way to ensure my bash scripts are POSIX-compliant?▼

POSIX compliance ensures portability across Unix-like systems. This Skill validates shell scripts against POSIX standards using ShellCheck 0.10.0 and Bash 5.2.37, automatically identifying non-portable constructs and security issues in code reviews and development workflows.

Can I use bats-core to test shell scripts in my development workflow?▼

Yes. bats-core 1.11.0 enables test-driven development for shell scripts with readable test syntax. This Skill integrates bats testing directly into your codebase, automating test execution and linking results to quality gates for reliable shell script validation.

How do I set up automated shell script validation in code reviews?▼

Automated validation catches issues early without manual review overhead. This Skill triggers from code discussions and SPEC patterns to run linting and testing automatically, enforcing best practices and technical requirements across POSIX scripts in your repositories.

What are the limitations of shell script linting for error detection?▼

Linting catches syntax errors and common anti-patterns but cannot predict runtime behavior in all contexts. This Skill uses ShellCheck to identify security vulnerabilities and portability issues, but complex logic errors or environment-specific failures still require manual testing and code review.

Do I need ShellCheck to enforce shell script best practices?▼

ShellCheck is the industry standard for shell script analysis. This Skill bundles ShellCheck 0.10.0 to automatically enforce POSIX best practices and security standards without requiring separate tool installation or manual configuration.