# Skills Gotchas

## Broken symlinks cause silent failures under set -e

**Symptom:** install.sh fails with exit 1 on a broken symlink.
**Cause:** `readlink -f` on a broken symlink returns an empty string, causing comparison failure under `set -e`.
**Fix:** Remove stale symlinks before re-running install. When skills move directories (e.g., from `~/dev/claude/custom-claude-skills/` to `~/dev/claude/projects/custom-claude-skills/`), old symlinks break.

## Skills created mid-session are not available as slash commands

**Symptom:** A newly created skill doesn't appear when you type `/skillname`.
**Cause:** Skills are discovered at session start, not dynamically during the session.
**Fix:** Start a new Claude Code session to pick up newly created skills.