Auto-update removes user symlinks from ~/.claude/skills/
Resolved 💬 4 comments Opened Apr 17, 2026 by rridolfo Closed May 31, 2026
Bug
Claude Code auto-updates silently remove symlinked skill directories from ~/.claude/skills/. Real directories in the same location survive updates, but symlinks are lost.
Reproduction
- Create a custom skill in a separate repo/directory (e.g.
~/code/claude-skills/coding-rich/SKILL.md) - Symlink it into the skills directory:
``bash``
ln -s ~/code/claude-skills/coding-rich ~/.claude/skills/coding-rich
- Verify the skill loads in Claude Code sessions — works correctly
- Wait for Claude Code to auto-update (daily)
- After the update,
~/.claude/skills/coding-richsymlink is gone
Evidence
~/.claude/skills/qwen-draft/(real directory) — survived months of updates~/.claude/skills/coding-rich(symlink →~/code/claude-skills/coding-rich) — removed at some point during updates- Both were created at the same time (April 9, 2026) and the symlink worked for weeks before silently disappearing
Expected behavior
User-created symlinks in ~/.claude/skills/ should be preserved across auto-updates, just like real directories are.
Impact
Custom skills with description: "Apply this skill for ALL coding tasks" silently stop loading. There's no warning or error — the skill just disappears from the available-skills list. The user has no way to know it's broken until they notice degraded output quality.
Environment
- macOS (Apple Silicon)
- Claude Code (latest, auto-updating daily)
- Skills directory:
~/.claude/skills/
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗