dotfiles

ryugen04's avatarfrom ryugen04

Use when managing dotfiles repository. Triggers: (1) checking dotfiles structure or package list, (2) adding or removing packages, (3) setting up dotfiles on new machine, (4) syncing changes from other machines, (5) stow command usage questions.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026
[Developer Tools]

When & Why to Use This Skill

This Claude skill automates the management of dotfiles repositories, providing a streamlined workflow for environment configuration. It helps developers maintain consistent setups across multiple machines by handling package installations, synchronization, and symlinking via GNU Stow. By leveraging automated scripts and structured maintenance guidelines, it eliminates the manual overhead of system personalization and ensures a reproducible development environment.

Use Cases

  • New Machine Setup: Automatically installing and configuring all necessary tools and shell environments on a fresh OS installation using the integrated setup scripts.
  • Cross-Platform Syncing: Synchronizing configuration changes (like .zshrc, .vimrc, or SSH configs) across different workstations to ensure a seamless and unified coding experience.
  • Package Management: Adding, removing, or updating software packages within the dotfiles structure while maintaining a clean and organized repository.
  • Configuration Debugging: Using the skill to troubleshoot GNU Stow symlink issues or verify installation steps through dry-run commands before applying changes.
  • MCP Server Integration: Automating the installation and configuration of MCP (Model Context Protocol) servers to enhance the local AI development environment.
namedotfiles
descriptionUse when managing dotfiles repository. Triggers: (1) checking dotfiles structure or package list, (2) adding or removing packages, (3) setting up dotfiles on new machine, (4) syncing changes from other machines, (5) stow command usage questions.

dotfiles 管理スキル

実行方法

パッケージ操作やセットアップはsubagentを起動して実行すること。 構成調査が必要な場合はGemini MCPに委託する。

関連ドキュメント

  • @structure.md - リポジトリ構成
  • @maintenance.md - メンテナンス方針
  • @sync.md - 更新の取り込み
  • @setup.md - 新規PCセットアップ

クイックリファレンス

よく使うコマンド

# 全パッケージをインストール
./install.sh

# 特定パッケージのみ
./install.sh shell nvim

# ドライラン（変更確認）
./install.sh -n

# パッケージ削除
./install.sh -D shell

# MCPサーバーインストール
~/.claude/scripts/install-mcp.sh

パッケージ追加手順

  1. packages/<name>/ ディレクトリ作成
  2. ホームディレクトリからの相対パスで配置
  3. ./install.sh <name> で適用