skillshare v0.12.6 Release Notes

Release date: 2026-02-14

TL;DR

v0.12.6 delivers three major improvements:

1. Target filters are production-ready — include / exclude now work end-to-end across sync, status, diff, doctor, API, and Web UI
2. Exclude pruning is safe and predictable — source-linked entries that become excluded are removed, while local non-symlink target folders remain untouched
3. Project diagnostics are complete — doctor now supports project mode (auto-detect and -p), with project-aware backup/trash behavior

What’s New

1) Per-target include/exclude filters (merge mode)

You can now define target-specific filters in both global and project configs:

targets:
  codex:
    path: ~/.codex/skills
    include: [codex-*, core-*]
  claude:
    path: ~/.claude/skills
    exclude: [*-experimental]

Filter behavior:

• Match is against flat skill names (for example team__frontend__ui)
• Evaluation order: include first, then exclude
• In symlink mode, filters are ignored

2) Correct prune semantics for exclude

When filter rules change and a skill is now excluded:

• If target entry is a source-linked symlink/junction created by skillshare → removed on sync
• If target entry is a local non-symlink folder created in target → preserved

This makes exclusion safe for mixed environments where local/manual target content must not be destroyed.

3) Filter-aware tooling and UI

The expected skill set is now consistently calculated with filters in:

• skillshare sync
• skillshare diff
• skillshare status
• skillshare doctor
• Web API sync/diff/targets handlers
• Web UI target/drift display

4) Web UI config now refreshes without restarting server

skillshare ui now reloads config on API requests, so a browser refresh picks up latest config.yaml changes without restarting the UI server.

5) doctor project mode support

doctor now behaves like other mode-aware commands:

skillshare doctor      # auto-detect project mode when .skillshare/config.yaml exists
skillshare doctor -p   # force project mode
skillshare doctor -g   # force global mode

Project-mode doctor also reports:

• Backups: not used in project mode
• Trash: checked from .skillshare/trash

Documentation Updates

Docs now include expanded examples and usage guidance for:

• include only
• exclude only
• include + exclude together (with precedence examples)
• Project-mode doctor behavior

Verification

Covered by:

• new unit tests for filter parsing/matching
• new integration tests for include/exclude scenarios and prune semantics
• new integration tests for doctor in project mode
• full suite run (go test ./...) passing during release preparation

Changelog

• 3d6de36 feat: add project mode support for doctor
• bd75ef8 feat: support target include/exclude filters across sync, UI, and docs