skills.rest
hschne
hschneCOMMUNITY
Explore all skills by this author →
Website𝕏@hschnedlitzGitHub

homeshick

Track, unlink, and delete dotfiles in a homeshick castle.

1|Updated Apr 14, 2026
Search Tags:#git#dotfiles#dev environment#configuration management#symlinks#cross-device sync#homeshick
One-click install
npx skills add https://github.com/hschne/pi-stuff --skill homeshick
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: homeshick
Source: https://github.com/hschne/pi-stuff/tree/main/skills/homeshick
Command: npx skills add https://github.com/hschne/pi-stuff --skill homeshick

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually tracking, syncing, and managing dotfiles across multiple devices and operating system reinstalls is tedious and error-prone, often leading to lost custom configurations for shells, editors, and applications.

Core Features & Use Cases

  • Dotfile Tracking: Move configuration files and directories into your homeshick castle and replace them with symlinks for seamless version control and syncing.
  • Flexible File Management: Unlink tracked files to revert them to regular local files, or permanently delete tracked files and their castle copies when no longer needed.
  • Use Case: If you maintain custom settings for zsh, neovim, and git that you want to keep consistent across your work laptop, personal desktop, and any new machines you set up, this skill simplifies managing those configs in a single centralized castle.

Quick Start

Use the homeshick skill to track your ~/.zshrc file to your dotfiles castle so it syncs across all your devices.

Frequently Asked Questions about homeshick

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync dotfiles across multiple devices using git?▼

To sync dotfiles across multiple devices, you can use homeshick to move configuration files into a version-controlled git castle and replace them with symlinks. This ensures consistent settings across machines.

What is the best way to manage cross-device configuration files for editors and shells?▼

Managing cross-device configuration files is best handled by tracking them in a centralized version-controlled castle. This allows seamless synchronization of shell, editor, and application settings across personal and work machines.

Do I need to install homeshick before tracking dotfiles with this approach?▼

Yes, you need a pre-configured homeshick installation with a named dotfiles castle and sourced helper functions to execute filesystem operations on local dotfile paths.

Can I unlink tracked configuration files to revert them to regular local files?▼

Yes, you can unlink tracked configuration files to revert them to regular local files. This provides flexible file management while maintaining your version-controlled castle.

How does symlink-based configuration management work for dev environments?▼

Symlink-based configuration management works by moving your configuration files and directories into a git repository and replacing the original paths with symlinks. This allows seamless version control and syncing of your dev environment.

What happens if I permanently delete tracked files from my dotfiles castle?▼

Permanently deleting tracked files removes both the local files and their castle copies. This is useful when configurations are no longer needed across your devices.

Related Skills

Explore More Software Engineering Skills→
MasonRhodesDevMasonRhodesDev
2

chezmoi

Track and manage dotfiles with chezmoi while preventing destructive commands.

Community
Intermediate
tdhoppertdhopper
22

managing-dotfiles

Manage yadf dotfiles, sync, edit README.md and resolve conflicts.

Community
Intermediate
FutureAtomsFutureAtoms
1

git-github-merge

Automates Git merge operations with selectable fast-forward, merge-commit, squash strategies and conflict previews.

Community
Intermediate
dixonwilledixonwille

stow-management

Automate dotfile symlink creation and management with GNU Stow.

Community
Intermediate