add-app-config
Use when adding configuration for a new application to the dotfiles, setting up a new tool's config, or when user says "add config for X"
When & Why to Use This Skill
This Claude skill automates the management of application configurations within a dotfiles repository. It streamlines the developer workflow by handling directory creation, managing symlinks via GNU Stow, and ensuring consistent UI theming across tools, which facilitates a reproducible and highly organized development environment.
Use Cases
- Scenario 1: Adding a new tool (e.g., Fuzzel or Neovim) to a centralized dotfiles system with automated symlinking to the home directory.
- Scenario 2: Migrating existing local application settings into a version-controlled 'Juliet' dotfiles structure to prevent configuration loss.
- Scenario 3: Standardizing visual aesthetics across multiple CLI and GUI applications by automatically applying the Bamboo theme during the setup process.
| name | add-app-config |
|---|---|
| description | Use when adding configuration for a new application to the dotfiles, setting up a new tool's config, or when user says "add config for X" |
Add App Configuration
Add a new application's configuration to Juliet dotfiles with proper stow symlinks.
Process
Create config directory
mkdir -p ~/.config/Juliet/symlinked/config/<app-name>/Add configuration files
- Create config files inside
symlinked/config/<app-name>/ - Use the app's expected filenames (e.g.,
config,config.toml,settings.json)
- Create config files inside
Run stow to create symlinks
stow --target=$HOME/.config --dir=$HOME/.config/Juliet/symlinked configApply Bamboo theme (if applicable)
- Check if app supports Bamboo theme
- Apply consistent colors: dark green-tinted background, soft white foreground
- Document theme setting in
.claude/rules/theming.md
Pre-flight Check
Before creating, verify the target doesn't already exist:
ls -la ~/.config/<app-name>
If it exists and is NOT a symlink, back it up first:
mv ~/.config/<app-name> ~/.config/<app-name>.backup
Example: Adding Fuzzel Config
# Create directory
mkdir -p ~/.config/Juliet/symlinked/config/fuzzel/
# Create config file
# (write fuzzel.ini content)
# Stow it
stow --target=$HOME/.config --dir=$HOME/.config/Juliet/symlinked config
# Verify
ls -la ~/.config/fuzzel # Should show symlink to Juliet
Common Mistakes
- Creating files directly in
~/.config/instead ofsymlinked/config/ - Forgetting to run
stowafter adding files - Not checking if target folder already exists (could overwrite user data)