skillshare v0.19.17 Release Notes

Release date: 2026-05-22

TL;DR

1. doctor warns on overlapping skill paths — surfaces two new check classes that catch duplicate-skill issues before they reach the runtime picker
2. sync prints a one-line overlap hint — same detection runs after every sync (CLI and Web UI), pointing back to doctor for the full breakdown
3. cline target path restored to ~/.cline/skills — reverted from the briefly-used shared ~/.agents/skills location to match cline's official documentation

doctor Path Overlap Checks

skillshare doctor now flags two classes of duplicate-skill risk:

Shared target paths — two or more enabled targets resolve to the same primary path. The classic case: enabling both universal and a tool whose default path is also ~/.agents/skills (e.g. warp, witsy). Same content written twice, runtime picker sees duplicates.

! Shared path ~/.agents/skills ← universal, warp

Cross-runtime discovery — an enabled target's runtime is documented to also scan a directory another enabled target writes to. For example, Codex Desktop reads ~/.agents/skills in addition to its primary ~/.codex/skills. Enabling both codex and universal is fine for distribution, but Codex's picker will show universal's skills alongside its own.

! codex will see content from: universal
    ~/.agents/skills ← universal

Both checks are pure metadata — no filesystem probing, no runtime calls. They read the targets you have enabled, the paths they write to, and a built-in table of which runtimes scan which extra directories.

Resolution depends on your intent: disable one of the overlapping targets, point a target at a distinct path (skillshare target <name> --path <dir>), or accept the overlap if the duplicate listings are acceptable. Refs: #135

One-line Overlap Hint After Sync

The same detection runs at the end of every sync and emits a single line when there's a problem:

✔ Sync complete: 3 targets, 6 linked
! Skill path overlap across 2 target(s) — run `skillshare doctor` for details

The hint is quiet by design — nothing prints when there is no overlap. The detail breakdown stays in doctor to keep sync output short.

The same warning appears in the Web UI Sync page (skillshare ui) — the existing warnings card now picks up overlap entries automatically.

cline Target Path Reverted

The cline target was briefly pointing at the shared ~/.agents/skills root, which doesn't match cline's official documentation. v0.19.17 restores the brand-specific paths:

• Global: ~/.cline/skills
• Project: .cline/skills

If you synced cline between v0.19.14 and v0.19.16, re-run skillshare sync to move skills to the correct location. The previously-written ~/.agents/skills content stays in place — clean it up manually if you no longer need it there.

Changelog

• d364edd chore: release v0.19.17
• 88a1bd5 feat(doctor): warn on shared paths and cross-target discovery
• 4d70119 feat(sync): warn on skill path overlap with one-line hint
• f01a679 fix(targets): revert cline paths to brand-specific dirs