dotfiles

Explain and manage dotfiles using GNU Stow across macOS and Linux.

1|1|Updated Aug 3, 2020
One-click install
npx skills add https://github.com/lolwierd/dotfiles --skill dotfiles-lolwierd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dotfiles
Source: https://github.com/lolwierd/dotfiles/tree/main/ai/dot-agents/skills/dotfiles
Command: npx skills add https://github.com/lolwierd/dotfiles --skill dotfiles-lolwierd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Explain and manage lolwierd's dotfiles to enable safe, persistent changes.

Core Features & Use Cases

  • Explains the dot-prefix convention and the stow packaging layout (shell, config, ai).
  • Guides adding or editing files inside ~/dotfiles and applying changes to the home directory via stow.
  • Provides best practices for cross-machine configuration management, backups, and versioning.

Quick Start

Edit a dotfile inside ~/dotfiles and run the appropriate stow command to apply changes to your home directory.

Frequently Asked Questions about dotfiles

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

FAQPage Schema
What is GNU Stow and how does it manage dotfiles?▼

GNU Stow is a symlink farm manager that packages dotfiles from a centralized directory into your home directory. It organizes configurations into groups like shell, config, and ai, applying changes safely via symlinks.

How do I edit shell configurations and apply them safely?▼

To edit shell configurations safely, modify the target file inside the ~/dotfiles directory and run the appropriate stow command to symlink the changes to your home directory, ensuring versioned backups are maintained.

Can I sync dotfiles across macOS and Linux using the dot-prefix convention?▼

Yes, the dot-prefix convention syncs dotfiles across macOS and Linux by managing configurations in a shared ~/dotfiles layout. GNU Stow applies these cross-platform configurations safely to the home directory.

What's the best way to add new dotfiles to an existing stow packaging layout?▼

The best way to add new dotfiles is to place them in the correct package folder within ~/dotfiles and run stow to create the necessary symlinks. This maintains safe, versioned configuration management.

Does modifying dotfiles directly in the home directory break the stow workflow?▼

Modifying dotfiles directly in the home directory bypasses the stow workflow and breaks symlink management. You should edit files inside ~/dotfiles and run stow to apply changes, ensuring backups and versioning remain intact.

Why do I need a dot-prefix layout for shell and config management?▼

The dot-prefix layout provides a structured convention for organizing shell and config files before stow symlinks them. It separates packages clearly, enabling safe modifications and persistent, versioned configuration changes.