shell-skill

Execute short-lived Nushell commands in a workflow workspace with timeouts.

356|66|Updated Oct 13, 2025
One-click install
npx skills add https://github.com/zeenie-ai/MachinaOS --skill shell-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shell-skill
Source: https://github.com/zeenie-ai/MachinaOS/tree/main/server/skills/terminal/shell-skill
Command: npx skills add https://github.com/zeenie-ai/MachinaOS --skill shell-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Shell tool execution inside a workflow without resorting to platform-specific command syntax or brittle assumptions, so you can automate short, deterministic tasks in the workflow workspace.

Core Features & Use Cases

  • Cross-platform Nushell execution: Runs short-lived commands using Nushell with the same syntax across Windows, macOS, and Linux.
  • Workspace-friendly command running: Executes within the per-workflow workspace and supports timeouts to prevent runaway commands.
  • Safety-first guidance: Includes explicit rules to avoid Bash/cmd.exe idioms, disallowed operators (like && and redirects), and to prefer path-sandboxed tools for filesystem operations.

Quick Start

Execute the command to list files in your workflow workspace: ls.

Frequently Asked Questions about shell-skill

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

FAQPage Schema
How do I run shell commands safely across Windows, macOS, and Linux in a workflow?▼

Cross-platform shell execution is handled by running short-lived commands in Nushell, ensuring consistent syntax across Windows, macOS, and Linux. It avoids platform-specific Bash or cmd.exe idioms and operates safely inside the per-workflow workspace.

Can I execute long-running servers using workspace command execution?▼

Workspace command execution is designed for short-lived, one-shot utilities like checking versions or inspecting workspace state. It requires a timeout and does not support long-running servers or continuous background processes.

What is the best way to automate small CLI transforms without brittle platform assumptions?▼

Automating small CLI transforms safely requires using Nushell for cross-platform consistency. It executes within a sandboxed workspace, applies timeouts to prevent runaway commands, and uses path-sandboxed tools for filesystem operations.

Why does workflow command execution avoid Bash operators like redirects?▼

Workflow command execution avoids Bash operators like redirects and && to prevent brittle platform-specific assumptions. It uses Nushell syntax and workspace-safe filesystem tools to ensure deterministic cross-platform behavior.

Does Nushell command execution return exit codes and truncation status?▼

Nushell command execution returns captured stdout along with the exit code and truncation status. This ensures you can verify the command outcome and detect if the output exceeded safe display limits.