AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Use when adding a new TUI button/action (system action) or a new package-manager backend to personal-os-setup — e.g. "add a button to do X", "support a new package manager", "add a new tab/section". Covers the factory.py section-builder pattern, the managers/shared.py boilerplate pattern, and the required test…
AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Use when adding/debugging a chezmoi run/runonce/runonchange script under config/chezmoi/, or when a dotfiles sync script "isn't firing" — "why didn't my script run", "add a script that starts X after sync", "the hyprland/noctalia script isn't triggering". Covers how this app's "apply selected" scopes chezmoi apply to…
AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Use when adding/editing documentation pages, or building/previewing/deploying the properdocs (mkdocs) site — "add a doc page", "preview the docs site", "deploy docs", "why isn't my new page showing up". Covers properdocs.yml's docsdir:. quirk, the exclude-glob trap for new top-level directories, and the auto-generated…
AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Use when someone wants to fork this repo to build their own personal OS setup tool, or asks how to rebrand/adapt it — "fork this repo", "make this my own", "use this for my dotfiles", "rebrand this". Covers what to rename/rebrand, how to customize packages.yaml and the chezmoi dotfiles source, and what release/CI…
AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Use before trusting CONTRIBUTING.md/Makefile/pre-commit claims literally, or when something documented doesn't behave as expected — "why doesn't X work", "is this hook actually active", "make help is missing stuff". Documents known drift between this repo's docs and its actual behavior.
AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Use when writing or running tests in this repo, or when a test fails unexpectedly — "add a test", "run the tests", "why did this test fail/get skipped", "test the new manager/action". Covers make test vs make test-integration (the latter is destructive against the host!), the three test suites, and the exact…
AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Use when starting new work in this repo, committing, or opening a PR — "start a new feature", "commit this", "open a PR", "what branch should this target". Covers the branch-naming, conventional-commit, and dev→main release flow specific to this repo (semantic-release, squash merge).
AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Use when working with the local KVM/QEMU VM test lab — "spin up a VM", "test this in a CachyOS/Ubuntu VM", "make vm-". CachyOS host only (libvirt/pacman-based); documents the required make vm-deps step, why re-running with new credentials does nothing until you clean, and the manual sync requirement against…
AmineDjeghri/personal-os-setup
Instructions file
Instructions for AmineDjeghri/personal-os-setup, covering claude.md, what this is, safety: always confirm before system-mutating actions, commands and architecture.
AmineDjeghri/personal-os-setup
Skill Claude CodeCodex
Download YouTube playlists into the Navidrome music library.