shell-config

Configure XDG-compliant Zsh settings and load plugins from Git submodules.

Updated Jun 9, 2017
One-click install
npx skills add https://github.com/dixonwille/.dotfiles --skill shell-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shell-config
Source: https://github.com/dixonwille/.dotfiles/tree/main/.claude/skills/shell-config
Command: npx skills add https://github.com/dixonwille/.dotfiles --skill shell-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and standardizes Zsh shell configurations, plugins, and work integration to improve consistency and productivity across machines.

Core Features & Use Cases

  • XDG-compliant configuration stored under ~/.config/zsh/
  • Environment variable loading order via env.d for deterministic setups
  • Git submodules for plugins (zsh-autosuggestions, zsh-syntax-highlighting)
  • Work-specific overrides supported with a .zshrc_work file
  • Optional oh-my-posh prompt integration with configurable paths

Quick Start

Load the updated zsh config by sourcing ~/.config/zsh/.zshrc or starting a new Zsh session.

Frequently Asked Questions about shell-config

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

FAQPage Schema
How do I manage Zsh dotfiles across multiple machines consistently?

Manage Zsh dotfiles across machines by centralizing configurations in an XDG-compliant directory like ~/.config/zsh/. This setup uses Git submodules for plugins and env.d loading order to ensure deterministic, reusable shell environments on any system.

What is the best way to load Zsh plugins using Git submodules?

The best way to load Zsh plugins is by adding them as Git submodules within a zsh-plugins directory. This modular dotfiles approach enables guarded plugin loading for tools like zsh-autosuggestions and zsh-syntax-highlighting without relying on external framework managers.

Does this Zsh configuration support oh-my-posh and oh-my-zsh integrations?

Yes, the configuration supports optional oh-my-posh prompt integration with configurable paths. It also provides guarded plugin loading compatible with oh-my-zsh setups, allowing you to maintain a modular dotfiles-style environment alongside these tools.

Can I add work-specific environment overrides to my Zsh configuration?

Yes, you can add work-specific overrides by creating a .zshrc_work file in your Zsh configuration directory. This file allows you to separate sensitive or job-specific environment variables and aliases from your base dotfiles without affecting your standard setup.

Why use XDG-compliant paths for shell environment configuration?

Using XDG-compliant paths for shell configuration keeps your home directory clean by storing files under ~/.config/zsh/ instead of cluttering it with hidden dotfiles. This standard simplifies backup, version control, and modular plugin management across Unix-like systems.

How do I apply changes after updating my Zsh configuration files?

Apply changes to your Zsh configuration by either starting a new terminal session or sourcing the ~/.config/zsh/.zshrc file directly. This reloads your environment variables, plugin submodules, and any work-specific overrides immediately.