add-app-config

avegancafe 的头像作者 avegancafe

在dotfiles中添加新应用程序的配置、设置新工具的配置或当用户说“为X添加配置”时使用。

📖 中文导读:在dotfiles中添加新应用程序的配置、设置新工具的配置或当用户说“为X添加配置”时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

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

  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)