projectbluefinprojectbluefin/finpilot/.agents/skills/customize/SKILL.md

customize

Skill131 starsChanged 18 days agoApache-2.0View on GitHub

Decide where a package, app, or command belongs — dnf5 at build time, Homebrew, Flatpak, or ujust — and how each is validated. Use when adding or removing something from the image.

40 other projects use a version of this.

Adopted by

Most recently taken up by

HughYau/AcademicForgetheir own version, first seen Nov 8, 2026
nanocoai/nanoclawtheir own version, first seen Nov 3, 2026
microsoft/frontier-ai-governance-rvastheir own version, first seen Oct 25, 2026
JonathanChan-geek/claude-science-skillstheir own version, first seen Oct 25, 2026
ss2code/nanoclaw-opstheir own version, first seen Oct 15, 2026
microsoft/frontier-ai-starter-kit-rvastheir own version, first seen Oct 13, 2026

Used with

Projects with it also use add-discord, add-slack and 10 more.

Other files people use alongside this one.

MicrosoftSkill
add-discord
Add Discord bot channel integration via Chat SDK.
Also in 11 projects that use this
MicrosoftSkill
add-slack
Add Slack channel integration via Chat SDK.
Also in 11 projects that use this
+10 more from microsoft

Other versions40 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 40
gavrielc/nanoclaw★ 31ksame name
nanocoai/nanoclaw★ 31ksame name
qwibitai/nanoclaw★ 31ksame name
anthropics/claude-for-legal★ 9.5ksame name
anthropics/defending-code-reference-harness★ 7.5ksame name
microsoft/agent-skills★ 3.2ksame name
microsoft/skills★ 3.2ksame name
HughYau/AcademicForge★ 2.6ksame name
microsoft/azure-skills★ 1.6ksame name
xuzhougeng/wisp-science★ 1.1ksame name
30 more not listed
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
- onboardingSkill
- overviewSkill
- troubleshootingSkill

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

0
Common
Most of the 37 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
Prefer a package the base already ships.
line 33

“Common” is measured: kept by at least 6 in 10 of the 37 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Customize

Where does it go?

The thing is…	Put it in	Installed
A system package the image needs to boot or run	`build/20-packages-and-services.sh`	at build time
A CLI tool a user chooses to have	`custom/brew/*.Brewfile`	on demand, by the user
A GUI application	`custom/flatpaks/*.preinstall`	on first boot
A command that configures the system	`custom/ujust/*.just`	available from first login
A system file: unit, preset, tmpfiles.d	`custom/files/`	at build time
Per-user config for new accounts	`custom/config/`	at build time, into `/etc/skel`

The dividing line is who decides and when: build time for what the image must have, runtime for what the user chooses.

By destination

Build-time packages

build/20-packages-and-services.sh. Use dnf5, always with -y, and disable any repository you enable. build/README.md has the phase map.

Prefer a package the base already ships. When a COPR is unavoidable, copr_install_isolated enables and disables it for you.

Homebrew

Brewfiles in custom/brew/, plus a ujust recipe so users install it by name. custom/brew/README.md has the format.

Flatpak

Preinstall declarations in custom/flatpaks/. The app must exist on Flathub; just validate-flatpaks checks. custom/flatpaks/README.md has the format and the first-boot behaviour.

ujust

Recipes in custom/ujust/. No dnf5 or rpm — the image is immutable. custom/ujust/README.md has the recipe shape.

System files and user config

custom/files/ mirrors /; custom/config/ seeds /etc/skel/.config/. Each directory's README has the semantics.

Removing something

The reverse of adding: delete the line or the file, then check nothing still references it. A package removed from the package phase may still arrive as a dependency or from an overlay; bootc container lint and the image build catch the obvious cases.

Validate

just validate-brewfiles
just validate-flatpaks
just check
just build

CI runs validate-brewfiles, validate-flatpaks, and validate-justfiles on every pull request.

Download now (ZIP)

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

What did you use it for? e.g. Reviewing pull requests in a Rails app

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.

Check your setup, free