opensite-ai/opensite-skills / linux-dev-workstation
linux-dev-workstation
FlaggedConfigure a senior-grade Linux development environment on the machine: GPU drivers and compute stacks (NVIDIA CUDA, AMD ROCm, Intel XPU, Apple Silicon/Asahi), shell and terminal (zsh/fish, starship, modern CLI tools, tmux/zellij), advanced editor setup (Neovim/Vim, VS Code, Zed), language toolchains for Rust, Python, Ruby, and JavaScript/TypeScript via mise/uv/pixi, Docker/Podman containers, reproducible declarative setup (chezmoi, Ansible, Nix/home-manager), and security hardening (SSH keys, commit signing, secrets, firewall, backups). Use when setting up or upgrading a Linux dev box, installing GPU drivers, managing language versions and updates, configuring editors or dotfiles, or making a workstation reproducible. It runs commands on the machine.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.6 KB |
| agents/openai.yaml | config | 436 B |
| examples/fresh-ubuntu-to-senior-devbox.md | markdown | 4.6 KB |
| references/activation.md | markdown | 2.6 KB |
| references/containers.md | markdown | 3.7 KB |
| references/editors.md | markdown | 4.3 KB |
| references/gpu-drivers.md | markdown | 15.2 KB |
| references/language-toolchains.md | markdown | 8.5 KB |
| references/reproducibility.md | markdown | 4.3 KB |
| references/security-hardening.md | markdown | 4.8 KB |
| references/shell-terminal.md | markdown | 5.0 KB |
| templates/ansible-workstation.yml | config | 2.5 KB |
| templates/chezmoi-layout.md | markdown | 2.6 KB |
| templates/devcontainer.json | config | 1.1 KB |
| templates/mise.toml | config | 1.2 KB |
| templates/tmux.conf | config | 2.2 KB |
references/activation.md
View on GitHub# Activation Guide — linux-dev-workstation
## Best-fit tasks
Use this skill when an agent is running **on a Linux machine** and the user wants
to build or upgrade a senior developer environment. Concretely:
- Install or fix GPU drivers and the compute stack (NVIDIA CUDA, AMD ROCm, Intel
XPU/oneAPI/NPU, Apple Silicon/Asahi, or a CPU-only box).
- Set up the shell and terminal: zsh/fish, starship, the modern CLI set
(ripgrep, fd, bat, eza, zoxide, fzf, delta, btop), and tmux or Zellij.
- Configure editors at a power-user level: Neovim/Vim (LSP, treesitter), VS Code
(Remote-SSH, Dev Containers, settings sync), or Zed.
- Install and manage language toolchains for Rust, Python, Ruby, and JS/TS —
including per-project version pinning and explicit upgrade workflows.
- Stand up containers: Docker Engine or rootless Podman, Compose v2, and
devcontainers.
- Make the machine reproducible with chezmoi, Ansible, or Nix/home-manager.
- Harden the box: SSH keys, signed commits, secrets management, firewall, auto
security updates, and backups.
## Explicit invocation
> Use `$linux-dev-workstation` to configure this Linux dev box — install the GPU
> driver stack, set up zsh + starship + tmux, install Rust/Python/Ruby/Node via
> mise/uv, enable rootless Podman, and harden SSH and the firewall.
The skill runs commands on the machine, so it always begins with the detection
step and follows the SAFETY PROTOCOL (confirm before anything destructive).
## When NOT to use (route to a sibling instead)
- **The distro is not chosen yet** → use `linux-distro-selector` to pick a distro
and confirm hardware compatibility first.
- **Linux is not installed yet** (replacing Windows, dual-boot, clean install)
→ use `linux-install-planner` to generate the install runbook; return here
after first boot.
- **The user wants the AI/LLM toolchain** (local inference, AI coding agents,
MCP servers, ML frameworks, remote GPU) → use `linux-ai-dev-stack`. This skill
installs the base and GPU drivers that stack depends on; run it first, then
hand off.
## Cross-agent notes
- This is a **configurator** skill: it executes on the target machine. If an
agent is *not* on the machine (advisory/remote context), it should produce
instructions and prefer `linux-install-planner` / `linux-distro-selector`
instead of pretending to run these commands.
- Portable across agent platforms that expose a shell tool. `agents/openai.yaml`
enables implicit invocation for Codex/OpenAI-style hosts.
- Every embedded version is labeled "as of 2026-07 — verify"; agents with a web
search tool should confirm current driver, toolchain, and package versions at
runtime before installing.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |