Release Highlights

skillshare v0.20.23 Release Notes

TL;DR

1. Filter enabled or disabled resources from scripts — list --status now works outside the TUI, including JSON and project views.
2. Backups stay smaller and safer — synced symlinks are no longer copied, automatic retention prevents unbounded growth, and failed snapshots are discarded.
3. More accurate target diagnostics — doctor now handles relative and externally linked target directories correctly.

Filter list output by status

Use --status enabled, --status disabled, or --status all with skills or agents. The filter combines with search patterns and --type, and works in global, project, plain-text, and JSON output.

skillshare list --status disabled
skillshare list --status enabled --json
skillshare list -p agents --status disabled

Smaller, safer backups

Automatic backups now save only local target content. Synced skill links are recreated by skillshare sync, so their source content is no longer duplicated into every snapshot. The existing retention policy—10 snapshots, 30 days, and 500 MB—now runs after automatic backups.

Cleanup keeps the newest restore point even when it exceeds the size cap, and dry-run previews now match the real cleanup result. If copying a snapshot fails, the incomplete restore point is discarded instead of being listed or retained.

More accurate doctor results

doctor now resolves relative target links from the link's own directory. It also distinguishes a symlink-mode target from a copy-mode target reached through a symlink, avoiding false duplicate warnings while still detecting real duplicate copies.

Migration guide

Restoring a merge-mode target now recovers its local content only. Run sync afterward to recreate managed skill links:

skillshare restore <target>
skillshare sync

The backup directory follows the XDG data location at ~/.local/share/skillshare/backups/, not ~/.config/skillshare/backups/.

Contributors

@hhh2210