running-commands-and-tools

Execute and manage subprocesses in Effect v4 with typed combinators.

2|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/spencerbeggs/effected --skill running-commands-and-tools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: running-commands-and-tools
Source: https://github.com/spencerbeggs/effected/tree/main/plugin/skills/running-commands-and-tools
Command: npx skills add https://github.com/spencerbeggs/effected --skill running-commands-and-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the complexity of safely spawning, managing, and interacting with subprocesses in Effect v4 applications, preventing common pitfalls like deadlocks, resource leaks, and environment misconfiguration.

Core Features & Use Cases

  • Typed Subprocess Execution: Run commands with structured output parsing (JSON, lines, text) and automatic error handling.
  • Tool Discovery: Reliably locate and verify CLI tools (global vs. project-local) with caching and version validation.
  • Lifecycle Management: Safely detach background processes and manage environment variables without polluting the parent process.

Quick Start

Use the running-commands-and-tools skill to execute the pnpm store path command and capture the output as text with a thirty second timeout.

Frequently Asked Questions about running-commands-and-tools

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

FAQPage Schema
How do I manage subprocesses in Effect v4 without causing resource leaks or deadlocks?

Effect v4 subprocess management requires typed combinators and service-based tool discovery to safely spawn processes, capture structured output, and handle non-zero exits without resource leaks or deadlocks.

How do I execute CLI commands and capture structured output in a Node subprocess?

Execute CLI commands in a Node subprocess using typed combinators that parse output into JSON, lines, or text, while automatically handling non-zero exit errors and applying execution timeouts.

What is the best way to locate and verify CLI tools across global and project-local environments?

Tool discovery locates and verifies CLI tools across global and project-local environments using caching and version validation to ensure the correct executable is reliably found before execution.

Can I detach background processes and manage environment variables without polluting the parent process?

Yes, lifecycle management allows you to safely detach background processes and manage environment variables hermetically, preventing environment misconfiguration from polluting the parent process.

Does running-commands-and-tools reinvent the core ChildProcess contract or use existing Node APIs?

No, it strictly avoids reinventing core ChildProcess contracts, building typed orchestration and structured output capture on top of existing subprocess mechanisms within the Effect v4 environment.

Why does my subprocess execution hang or leak resources in Effect?

Subprocess execution hangs or leaks resources when lacking robust error classification for non-zero exits and hermetic environment handling, pitfalls solved by using typed lifecycle management combinators.