Profile My skills Saved Collections Edit profile Submit a skill

← all publishers

aminedjeghri

@aminedjeghri source repo

14 published skills

  1. ▌
    Vm Lab · aminedjeghri
    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 packages.yaml.
    0
    installs
  2. ▌
    Docs Site · aminedjeghri
    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 docs_dir:. quirk, the exclude-glob trap for new top-level directories, and the auto-generated API reference/example pages.
    0
    installs
  3. ▌
    Run Tests · aminedjeghri
    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 mocking/patching conventions used across tests/unit.
    0
    installs
  4. ▌
    Repo Gotchas · aminedjeghri
    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.
    0
    installs
  5. ▌
    Ship Feature · aminedjeghri
    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).
    0
    installs
  6. ▌
    Skill Layout · aminedjeghri
    Use when adding/modifying agent skills in this repo, or when figuring out how skills are organized here.
    0
    installs
  7. ▌
    Chezmoi Scripts · aminedjeghri
    Use when adding/debugging a chezmoi run_/run_once_/run_onchange_ 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 specific targets, and why that means scripts often don't run even though their sibling config file did apply.
    0
    installs
  8. ▌
    Add System Action · aminedjeghri
    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 additions.
    0
    installs
  9. ▌
    Fork And Customize · aminedjeghri
    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 plumbing to leave alone.
    0
    installs
  10. ▌
    Coding Workflow · aminedjeghri
    Use when starting any coding work across the repos. Division of labor between Hermes and Claude Code, plan-first workflow, confirm-before-mutate, review, and per-repo PR flows (see repo-conventions).
    0
    installs
  11. ▌
    Yt Dlp Music Downloads · aminedjeghri
    Download YouTube playlists into the Navidrome music library.
    0
    installs
  12. ▌
    Repo Conventions · aminedjeghri
    Use before committing, pushing, or opening a PR in ANY repo. Universal pre-push checklist plus how to discover each repo's own conventions (AGENTS.md/CLAUDE.md/CONTRIBUTING.md/.claude/skills) — repo-specific rules are NOT encoded here, they live in the repo itself.
    0
    installs
  13. ▌
    Skill Deployment · aminedjeghri
    Use when deploying the shared agent skills via chezmoi, or fixing "not managed" errors.
    0
    installs
  14. ▌
    Project Templates · aminedjeghri
    Use when starting to build a NEW app, package, or project from scratch — pick the right forkable template instead of an empty repo. Lists the user's three templates and their CI/CD + docs setup.
    0
    installs