shell

Enforces safe mvdan/sh shell execution rules for Invowk's virtual runtime.

Updated Jan 8, 2026
One-click install
npx skills add https://github.com/invowk/invowk --skill shell-invowk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shell
Source: https://github.com/invowk/invowk/tree/main/.claude/skills/shell
Command: npx skills add https://github.com/invowk/invowk --skill shell-invowk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shell runtime rules for Invowk's mvdan/sh virtual shell, preventing misconfiguration and unsafe scripting.

Core Features & Use Cases

  • Virtual runtime uses mvdan/sh for cross-platform script execution.
  • Positional arguments gotcha: always prepend -- to avoid interpreting args as options.
  • Strict mode like set -euo pipefail for safer scripts.
  • Safe arithmetic practices to avoid increments that break on set -e.
  • Guidance references internal/runtime/virtual.go and cmd/invowk/internal_exec_virtual.go.

Quick Start

Configure your shell execution to follow these rules in the mvdan/sh virtual runtime.

Frequently Asked Questions about shell

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

FAQPage Schema
How do I prevent mvdan/sh from interpreting positional arguments as options?

To prevent mvdan/sh from interpreting positional arguments as options during shell script execution, always prepend `--` before passing arguments to ensure correct parsing and avoid misconfiguration.

Why does shell arithmetic fail with set -e in mvdan/sh virtual runtime?

Shell arithmetic fails under strict mode because increment operations trigger non-zero exit codes, breaking execution under `set -e`; applying safe arithmetic patterns prevents this script termination.

What is strict mode for safe shell script execution in virtual runtimes?

Strict mode for safe shell script execution uses `set -euo pipefail` to enforce deterministic behavior, ensuring scripts fail immediately on errors or undefined variables within the virtual runtime.

Does mvdan/sh support cross-platform script execution across native and container modes?

Yes, mvdan/sh supports cross-platform script execution across native, virtual, and container modes by enforcing deterministic runtime rules for safe shell execution flows.

What's the best way to configure deterministic shell execution rules for mvdan/sh?

The best way to configure deterministic shell execution rules is to apply strict mode, prepend `--` for positional arguments, and use safe arithmetic patterns within the virtual runtime.

When do I need safe shell runtime rules for script execution?

You need safe shell runtime rules when executing scripts through mvdan/sh to prevent misconfiguration, ensure deterministic behavior, and avoid unsafe scripting practices across virtual and container modes.