菜单
Diagnose and resolve hardware issues on Bluefin — GPU, WiFi, Bluetooth, peripherals.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Create, enter, and manage Distrobox containers for mutable package installation on Bluefin.
ZFS administration on Bluefin — pools, datasets, snapshots, and delivery options for an immutable host that does not ship ZFS kernel modules.
Run, build, and manage OCI containers rootlessly on Bluefin — including Quadlets for persistent systemd-managed services.
Run self-hosted services on Bluefin DX using Podman Quadlets and linuxserver.io containers — persistent, auto-updating, systemd-managed.
Install and manage CLI tools with Homebrew — the primary CLI package manager on Bluefin.
Manage GNOME extensions, gsettings, and desktop customizations on Bluefin — including which settings Bluefin owns vs. which are safe to change.
| name | hardware |
| description | Diagnose and resolve hardware issues on Bluefin — GPU, WiFi, Bluetooth, peripherals. |
| domain | troubleshooting |
Bluefin runs on a stock Fedora kernel with firmware from linux-firmware. Most hardware works out of the box. This skill covers diagnosing common hardware issues.
Load with: point your agent at this file.
journalctl -b -p err and rpm-ostree status to verify the current image is healthy# List all PCI devices with driver info
lspci -nnk
# List USB devices
lsusb
# Check kernel messages for hardware errors
journalctl -b -p err | grep -v systemd
# Check firmware loaded for a device
journalctl -b | grep -i firmware
# GPU info (AMD/Intel)
lspci -nnk | grep -A3 VGA
# NVIDIA GPU (if using nvidia variant)
nvidia-smi
# WiFi / network interfaces
ip link show
nmcli device status
# Bluetooth
bluetoothctl show
journalctl -b -u bluetooth.service
AMD: Bluefin uses the open-source amdgpu driver. Check lspci -nnk | grep -A3 VGA.
If amdgpu is not in "Kernel driver in use", file a bug — it should be automatic.
Intel: Uses i915 or xe. Same diagnostic: lspci -nnk | grep -A3 VGA.
NVIDIA: Use the nvidia or aurora-nvidia image variant. Check that nvidia-smi works
after reboot. If not, verify you're on the correct image: bootc status | grep image.
# Check if driver loaded
lspci -nnk | grep -A3 -i network
# Restart NetworkManager
sudo systemctl restart NetworkManager
# List available networks
nmcli device wifi list
Broadcom WiFi (14e4:*): Not supported in stock Bluefin (no wl driver). Consider
a USB WiFi adapter with better Linux support.
# List audio devices (PipeWire)
wpctl status
# Restart PipeWire
systemctl --user restart pipewire pipewire-pulse wireplumber