ensure-tools

name	ensure-tools
description	Verifies if a required CLI tool is installed and offers to install it. Use when about to execute a command whose binary might not be installed. Trigger: "¿tienes X instalado?", "instala Y si no está", "check dependencies", "setup environment".

Skill: Ensure Tools

Trigger

Activar cuando necesites verificar si una herramienta, CLI o runtime está disponible antes de usarla. Ejemplos: "¿tienes X instalado?", "instala Y si no está", "necesito que uses Z", "verifica que tengas Node", "asegúrate de tener Python", "check dependencies", "setup environment"

También activarlo automáticamente cuando Claude vaya a ejecutar un comando cuyo binario podría no estar instalado en el sistema del usuario.

---

Proceso

Paso 1: Detectar si la herramienta está disponible

Antes de ejecutar o sugerir instalar, verificar si ya existe:

# El comando más portable para verificar existencia:
# Windows (PowerShell)
Get-Command <tool> -ErrorAction SilentlyContinue

# Unix/macOS
which <tool> 2>/dev/null || command -v <tool> 2>/dev/null

Paso 2: Si NO está instalada — preguntar al usuario

Nunca instalar sin confirmación explícita. Presentar:

❓ [tool] no está instalado en tu sistema.
¿Deseas que lo instale ahora?

  [S] Sí, instalar automáticamente
  [N] No, lo instalaré manualmente
  [I] Ver instrucciones de instalación manual

⚠️  Nota: La instalación requiere permisos de administrador / internet.

Paso 3: Si el usuario confirma — instalar con el gestor correcto

Seleccionar el gestor de instalación según el OS y la herramienta:

Herramienta	Windows	macOS	Linux (Debian/Ubuntu)
Node.js / npm	winget install OpenJS.NodeJS	brew install node	apt install nodejs npm
Python	winget install Python.Python.3	brew install python	apt install python3 pip3
Git	winget install Git.Git	brew install git	apt install git
Docker	winget install Docker.DockerDesktop	brew install --cask docker	[Instrucciones Docker]
pnpm	npm install -g pnpm	npm install -g pnpm	npm install -g pnpm
Bun	npm install -g bun	brew install bun	curl -fsSL https://bun.sh/install | bash
uv (Python)	pip install uv	brew install uv	pip install uv
ruff	pip install ruff	brew install ruff	pip install ruff
jq	winget install jqlang.jq	brew install jq	apt install jq
Rust / cargo	winget install Rustlang.Rust	brew install rust	curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
kubectl	winget install Kubernetes.kubectl	brew install kubectl	[Instrucciones kubectl]

Paso 4: Post-instalación — verificar que funcionó

Después de cada instalación:

# Verificar versión instalada
<tool> --version
# o
<tool> -v

Si la verificación falla después de instalar:

1. Indicar al usuario que puede necesitar reiniciar la terminal (PATH no recargado)
2. Sugerir el comando para recargar el PATH según el OS

---

Detección del OS

Siempre detectar el OS antes de elegir el comando de instalación:

# Python
import platform
os_name = platform.system()  # 'Windows', 'Darwin', 'Linux'

// Node.js
const os = require('os');
os.platform()  // 'win32', 'darwin', 'linux'

# Bash/Shell
uname -s  # Darwin, Linux
# Windows: $env:OS en PowerShell

---

Instalaciones que NUNCA se hacen sin confirmación

Sin importar el contexto, estas operaciones siempre requieren aprobación explícita:

• sudo / instalaciones globales de sistema
• Modificar PATH, .bashrc, .zshrc, .profile
• Instalar gestores de paquetes (Homebrew, Chocolatey, winget)
• Instalar Docker o runtimes de VM
• Instalar extensiones globales de npm/pip (npm install -g, pip install sin virtualenv)

---

Formato de Salida al Usuario

Cuando se detecta una herramienta faltante, usar siempre este formato:

🔍 Verificando herramientas necesarias...

❌ [tool-name] (v[min-version]+) — No encontrado
✅ [other-tool] v[version] — OK

---
Para continuar necesito instalar: [tool-name]

Comando de instalación para [OS detectado]:
  [comando]

¿Procedo con la instalación? [S/N]

---

⚠️ Gotchas

• No asumir el OS — Siempre detectar antes de sugerir un comando. Un brew install X en Windows es inútil.
• Versiones mínimas — Algunos proyectos requieren versiones específicas (Node ≥20, Python ≥3.11). Verificar la versión instalada, no solo la existencia.
• PATH no actualizado — Después de instalar en Windows con winget, el binario puede no estar disponible hasta abrir una nueva terminal. Siempre advertir esto.
• Permisos en Windows — winget y instalaciones de sistema requieren PowerShell con permisos de administrador. Verificar antes de intentar.
• Virtualenvs Python — No instalar paquetes Python globalmente si el proyecto tiene pyproject.toml o requirements.txt. Siempre usar el entorno virtual del proyecto.
• npm install -g en sistemas con permisos restrictivos — En Linux/macOS sin configuración de npm, puede requerir sudo. Mejor usar nvm o un directorio local.
• Alternativas a instalar — Si el usuario rechaza instalar, buscar alternativas. ¿Hay un container Docker? ¿Un paquete npx? ¿Una versión web? Siempre ofrecer un plan B.