Agent Skill
2/7/2026

git-workflow

**MANDATORY**: Enforce branch/worktree workflow. Use when starting work, picking up work, creating branches, using git worktrees, or when asked to implement anything non-trivial. Ensures all work happens on correctly named branches, preferably in dedicated worktrees.

V
vereis
36GitHub Stars
1Views
npx skills add vereis/nix-config

SKILL.md

Namegit-workflow
Description**MANDATORY**: Enforce branch/worktree workflow. Use when starting work, picking up work, creating branches, using git worktrees, or when asked to implement anything non-trivial. Ensures all work happens on correctly named branches, preferably in dedicated worktrees.

Nix Configuration

This is my personal Nix configuration for Windows (WSL) and Linux (NixOS).

It uses flake-parts to help with organization and modularity:

├── flake.nix
├── lib/                         # Utility functions
│   └── default.nix
├── parts/                       # Flake parts
│   ├── devshell.nix
│   ├── formatter.nix
│   ├── hosts.nix
│   └── overlays.nix
├── hosts/                       # Host-specific configurations
│   ├── linux/                   ## NixOS machine configurations
│   │   ├── configuration.nix
│   │   ├── kyubey/
│   │   ├── madoka/
│   │   └── iroha/
│   ├── wsl/                     ## WSL2 machine configurations
│   │   ├── configuration.nix
│   │   └── homura/
│   └── home.nix
├── modules/                     # Reusable modules
│   ├── hardware/                ## Hardware-specific modules
│   ├── home/                    ## User-specific modules, applications
│   │   ├── gui/
│   │   ├── tui/
│   │   ├── gui.nix              ## GUI applications
│   │   └── tui.nix              ## TUI applications
│   └── services/                ## Background service modules
├── overlays/                    # Overlays
├── secrets/                     # Encrypted secrets
└── bin/                         # Custom scripts, utilities

Installation starts at the top level flake.nix, which uses lib/default.nix and parts/hosts.nix to build configurations for each platform I support.

Each host configuration then gets configured via hosts/<platform>/configuration.nix and hosts/<platform>/<hostname>/, which pulls in reusable modules from modules/.

Usage

  1. Clone this repository
  2. Install nix (ideally via Determinate Systems) or nixos
  3. Decrypt secrets with git-crypt:
    git-crypt unlock <path-to-key>
    
  4. Install:
    sudo nixos-rebuild switch --flake .#<machine-name>
    
Skills Info
Original Name:git-workflowAuthor:vereis