| name | nvidia |
| version | 1.1 |
| last_updated | 2026-08-08 |
| id | nvidia |
| one_line_purpose | Maintain NVIDIA GPU support architecture and update procedures. |
| entry_point | docs/skills/nvidia/SKILL.md |
| category | test-authoring |
| mcp_compliance_level | partial |
| optimization_status | draft |
| status | active |
| dependencies | [] |
| tags | ["nvidia","gpu","drivers","akmods"] |
| description | NVIDIA GPU support architecture and update procedures. Use when editing nvidia files in system_files/nvidia/, bluefin scripts, or dakota elements. |
| metadata | {"type":"reference"} |
NVIDIA GPU Support — Agent Skill
When to Use
- Editing
system_files/nvidia/ in projectbluefin/common
- Modifying nvidia build scripts in
bluefin, bluefin-lts, or dakota
- Updating NVIDIA driver or container toolkit versions
- Debugging flatpak GPU access or CDI spec generation failures
- Adding new nvidia-related services or presets
When NOT to Use
- Filing issues or making changes in
ublue-os/* — tell the human to report upstream manually
- Modifying the closed-source driver path — factory only ships open kernel modules (Turing+)
The three repos and their nvidia stacks
| Repo | Base OS | Driver source | NCT installed | CDI preset |
|---|
projectbluefin/common | shared overlay | — | — | ✅ system_files/nvidia/…/80-nvidia-container-toolkit.preset |
projectbluefin/bluefin | Fedora | ublue-os/akmods-nvidia-open OCI | ✅ (build script) | inherits from common |
projectbluefin/bluefin-lts | CentOS Stream 10 | ublue-os/akmods-nvidia-open OCI | ✅ (nvidia build overlay) | ✅ system_files_overrides/gdx/…/80-nvidia-container-toolkit.preset |
projectbluefin/dakota | GNOME OS (BST) | .run installer, open kmod | ✅ (built from source) | ✅ elements/bluefin-nvidia/nvidia-container-toolkit-preset.bst |
dakota is the reference implementation. When in doubt about the correct approach for
nvidia-related changes, read elements/bluefin-nvidia/ in dakota first.
CDI is the architecture — not OCI hooks
Container GPU access uses CDI (Container Device Interface), not the legacy nvidia OCI hook.
How CDI works on bluefin
nvidia-container-toolkit-base ships two binaries: and
