dotfiles-best-practices_skill

Overview

This skill is a concise reference for modern dotfiles configuration, organization, and hardening. It collects practical patterns for CLI replacements, shell startup performance, modular config layout, credential safety, and theme consistency. Use it to standardize dotfiles across machines and speed up shell workflows.

How this skill works

The skill describes recommended modern tools (eza, bat, fd, ripgrep, zoxide, starship, delta, lazygit) and concrete aliases or init snippets to adopt them. It outlines performance strategies: lazy loading, selective completion loading, plugin audits, PATH hygiene, and profiling commands. It also presents a modular config layout, Git multi-config patterns, security rules for secrets, and consistent theming practices.

When to use it

• Setting up a new machine and choosing modern CLI defaults
• Reducing shell startup time or diagnosing slow shell startup
• Organizing dotfiles into reusable, version-controlled modules
• Securing credentials and preventing secrets from leaking into Git or history
• Standardizing themes across terminal, editor, and tools

Best practices

• Prefer fast modern replacements (eza, bat, fd, rg, zoxide) and alias only after checking tool existence
• Lazy-load heavy version managers and completions; target shell startup <500ms
• Organize config into numbered modules (00-env..99-local) so load order is explicit and modules can be disabled
• Never commit secrets; use .env + .env.example and set sensitive files to chmod 600
• Audit plugins quarterly and prefer native functions over bulky plugin stacks
• Use includeIf in .gitconfig to separate work/personal identities and enable commit signing

Example use cases

• Bootstrap dotfiles on a fresh laptop: install modern tools, load ZSH modules, import theme variable and Git identity includes
• Diagnose slow zsh startup: run time zsh -i -c exit, enable zprof temporarily, then convert eager loads to lazy loaders
• Migrate legacy aliases: replace ls/cat/find/grep with eza/bat/fd/rg behind safe existence checks and aliases
• Harden dotfiles repo: add .gitignore for .env and local overrides, move secrets to untracked .env and set strict permissions
• Enforce consistent theme: export THEME_FLAVOUR and reference it from bat, starship, delta, tmux, and Neovim