diff options
| author | Paul Buetow <paul@buetow.org> | 2026-07-18 22:08:10 +0300 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-07-18 22:08:10 +0300 |
| commit | efbb7876347bc667bdb3633f72a22a51b3bfbc49 (patch) | |
| tree | 0a2d1d9367f4bf549584aaa71b0b82337cab2226 /prompts/skills/f3s-pkgrepo/SKILL.md | |
| parent | fbf9d4815ea25bd85be0f232ac8670bda1a64955 (diff) | |
skills: rename pkgrepo -> f3s-pkgrepo and rocky-vm-setup -> f3s-rocky-vm-setup
Extend the f3s- prefix to the two remaining f3s-scoped siblings so the whole
homelab family groups together. Both are f3s-specific: pkgrepo IS
pkgrepo.f3s.buetow.org, and rocky-vm-setup documents the 'rocky' VM on the f3s
host f3.
- git mv both skill dirs (history preserved); update name: frontmatter; add the
'Part of the f3s homelab skill family' note to both descriptions.
- Rewrite every reference to the *skills*: backtick mentions (`pkgrepo` ->
`f3s-pkgrepo`, `rocky-vm-setup` -> `f3s-rocky-vm-setup`), markdown cross-links
(../pkgrepo/ -> ../f3s-pkgrepo/, etc.), the f3s hub Related-skills block and
description, and skill-maintenance's index-pattern example.
- Left references to the package REPOSITORY (pkgrepo.f3s.buetow.org, 'the custom
pkgrepo') unchanged — those name a service, not the skill.
- Verified all 114 relative links resolve. Plan doc updated to record the rename.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Diffstat (limited to 'prompts/skills/f3s-pkgrepo/SKILL.md')
| -rw-r--r-- | prompts/skills/f3s-pkgrepo/SKILL.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/prompts/skills/f3s-pkgrepo/SKILL.md b/prompts/skills/f3s-pkgrepo/SKILL.md new file mode 100644 index 0000000..262a6e7 --- /dev/null +++ b/prompts/skills/f3s-pkgrepo/SKILL.md @@ -0,0 +1,37 @@ +--- +name: f3s-pkgrepo +description: Reference skill for the homelab package repositories behind pkgrepo.f3s.buetow.org. Covers FreeBSD pkg, OpenBSD pkg_add, NetBSD pkg_add, Rocky Linux dnf repos, PV layout, nginx/ArgoCD wiring, DTail package publishing, and client repo configuration. Use when publishing packages, troubleshooting repository access or metadata, or deciding how packages should be installed from the custom repo. Part of the f3s homelab skill family (hub, [`f3s`](../f3s/SKILL.md)). +--- + +# Package Repo Reference + +Use this skill when the task is specifically about the custom package repositories rather than the broader f3s homelab. + +## When to Use + +- Publishing or updating packages in `pkgrepo.f3s.buetow.org` +- Troubleshooting repo layout, metadata, or HTTP exposure +- Configuring FreeBSD, OpenBSD, NetBSD, or Rocky Linux clients to install from the custom repo +- Working on DTail package publishing and installation through the repo + +## Reference Files + +- [Repo Architecture](references/repo-architecture.md) — nginx/k3s setup, PV directory structure, SSH access, stale NFS handle fix, per-OS repo notes +- [Client Setup](references/client-setup.md) — per-OS client repo configuration (FreeBSD, OpenBSD, NetBSD, Rocky Linux), new-host setup, package signing +- [Packaging Workflow](references/packaging-workflow.md) — Makefile workflow for single-binary Go packages, CGo packages, manual packaging reference +- [DTail Package](references/dtail-package.md) — multi-binary DTail package for all platforms, install/update steps, gotchas, client usage, verification +- [OpenBSD Build VM](references/openbsd-build-vm.md) — QEMU/KVM build VM for native CGo compilation, day-to-day use, installer notes + +## Scope + +This skill owns package repository details that used to live under `f3s`. + +Use `f3s` alongside this skill when the task depends on broader host-role or cluster context, especially: + +- `f0` as the FreeBSD NFS/PV host for `/data/nfs/k3svolumes/pkgrepo/` +- `fishfinger` and `blowfish` as the OpenBSD frontend hosts +- `r0-r2` as Rocky Linux x86_64 bhyve VMs +- `pi2-pi3` as Rocky Linux aarch64 Raspberry Pi nodes +- `pi0`/`pi1` as NetBSD aarch64 Raspberry Pi nodes (see the `f3s-raspberry-pi` skill's `bootstrap-netbsd-pi.md`) — NetBSD repo clients and the native NetBSD package build host (`pi0`) +- `earth` as the Fedora laptop used for package publication and verification +- `f0-f3` as FreeBSD hosts |
