From b8faa73fca351e41f4132fc5091516e38accc964 Mon Sep 17 00:00:00 2001 From: Willie Hung Date: Fri, 16 Jan 2026 00:59:53 +0800 Subject: [PATCH] docs: add FAQ about target remove safety --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index 1a96c3236..2cb568647 100644 --- a/README.md +++ b/README.md @@ -420,6 +420,24 @@ cd ~/.config/skillshare/skills git checkout -- deleted-skill/ ``` +**How does `target remove` work? Is it safe?** + +Yes, it's safe. The mechanism depends on sync mode: + +- **Symlink mode**: Removes the symlink and copies source contents back to target +- **Merge mode**: Only removes symlinks pointing to source, copies them back as real files, preserves local-only skills + +``` +target remove claude + │ + ├─► Backup target first + ├─► Detect sync mode + ├─► Unlink (symlink → copy back) + └─► Remove from config.yaml +``` + +This is why `skillshare target remove` is safe, while `rm -rf ~/.claude/skills` would delete your source files. + ## Common Issues - Seeing `config not found: run 'skillshare init' first`: run `skillshare init` (add `--source` if you want a custom path).