wsl-shell-reliability

What This Skill Does

The wsl-shell-reliability skill provides an intelligent, risk-aware policy for command execution on Windows environments. Rather than favoring a specific terminal, it analyzes the requirements of a task—such as POSIX dependency, tool availability, and parsing complexity—to select the shell with the lowest probability of failure. This ensures that AI agents avoid common pitfalls like mismatched quoting syntax, invalid path formats, or improper command interpretation. By enforcing a structured decision-making process, this skill maintains the integrity of the user's intent while maximizing the success rate of complex terminal operations.

Installation

To integrate this reliability policy into your environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/cikichen/wsl-shell-reliability

Ensure that you have both WSL and standard Windows PowerShell installed and accessible in your system PATH to allow the fallback mechanism to function correctly.

Use Cases

This skill is essential for developers or power users who frequently switch between Windows-native operations and Linux-based toolchains. Use cases include:

• Executing cross-platform build scripts that require POSIX headers while running on Windows.
• Managing complex directory structures where Linux-style symlink behavior or path globbing is necessary.
• Automating system administration tasks that involve both native Windows registry manipulation and subsequent bash-based log processing.
• Running legacy bash scripts ported to Windows without manually rewriting them into PowerShell cmdlets.

Example Prompts

1. "OpenClaw, please run the shell script './deploy.sh' in the current directory and ensure it handles the recursive file deletion correctly using the most reliable shell available."
2. "I need to update my Windows environment variables using PowerShell, then trigger a Linux-based build pipeline; manage the shell switching for me to avoid syntax errors."
3. "Check if the local build artifacts exist, then run 'grep -r' to search for specific error codes in the logs; select the best shell to handle these combined operations safely."

Tips & Limitations

• Transparency: The skill follows a strict 'no silent switching' rule. If an execution fails and a fallback occurs, the agent will inform you explicitly.
• Grammar Integrity: Do not attempt to pipe bash commands directly into PowerShell. Always allow the skill to perform the necessary syntax translation for you.
• Limitations: This skill does not automatically install missing tools. It operates on the existing environment; if a specific binary is missing from your WSL distribution or Windows PATH, you will need to install it independently.