dotfiles

Usage

Setting

git clone https://github.com/kohbis/dotfiles.git your-workspace/dotfiles
cd your-workspace/dotfiles
make link

Command	Description
make link	Create symbolic links
make unlink	Remove symbolic links
make relink	Recreate symbolic links (remove & create)
make help	Show available commands

Filter with F=<string> to target specific files:

make link F=vim     # only vimrc and nvim config
make unlink F=otel  # only otel-related skills

Structure

dotfiles/
├── agents/skills/   # AI skills (source of truth)
├── claude/          # Claude-specific config (agents/, etc.)
├── config/          # ~/.config/ entries
└── ...              # dotfiles (~/.bashrc, ~/.zshrc, etc.)

Skills are linked through ~/.agents/skills/ as a shared hub:

dotfiles/agents/skills/<skill>
        ↑
~/.agents/skills/<skill>
        ↑                    ↑
~/.claude/skills/<skill>  ~/.codex/skills/<skill>

Private dotfiles (optional)

Files are managed with file-level symbolic links, so files from a private repository can be integrated seamlessly.

Clone your private dotfiles into this repository's directory and make will detect and link them automatically:

git clone <dotfiles-private-repo> dotfiles-private
make link

Skills in dotfiles-private/agents/skills/ are also linked into ~/.agents/skills/ automatically.

dotfiles-private/ is excluded from this repository via .gitignore.