What is the 'Minimal Root' philosophy?

It is the belief that the Home Directory (~) should only contain user data like 'src' and 'data', while all configurations are hidden and organized within .config according to XDG standards.

Why use a Bare Git Repository instead of GNU Stow?

A Bare Git Repository allows you to treat your home directory as a repo where you explicitly opt-in files to be tracked, avoiding the complexity and 'symlink farm' overhead of tools like Stow.

Is this skill compatible with macOS?

Absolutely. It includes specific strategies for macOS, such as handling the ~/Library/Application Support folder for GUI applications.

How does this skill handle apps that don't follow XDG standards?

It uses 'Shim' strategies, such as setting specific environment variables in .zshenv or creating strategic symlinks from .config back to the application's expected default location.

Can I safely manage secrets with this skill?

Yes, it provides patterns for using git-crypt for local encryption or, preferably, using the 1Password CLI with direnv to inject secrets at runtime without committing them to version control.

Dotfile Systems Architect

Name: Dotfile Systems Architect
Author: organvm-iv-taxis

byorganvm-iv-taxis

•

Productividad y Flujo de Trabajo

Organizes and manages system configuration files using XDG specifications and bare Git repositories to eliminate home directory clutter.

The Dotfile Systems Architect skill empowers users to transform a cluttered home directory into a streamlined 'Minimal Root' environment. It strictly implements the XDG Base Directory specification, relocating configuration, state, and cache files into designated hidden directories while utilizing a Bare Git Repository for elegant version control without symlink farms. This skill provides sophisticated strategies for handling 'hostile' applications that resist XDG standards, facilitates cross-platform synchronization across macOS and Linux, and integrates secure secrets management via 1Password and git-crypt.

Características Principales

01XDG Base Directory specification enforcement for cleaner home directories

02Bare Git Repository implementation for selective version control

03Cross-platform synchronization patterns for macOS and Linux

042 GitHub stars

05Hostile app shimming strategies for VS Code, AWS, and Kube

06Secure secrets management using 1Password CLI and direnv

Casos de Uso

01Automating the redirection of application state and cache to standard XDG locations

02Cleaning up a cluttered home directory by migrating legacy dotfiles to .config

03Creating a portable, version-controlled developer environment across multiple machines

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add organvm-iv-taxis/a-i--skills dotfile-systems-architect

For use in Claude.ai and ChatGPT

Download Skill