action-gate
Decide and take action when blockers appear. Use when tools are missing, installs are required, or the user expects proactive execution to complete the task.
When & Why to Use This Skill
The Action Gate skill empowers Claude agents to autonomously identify and resolve technical blockers, such as missing dependencies or required software installs. By intelligently weighing cost, risk, and necessity, it enables proactive execution with minimal back-and-forth, ensuring seamless workflow continuity across various operating systems and environments.
Use Cases
- Automated Dependency Resolution: Automatically detecting and installing missing CLI tools or libraries (e.g., pip, npm, or brew packages) required to complete a specific coding or data processing task.
- Cross-Platform Environment Setup: Identifying the host operating system and package manager to execute the correct, localized installation commands for Linux, macOS, or Windows.
- Risk-Aware System Management: Evaluating the safety of a required action and deciding whether to proceed autonomously for low-risk tasks or pause for user confirmation when high-impact changes are detected.
- Proactive Workflow Unblocking: Reducing manual intervention by proposing and executing fallback strategies or alternative tool paths when primary tools are unavailable or permissions are restricted.
| name | action-gate |
|---|---|
| description | Decide and take action when blockers appear. Use when tools are missing, installs are required, or the user expects proactive execution to complete the task. |
Action Gate
Overview
Weigh cost, risk, and necessity, then act to unblock work with minimal back-and-forth.
Workflow
- Identify the blocker (missing tool, permission, or dependency).
- Decide if it is required to complete the requested work.
- If required and low risk, propose the exact install/run command and proceed when allowed.
- If required but risky, explain the risk and ask for confirmation.
- If not required, skip and continue with a fallback.
Decision Rules
- Required to deliver the request -> act by default.
- Optional or high-risk -> ask before acting.
- Prefer minimal installs (single tool) and reversible changes.
Portability Rules
- Detect OS and package manager before installing (Linux: apt/dnf/yum/pacman, macOS: brew, Windows: choco/scoop).
- If no install permissions or network access, ask for manual install or alternate environment.
- Prefer local, user-scoped installs when possible (e.g.,
pip install --user,npm install -gonly if permitted). - For Node CLIs, prefer
npx <tool>when global install is blocked; document any global install used.
Output Rules
- State why the action is required or optional.
- Provide the exact command(s) to run.
- Note any side effects or rollback steps.
Acceptance Criteria
- Decision is explicit (act / ask / skip) with rationale.
- Actions are minimal and unblock the task.