hyva-exec-shell-cmd

Utility skill to detect Magento development environment and determine command wrapper. This skill should be used by other skills that need to execute shell commands in the Magento environment. It detects Warden, docker-magento, DDEV, and local environments and provides the appropriate command wrappe

By hyva-themes · 1,099 installs

npx skills add hyva-themes/hyva-ai-tools --skill hyva-exec-shell-cmd

Source repository · Upstream listing

Execute Shell Commands in Magento Environment This utility skill detects the Magento development environment and provides the appropriate command wrapper for executing shell commands. Usage Other skills should reference this skill when they need to execute commands in the Magento environment. The detected wrapper ensures commands run in the correct context (container or local). Step 1: Detect Environment Important: Execute this script from the Magento project root directory, or provide the path as an argument. Run this detection once at the start of any skill that needs to execute shell commands: Where <skill path is the directory containing this SKILL.md file (e.g., .claude/skills/hyva exec shell cmd ). The optional magento root path argument specifies the Magento installation directory. If omitted, the script uses the current working directory. Output: warden , docker magento , ddev , or local Step 2: Apply Command Wrapper Based on detected environment, wrap commands as follows: Environment Command Wrapper Description Warden warden env exec T php fpm bash c "<command " Docker environment managed by Warden docker magento bin/clinotty bash c "<command " Mark Shust's docker magento setup DDEV ddev exec <command DDEV containerized environment Local Run <command directly Native environment without containers Examples Single command Command with directory change Commands That Do NOT Require Wrapping Some commands run on the host system and should NOT be wrapped: composer commands (runs on host, not in container) git commands File operations on the host filesystem ( ls , find , cp for files accessible from host) warden CLI commands ddev CLI commands Integration Pattern Skills that need to execute commands should: 1. Reference this skill: "Use the hyva exec shell cmd skill to determine the command wrapper" 2. Detect environment once using Step 1 3. Store the wrapper pattern for use throughout the skill 4. Apply the wrapper to all container commands per Step 2 Running a Bundled Skill Script Inside the Environment Some skills ship a helper script (e.g. a PHP script under scripts/ ) that must run through a PHP/Node interpreter. On a hardened host there is no local interpreter, and a skill installed at user level ( ~/.../skills/... ) is not inside the project, so the container can't see it. Do not copy the script into the project tree: how files reach the container differs across environments (bind mounts, Mutagen, named volumes) and some paths are not synced at all (e.g. Warden serves var/ , generated/ , pub/static , pub/media from separate volumes, so a host written file there never appears in the container). Instead, stream the script into the interpreter over stdin — this is independent of the mount/sync strategy, needs no temp file, and needs no cleanup: 1. Detect the environment (Step 1) and resolve the wrapper (Step 2). 2. Containerized env — pipe the script to php /dev/stdin through the wrapper (use the non TTY T exec so stdin is forwarded). <skill path is the directory containing the calling skill's SKILL.md: The script runs with the container's working directory at the project root, so a script that locates the project via getcwd() works unchanged. Capture stdout for the result. Script constraints for this method: the script must not also read from stdin (stdin carries the script itself), and must not rely on FILE / DIR (it is /dev/stdin ) — locate project files via getcwd() instead. 3. local env : the host has no interpreter (removed during hardening). Do not attempt to run the script directly — report that a containerized dev environment (or a local interpreter) is required for this step. <! Copyright © Hyvä Themes https://hyva.io. All rights reserved. Licensed under OSL 3.0