overview
Skill131 starsChanged 18 days agoApache-2.0View on GitHub
Architecture, repository layout, and file map for this template. Use when orienting to the repository, tracing how the image is assembled, or deciding which skill covers a task.
7 other projects use a version of this.
Adopted by
Most recently taken up by
- nexmoe/VidBeetheir own version, first seen Nov 8, 2026
- neomjs/neo-agent-skillstheir own version, first seen Oct 13, 2026
- MatthewMair42/claude-configtheir own version, first seen Oct 12, 2026
- tracemem/tracemem-claude-code-plugintheir own version, first seen Oct 9, 2026
- jkaninda/okapi-skillstheir own version, first seen Aug 16, 2026
- gologo13/agent-skillstheir own version, first seen Feb 11, 2026
Other versions7 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 7
- nexmoe/VidBee★ 11ksame name
- neomjs/neo-agent-skills★ 11same name
- jkaninda/okapi-skills★ 3same name
- kt057/claude-code-boilerplate★ 1same name
- tracemem/tracemem-claude-code-plugin★ 1same name
- gologo13/agent-skills★ 0same name
- MatthewMair42/claude-config★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository6 other files it gives its agents.
- AGENTS.mdAGENTS.md
- buildSkill
- ciSkill
- customizeSkill
- onboardingSkill
- troubleshootingSkill
The file
Files
Overview
This repository builds a bootc operating system image by assembling OCI layers rather than by modifying an existing image. Bluefin, Aurora, and Bluefin LTS are built the same way, so the desktop configuration here is the one they ship.
How the image is assembled
The Containerfile is the source of truth, and it is deliberately verbose. It
defines three things:
Context stage (
ctx) — combines the localbuild/andcustom/directories with files pulled from two OCI images:ghcr.io/projectbluefin/common— the shared desktop configuration, branding, and the Brew/Flatpak/ujust plumbingghcr.io/ublue-os/brew— the Homebrew integration
- Base image — the
FROMline. It defaults to Fedora Silverblue and is the only place the base is chosen.just buildreads the image name and tag from it; the Fedora major is read from the base image itself during the build. - Phases — each build script runs in its own
RUNblock, in the order the Containerfile names them. build/README.md lists them.
Layout
| Path | Holds |
Containerfile | Image assembly: identity, base image, and phases. |
Justfile | Build, VM, release, and test recipes. |
build/ | Build-time scripts: the phases, helpers, and the .example catalogue. |
custom/brew/ | Brewfiles, installed at runtime. |
custom/flatpaks/ | Flatpak preinstall declarations, installed on first boot. |
custom/ujust/ | ujust recipes. |
custom/files/ | System files overlaid onto /. |
custom/config/ | Per-user config seeded into /etc/skel/.config/. |
iso/ | Installer ISO and disk-image configuration. |
tests/ | contract/ (interfaces the image must satisfy) and template/ (this repository's build wiring). |
.github/ | Workflows, Renovate config, issue templates. |
Which skill
| I need to… | Load |
| Understand the repository, or find the right skill | overview |
| Fork it and reach a first green build | onboarding |
| Add or remove a package, app, or command | customize |
| Change the Containerfile, Justfile, or a build phase | build |
| Change a workflow, Renovate, or the release model | ci |
| Fix something broken, or check before a pull request | troubleshooting |
Upstream
The template consumes Project Bluefin's shared infrastructure rather than copying it:
projectbluefin/common— the shared runtime layer and the lifecycle label workflowprojectbluefin/actions— the reusable workflows for image build, promotion, sync, PR validation, and Renovateublue-os/brew— the Homebrew integration
Changes stay in this repository. ublue-os/* is read-only.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.