docs
01Skill Claude CodeCodex
Agent entry point for projectbluefin/lab. Find the skill that matches your task, load only that skill, then act.
Bluefin QA pipeline — Argo Workflows, KubeVirt, behave/dogtail GNOME smoke tests
Skill Claude CodeCodex
Agent entry point for projectbluefin/lab. Find the skill that matches your task, load only that skill, then act.
Skill Claude CodeCodex
One-sentence trigger: what area this skill covers and when an agent should load it. Keep under 50 words.
Skill Claude CodeCodex
Authoring, linting, and submitting Argo Workflows and WorkflowTemplates in the lab. Use when writing or editing any .yaml file under argo/workflow-templates/, argo/bootstrap/, or argo/.yaml, or when debugging a failed workflow run.
Skill Claude CodeCodex
Building or revising Astro dashboard detail pages backed by repo-tracked JSON and browser-side charts. Use when adding docs routes like /tests, /images, or /applications that must render real evidence, explicit unavailable states, GitHub Pages-safe static output, and dense table sections without crushed columns.
Skill Claude CodeCodex
Build, verify, and maintain the FSDK-based bluefin-server bootc image, including compilation elements, offline Cargo setups, and containerDisk conversion. Use when modifying server-image configs, troubleshooting sandboxed BuildStream builds, or resolving bootc target installation requirements.
Skill Claude CodeCodex
GitHub Actions workflow authoring and debugging for lab dashboards and automation. Use when changing .github/workflows/, troubleshooting stale Pages data, or wiring CI jobs that need private-cluster data.
Skill Claude CodeCodex
Cluster management tools for the lab: kubectl, k3s, zot, external-secrets, and K8sGPT. Use when managing cluster state, installing cluster add-ons, configuring the OCI registry, or running cluster analysis through MCP.
Skill Claude CodeCodex
KubeStellar Console operations: deploy/upgrade via ArgoCD, auth and exposure policy, marketplace cards, guided missions, and the GitOps vs imperative action split. Use when working on the Console deployment or wiring dashboard surfaces.
Skill Claude CodeCodex
Review Dakota pull requests through the lab-backed workflow: dispatch the Dakota QA run, keep maintainer decisions tied to fresh evidence, and hand off a clear operator summary. Use when a Dakota PR needs lab validation or triage.
Skill Claude CodeCodex
Add a Flatcar Linux node to the k3s cluster and connect it to the Nebraska kernel update pipeline. Use when onboarding a new Flatcar node (e.g. exo-0, exo-2), joining it to k3s, or pointing updateengine at the local Nebraska server. Covers k3s sysext install, DaemonSet auto-configuration, and validating the update…
Skill Claude CodeCodex
Design direction for the Project Bluefin factory dashboard website. Use whenever modifying Astro pages, CSS, charts, or visual components under src/. Enforces deliberate, subject-grounded choices over templated dashboard defaults.
Skill Claude CodeCodex
ArgoCD GitOps model for the lab: what is and isn't managed, sync rules, bootstrap vs managed distinction, and common sync failures. Use when working with ArgoCD Applications, adding new templates to git, or troubleshooting sync issues.
Skill Claude CodeCodex
KubeStellar multi-cluster control plane on the lab: WDS/ITS/WEC model, install/upgrade via ArgoCD, WEC registration, BindingPolicy authoring, smoke testing, and failure modes. Use when working with KubeStellar, KubeFlex control planes, OCM ManagedClusters, or BindingPolicies.
Skill Claude CodeCodex
KubeVirt ephemeral VM lifecycle in the lab: containerDisk build, VM provisioning, SSH wait, teardown. Use when writing provision-vm templates, debugging VM boot failures, or working with KubeVirt manifests.
Skill Claude CodeCodex
Self-learning and skill-maintenance loop for the lab. Run at the end of every session that produces non-trivial work, and at the start of any session to check unanalyzed nightly failures. Enforces the write-back loop so the next agent starts smarter than this one did. Use when wrapping up any session, before creating…
Skill Claude CodeCodex
Add, drain, and remove capacity in the Bluefin Server home cluster: k3s node join (shared-cluster expansion), WEC cluster join, and the elastic BuildStream grid checks. Agent-executable counterpart of the GUI onboarding flow. Use when adding a second PC, removing a node, or verifying builds scale with new capacity.
Skill Claude CodeCodex
Working with the transparent registry catalog feature: the linuxserver.io catalog index, deploy-time install translation, validation, GitOps PR flow, and adding future providers (NGC/AMD/DockerHub). Use when editing docs/data/catalog/, scripts/collectlsiocatalog.py, scripts/cataloginstalllsio.py…
Skill Claude CodeCodex
Writing, debugging, and running behave/qecore/dogtail GNOME GUI tests. All Bluefin image tests live in projectbluefin/testsuite. Use when adding test scenarios, fixing AT-SPI failures, debugging Shell.Eval interactions, or working with the qecore-headless session.