---
name: execute_command
version: 1.0.0
author: "KogniTerm Core"
description: "Ejecuta comandos en la terminal del sistema y devuelve su salida"
category: "system"
tags: ["bash", "shell", "terminal", "execution", "command"]
dependencies: []
required_permissions: ["execute", "filesystem"]
security_level: "elevated"
allowlist: true
auto_approve: false
sandbox_required: true
---

# Instrucciones para el LLM

Esta skill permite ejecutar comandos en el sistema operativo.

## Herramienta principal: execute_command

**Parámetros OBLIGATORIOS:**
- `command`: El comando bash a ejecutar (string)

**Parámetros OPCIONALES:**
- `timeout`: Segundos (int, default: 30, max: 300)
- `shell`: Boolean (default: True)

**Ejemplo de uso correcto:**
```python
execute_command(
    command="ls -la /home/user/proyecto",
    timeout=30,
    shell=True
)
```

**ERRORES COMUNES A EVITAR:**
- ❌ Usar `cmd` en lugar de `command`
- ❌ Usar `time` en lugar de `timeout`
- ❌ Olvidar que es un generador - la salida viene en chunks
- ❌ Usar comillas triples para el comando (use comillas simples o simples)

## Comandos peligrosos

Los siguientes comandos requieren aprobación manual:
- `rm -rf`, `rm -r /`, `rm -f /`
- `dd if=`, `mkfs`
- `chmod 777`, `chmod -R 777`
- `> /dev/sd*` (escritura directa a disco)
- `sudo`, `su`, `chown`

## Notas

- Los comandos `cd` funcionan - cambian el directorio de trabajo
- La salida es en tiempo real (streaming)
- El timeout máximo es 300 segundos
