Skills
.Work. You
Rest

gradual-dotfiles-migration

Community

Safely migrate dotfiles to home-manager on Darwin.

Software Engineering#migration#dotfiles#macOS#home-manager#Nix#devbox#Darwin
Authorjohnnymo87
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a structured, safe approach to migrating configuration from dotfiles to workstation's home-manager on Darwin, reducing breakages and enabling gradual adoption.

Core Features & Use Cases

  • Progressive migration patterns for shell config, Neovim, and other dotfiles-managed files.
  • Safe handling of symlinks and directory overlays across Devbox and Darwin.
  • Use Case: When preparing to migrate a single component (e.g., .bashrc or nvim config) without disrupting the entire system.

Quick Start

Start by choosing a small, non-critical file to migrate (for example, deploy a single Neovim config file using home-manager) and follow Gradual Dotfiles Migration steps to flip the correct program ownership and enable HM gradually.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: gradual-dotfiles-migration
Download link: https://github.com/johnnymo87/workstation/archive/main.zip#gradual-dotfiles-migration

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.