installing-sublime-skills

Claude Code fails to discover skills after pulling changes due to repo drift leaving broken symlinks or outdated paths in ~/.claude/{skills,commands}/. This tool fixes skill discovery by scanning SKILL.md files, pruning dead links, and repointing symlinks to the correct content.

To fix broken symlinks for Codex skills and slash commands, run the install script to recreate idempotent symlinks under ~/.codex/skills/ and ~/.claude/commands/. It scans commands/*.md, validates SUBLIME_SKILLS_HOME, and prunes leftover links from prior deletions or renames.

You need to refresh symlinks for Sublime-Skills after adding, renaming, moving, deleting, or pulling changes to skills and command files. This recovers from repo drift by ensuring harnesses locate the latest repository content through valid symlinks.

Yes, fish shell is a required dependency to run the scripts that recreate skill symlinks in Claude Code and Codex. The scripts use fish to execute idempotent ln -sfn behavior and validate the SUBLIME_SKILLS_HOME environment variable before linking.

Yes, re-running the skill installation script after renaming files is safe because it uses idempotent ln -sfn behavior. It safely repoints symlinks and prunes broken ones from prior renames or deletions without duplicating entries, converging on the correct state.

The best way to recover from repo drift when harnesses cannot find commands is to run a script that validates SUBLIME_SKILLS_HOME, prunes broken symlinks, and repoints links under ~/.claude/{skills,commands}/ and ~/.codex/skills/ to restore harness discovery.