skillshare v0.25.4 Release Notes

TL;DR

1. Same-named skills from different tracked repos can both reach a tool. Copy-mode targets accept target_naming: prefixed, which names a tracked skill <repo>-<name>.
2. Targets that share a skills folder and undo each other are reported, now also when their mode or naming differs, and the dashboard shows the clash where you change it.
3. A skills source folder named .skillshare or .claude is read again. Since 0.24.4 it was skipped as a whole, so list was empty and sync removed links.
4. Moving an installed skill to another folder keeps its source, and install <path> --track takes a local git repository.

Prefixed target naming

Under standard naming, two tracked repos that each ship a prototype skill collide, and one of them is skipped. With prefixed, each skill inside a tracked repo is named <repo>-<name>, in the copied folder and in the copy's name:, so both reach the tool. A name that already starts with the repo name is not prefixed again (_bmad/skills/bmad-ux stays bmad-ux). Local skills keep their standard name, and the source is never changed.

skillshare target claude --mode copy --target-naming prefixed
skillshare sync

• It works in copy mode only. A target that resolves to prefixed outside copy mode fails validation; status, doctor and target list flag it before you sync, and target add gives a new target copy mode when it would inherit prefixed.
• Switching between flat, standard and prefixed renames managed entries in place and copies them again so their name: matches. If a local skill already holds the new name, the skill stays under its old entry and diff says so.
• The dashboard, the TUI naming picker and the JSON schemas offer prefixed; the dashboard disables it outside copy mode and says why.

Shared skills folders

Two targets that write the same skills folder with a different mode or naming undo each other on every sync. Only include and exclude were compared before, so this got the generic shared-folder hint. sync and doctor now warn that the settings differ, and the dashboard's target page warns under the control whose change causes it and offers the other target's value. The Sync page's notice lists which settings differ.

Sources

• A skills source folder named like a tool folder is read again. Since 0.24.4, a sources.skills folder whose own name is a target folder name, such as .skillshare or .claude, was skipped as a whole: list showed no skills and sync removed links it had made before. Folders with those names inside the source are still skipped. (#511)
• An agents source in a hidden folder is read. A sources.agents folder such as ~/.agents found no agents.

Install and collect

• Moving an installed skill keeps its source. After an installed skill was moved with mv, for example into a group folder, the dashboard's Install missing and a bare skillshare install installed it again at its old path, leaving two copies that both synced. They now recognize the moved copy (same name, files unchanged since install, only one such copy) and move its install record to the new folder. (#510)
• install <path> --track accepts a local git repository, including a bare one, and clones it like file:///path.

  skillshare install ~/code/team-skills --track

• install --track --force keeps the existing repo until the new clone is in place, so a failed clone no longer loses it.
• collect picks up only skills. Folders without a SKILL.md are left out.

Smaller changes

• Switching a target from copy back to merge replaces its copies with links, except copies you edited and folders you made yourself, which are kept until sync --force.
• A SKILL.md that starts with a UTF-8 BOM is read, so files saved by Notepad keep their name and are no longer flagged by audit as hidden Unicode.
• target <name> --mode copy --target-naming standard applies both flags; only --mode was saved before.
• Skills skipped by naming checks are listed with their reason, and the duplicate-name line no longer prints on every sync.
• AGENTS.md targets update immediately in the dashboard after a target or config.yaml change.
• Tighter Skills toolbar and a pinned Hub header in the dashboard.