Skip to content
add-app-config logo

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

SKILL.md

Full skill instructions

Add App Configuration

Add a new application's configuration to Juliet dotfiles with proper stow symlinks.

Process

  1. Create config directory

    mkdir -p ~/​.config/​Juliet/​symlinked/​config/<app-name>/
    
  2. Add configuration files

    • Create config files inside symlinked/​config/<app-name>/
    • Use the app's expected filenames (e.g., config, config.toml, settings.json)
  3. Run stow to create symlinks

    stow --target=$HOME/​.config --dir=$HOME/​.config/​Juliet/​symlinked config
    
  4. Apply 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 of symlinked/​config/
  • Forgetting to run stow after adding files
  • Not checking if target folder already exists (could overwrite user data)