Why can't my tool discover skills synced by skillshare?

[runkids]

Problem

Some AI tools (e.g. Codex on macOS) cannot read symlinked skill directories. After running skillshare sync, the skills exist in the target directory but the tool doesn't discover them.

Cause

By default, skillshare uses merge mode which creates symlinks from the target directory back to your source. Some tools' file scanners don't follow symlinks, so the skills appear missing.

Solution

Switch the affected target to copy mode, which writes real files instead of symlinks:

skillshare target <name> --mode copy
skillshare sync

For example, for Codex:

skillshare target codex --mode copy
skillshare sync

You can also run skillshare doctor to check for symlink compatibility hints.

Learn more

• Sync Modes documentation