---
name: shell
description: Execute shell commands with timeout and working directory support. Core system primitive for command execution.
---

# Shell Skill

Use this skill when you need to:
- Run shell commands (bash, git, npm, etc.)
- Execute system utilities
- Interact with the operating system

## Tools

- **execute**: Run a shell command with optional timeout and working directory.

## Usage Pattern

1. Use `shell.execute` to run commands
2. Check the exit_code to determine success (0 = success)
3. Read stdout/stderr for command output

## Tips

- Always set reasonable timeouts for long-running commands
- Use `cwd` to run commands in specific directories
- Commands run in a non-interactive shell (no TTY)

## Security Notes

- Commands run with the same permissions as the Albus process
- Be cautious with user-provided input in commands
- Consider sandboxing for untrusted inputs
