How are secrets and API keys managed safely?

The skill discourages committing raw secrets. Instead, it guides you to use tools like 1Password CLI with direnv for runtime injection or git-crypt for local encryption within your repository.

Does this work on both macOS and Linux?

Yes. The skill includes specific patterns for handling platform differences, such as managing macOS GUI app settings in ~/Library versus standard Linux XDG paths.

What is the benefit of using a Bare Git Repository for dotfiles?

A bare repository allows you to treat your home directory as a git-managed folder without the overhead of moving files or managing symlink farms (like GNU Stow). You explicitly 'opt-in' specific files to be tracked.

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

It uses 'shim' strategies, such as defining specific environment variables in ~/.zshenv (like AWS_CONFIG_FILE) or creating targeted symlinks from ~/.config back to the application's expected legacy path.

Dotfile Systems Architect

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

byorganvm-iv-taxis

•

Developer Tools

Manages home directory organization and dotfile versioning using the XDG Base Directory specification and bare Git repositories.

Dotfile Systems Architect is a specialized skill designed to transform cluttered home directories into clean, "Minimal Root" environments. By implementing the XDG Base Directory specification and utilizing a bare Git repository, this skill helps developers relocate configuration files to structured locations like ~/.config, manage cross-platform synchronization, and handle secrets securely. It provides comprehensive architectural guidance on bootstrapping shell environments, shimming non-compliant applications, and maintaining a version-controlled, professional workstation setup that scales across macOS and Linux.

Key Features

01Cross-platform synchronization patterns for macOS and Linux environments

02Bare Git repository implementation for seamless configuration versioning

03Secure secrets management integration via 1Password CLI and git-crypt

04XDG Base Directory specification enforcement for a clutter-free home directory

052 GitHub stars

06Advanced shim strategies for non-compliant apps like VS Code and AWS CLI

Use Cases

01Bootstrapping new development machines with consistent, version-controlled settings

02Implementing secure handling of sensitive environment variables and SSH configurations

03Migrating a legacy home directory to a clean, standardized XDG-compliant structure

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