Agent skill

symlink-manage

シンボリックリンクの状態確認・再作成。リンク切れの検出と修復。トリガー: symlink, link, リンク切れ, リンク, シンボリック

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/symlink-manage

SKILL.md

symlink-manage スキル

dotfilesのシンボリックリンク管理を行う。

管理対象のシンボリックリンク

ターゲット ソース（laptop repo）
~/.zshrc zsh/.zshrc
~/.aliases zsh/.aliases
~/.zsh/ zsh/.zsh/
~/.gitconfig git/.gitconfig
~/.gitmessage git/.gitmessage
~/.gitignore git/.gitignore_global
~/.tmux.conf tmux/.tmux.conf
~/.tigrc tig/.tigrc
~/.fzf.zsh fzf/.fzf.zsh
~/.fzf.bash fzf/.fzf.bash
~/.config/ghostty/config ghostty/config
~/.config/mise/config.toml mise/config.toml
~/.claude/ claude/ (部分的)

コマンド

全symlink状態確認

bash
LAPTOP_DIR="/Users/snkrheadz/ghq/github.com/snkrheadz/laptop"

echo "=== Symlink Status ==="
declare -A SYMLINKS=(
  ["$HOME/.zshrc"]="$LAPTOP_DIR/zsh/.zshrc"
  ["$HOME/.aliases"]="$LAPTOP_DIR/zsh/.aliases"
  ["$HOME/.zsh"]="$LAPTOP_DIR/zsh/.zsh"
  ["$HOME/.gitconfig"]="$LAPTOP_DIR/git/.gitconfig"
  ["$HOME/.gitmessage"]="$LAPTOP_DIR/git/.gitmessage"
  ["$HOME/.gitignore"]="$LAPTOP_DIR/git/.gitignore_global"
  ["$HOME/.tmux.conf"]="$LAPTOP_DIR/tmux/.tmux.conf"
  ["$HOME/.tigrc"]="$LAPTOP_DIR/tig/.tigrc"
  ["$HOME/.fzf.zsh"]="$LAPTOP_DIR/fzf/.fzf.zsh"
  ["$HOME/.fzf.bash"]="$LAPTOP_DIR/fzf/.fzf.bash"
  ["$HOME/.config/ghostty/config"]="$LAPTOP_DIR/ghostty/config"
  ["$HOME/.config/mise/config.toml"]="$LAPTOP_DIR/mise/config.toml"
)

for link in "${!SYMLINKS[@]}"; do
  target="${SYMLINKS[$link]}"
  if [ -L "$link" ]; then
    actual=$(readlink "$link")
    if [ "$actual" = "$target" ]; then
      echo "[OK] $link"
    else
      echo "[WRONG TARGET] $link -> $actual (expected: $target)"
    fi
  elif [ -e "$link" ]; then
    echo "[NOT SYMLINK] $link"
  else
    echo "[MISSING] $link"
  fi
done

特定symlinkの確認

bash
ls -la ~/.zshrc
readlink ~/.zshrc

壊れたsymlinkの検出

bash
find ~ -maxdepth 3 -type l ! -exec test -e {} \; -print 2>/dev/null

symlinkの再作成（単一ファイル）

bash
# 例: ~/.zshrc の再作成
rm -f ~/.zshrc
ln -sf /Users/snkrheadz/ghq/github.com/snkrheadz/laptop/zsh/.zshrc ~/.zshrc

全symlinkの再作成（install.sh経由）

bash
cd /Users/snkrheadz/ghq/github.com/snkrheadz/laptop && ./install.sh

実行フロー

状態確認

  1. 全symlinkのステータスを確認
  2. 壊れたリンクを特定
  3. 問題のあるリンクを報告

修復

  1. 問題のあるsymlinkを特定
  2. ユーザーに確認
  3. 個別に再作成、または install.sh を推奨

使用例

  • "symlinkの状態を確認"
  • "リンク切れがないかチェック"
  • "~/.zshrcのリンクを確認"
  • "壊れたリンクを修復"
  • "symlinkを再作成"

safe_ln関数（install.shより）

install.shでは以下のsafe_ln関数を使用してsymlinkを作成:

bash
safe_ln() {
  local src="$1"
  local dest="$2"

  # 既存のシンボリックリンクまたはファイルを削除
  if [ -L "$dest" ] || [ -e "$dest" ]; then
    rm -rf "$dest"
  fi

  # 親ディレクトリを作成
  mkdir -p "$(dirname "$dest")"

  # シンボリックリンクを作成
  ln -sf "$src" "$dest"
}

注意事項

  • 既存ファイル（非symlink）がある場合、上書き前にバックアップ推奨
  • install.shを使えば全symlinkを一括で再作成可能
  • ~/.zsh/ はディレクトリ全体をsymlink
  • Claude設定は claude/ 配下のファイルを個別にsymlink

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results