AmineDjeghri/personal-os-setup

coding-workflow

Use when doing coding work in any repo: plan, confirm, implement, verify, open a PR.

claude-code-ops

Install/auth/model defaults for Claude Code CLI on this box (Sonnet, never Opus).

agent-skills-architecture

Use when organizing, deploying or installing agent skills — or auditing, porting and retiring one.

youtube-download-automation

Use when downloading YouTube audio into the music library or driving yt-dlp. Plan first, confirm with the user, then download.

add-system-action

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…

chezmoi-scripts

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…

docs-site

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…

fork-and-customize

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…

repo-gotchas

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…

run-tests

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…

ship-feature

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 branch-naming, conventional commits, and the main-targeted squash-merge release flow…

skill-layout

Use when adding/modifying agent skills in this repo, or when figuring out how skills are organized here.

vm-lab

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…

git-line-endings

Use when CRLF/LF churn breaks git diffs in a repo.

github-actions-trigger-gotchas

Use when GitHub Actions triggers fire wrong or not at all.

github-auth

GitHub auth setup: gh CLI login (default), git-only PAT/SSH as a last resort.

github-code-review

Review PRs: diffs, inline comments via gh or REST.

github-community-health-files

Detect missing GitHub community/health files (SECURITY.md, LICENSE, CONTRIBUTING, CODE_OF_CONDUCT, FUNDING) and generate them.

github-issue-to-pr

Carry a GitHub issue to a verified PR with honest CI state.

github-issues

Create, triage, label, assign GitHub issues via gh or REST.

github-pr-workflow

GitHub PR lifecycle: branch, commit, open, CI, merge.

github-repo-management

Clone/create/fork repos; manage remotes, releases.

project-templates

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.

repo-conventions

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…

skill-creator

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or…

skill-deployment

Use when deploying the shared agent skills via chezmoi, or fixing "not managed" errors.

hermes-session-recall

Use when recalling past or continued Hermes sessions.

hermes-instance-audit

Audit a live Hermes install: skills, plugins, config.

debugging-hermes-tui-commands

Debug Hermes TUI slash commands: Python, gateway, Ink UI.

hermes-coding-workflow

Use when the Hermes orchestrator plans, delegates or reviews coding work (Hermes-only).

hermes-s6-container-supervision

Modify, debug, or extend the s6-overlay supervision tree inside the Hermes Agent Docker image — adding new services, debugging profile gateways, understanding the Architecture B main-program pattern.