🛠️ skillshare v0.18.3 Release Notes

Release date: 2026-03-29

TL;DR

Enable / Disable — new commands + TUI E key + Web UI button to temporarily hide skills from sync
Skills sub-key — target configs support a dedicated skills sub-key with auto-migration
Upgrade auto-sudo — no more manual sudo skillshare upgrade for protected install paths (#105)
Diff fix — diff no longer shows false "source only" items for skills with unsupported targets values
Collect fixes — correct mode inheritance and stale manifest handling

Enable / Disable Skills

Two new commands let you temporarily hide skills from sync without uninstalling them:

skillshare disable draft-*        # adds pattern to .skillignore
skillshare enable draft-*         # removes pattern from .skillignore

Disabled skills stay in your source directory but are excluded from sync and collect. Both commands support --project / --global mode and --dry-run preview.

In the interactive skillshare list TUI, press E to toggle the selected skill on or off without leaving the interface. The Skill Detail page in the Web UI also has a toggle button, backed by new REST API endpoints.

After toggling, run skillshare sync to apply the change to targets.

Target Config — Skills Sub-Key

Target configurations now support a nested skills sub-key with its own path, mode, include, and exclude settings. This gives you explicit control over skill-specific sync behavior per target, separate from the top-level target config.

Existing configs using flat fields are auto-migrated to the new structure on first load — no manual editing required.

Upgrade Auto-Sudo

skillshare upgrade now checks write permissions on the binary's directory before attempting the upgrade. If the directory is protected (e.g., /usr/local/bin), the CLI transparently re-executes itself with sudo. No more "permission denied" errors — just a sudo password prompt when needed.

Diff Fix

diff (CLI, TUI, and Web UI) now applies the same SKILL.md targets field filtering as sync. Previously, skills with unsupported targets values (e.g., targets: ["*"]) appeared as "source only" pending items, and running sync wouldn't resolve them — causing confusion. These skills are now correctly excluded from the diff results.

Other Bug Fixes

Fixed mode inheritance in collect: when a target inherits its sync mode from the global config, collect now resolves the effective mode correctly instead of defaulting to merge
Fixed stale manifest in collect: after switching a target from copy to merge mode, collect no longer skips local skills because of a leftover manifest
Fixed pull showing git stash in its info message instead of git stash -u
Config migration now uses atomic write-to-temp + rename to prevent file corruption on disk errors

Changelog

7a247dd chore(schemas/ui): update JSON schemas and fieldDocs for skills/agents format
9f7181a chore: update readme
8258f8b feat(config): add skills/agents sub-keys to TargetConfig with auto-migration
cc2f0ee feat(list-tui): show disabled skills with E key toggle
14c2b9e feat(skillignore): add AddPattern/RemovePattern/HasPattern helpers
f51cc81 feat(sync): add DiscoverSourceSkillsAll with Disabled field
7125a25 feat(upgrade): auto-detect sudo requirement for CLI upgrade
af1f62b feat: add enable/disable API, UI button, and disabled field
a3459f4 feat: add enable/disable CLI commands
18fac69 fix(collect): resolve inherited mode and stale manifest on copy→merge switch
fe44ffa fix(config): use atomic write-to-temp + rename for migration persistence
1016a15 fix(diff): filter out skills with SKILL.md targets mismatch
43f99e7 fix(pull): update info message from git stash to git stash -u
80f5266 fix(ui): replace --- text with full-width hr in analyze tooltip
8c65881 fix(upgrade): split unix-only sudo code behind build tags for Windows compat
9d38216 refactor(config): update project filter test to use SkillsConfig()
3b5571f refactor(config): use 2-space YAML indentation for all config output
41dd81b refactor: migrate all callers to SkillsConfig() / EnsureSkills()
e0d0313 refactor: simplify enable/disable after code review

Notes

Full changelog: https://github.com/runkids/skillshare/blob/main/CHANGELOG.md
Security model docs: https://skillshare.runkids.cc/docs/guides/security
Command reference: https://skillshare.runkids.cc/docs/commands

Contributors

@kevincobain2000

runkids/skillshare v0.18.3 on GitHub