🔍 skillshare v0.16.6 Release Notes

Release date: 2026-03-02

TL;DR

v0.16.6 is a diff enhancement and TUI expansion release:

diff interactive TUI — split-panel bubbletea interface with fuzzy filter and file-level detail
diff --patch / --stat — unified text diffs and per-file change summaries
Glob pattern matching — install, update, uninstall accept *, ?, [...] patterns
trash TUI — multi-select interactive list with restore/delete/empty and SKILL.md preview
restore TUI — two-phase target picker → version list with detail panel
Homebrew-aware version check — no more false "update available" for Homebrew users
Built-in devcontainer skill — teaches AI assistants to use the devcontainer

What's New

1) `diff` Interactive TUI

skillshare diff now launches a full-screen bubbletea TUI by default:

Left panel: Target list with status icons (✓ synced, ! drifted, ✗ missing)
Right panel: Categorized file-level diffs for the selected target
Controls: / to filter, Ctrl+d/u to scroll details, q to quit
Falls back to plain text on non-TTY or with --no-tui

2) `diff --patch` and `--stat`

Two new flags for non-interactive inspection:

# Show unified text diff for every changed file
skillshare diff --patch

# Show per-file change summary (added/removed line counts)
skillshare diff --stat

Both flags imply --no-tui and print directly to stdout.

3) `diff` File-Level Detail

Diff entries now go beyond target-level to show individual file changes:

Per-file categorization: added (+), removed (−), modified (≠), renamed (→)
Source paths and modification times
Statistics summary line at the end of each run (e.g., 3 added, 1 modified, 2 removed)

4) Glob Pattern Matching

install, update, and uninstall now support glob patterns in skill name arguments:

# Install only matching skills from a repo
skillshare install runkids/my-skills -s "core-*"

# Update all team skills
skillshare update "team-*"

# Uninstall by pattern
skillshare uninstall "old-??"

Matching is case-insensitive. Supports *, ?, and [...] character classes.

5) `trash` Interactive TUI

skillshare trash now launches an interactive TUI:

Multi-select with checkboxes for batch operations
Fuzzy filter to search through trashed skills
Inline actions: restore, delete, empty all
Detail panel shows SKILL.md preview (first 15 lines) for content inspection

6) `restore` Interactive TUI

skillshare restore (with no arguments) launches a two-phase interactive flow:

Phase 1: Pick a target from targets with available backups
Phase 2: Select a backup version with left-right split panel

The detail panel shows skill diffs and descriptions to help decide which version to restore. Also adds --help flag and a delete-backup action from within the TUI.

7) `backup` Improvements

Lists available backup versions per target
Correctly follows top-level symlinks in merge-mode targets (previously produced empty backups)

8) Homebrew-Aware Version Check

Homebrew formula updates often lag GitHub Releases by hours or days. Previously, Homebrew users would see "update available" when brew upgrade said they were already current.

Now skillshare detects the install method from the executable path:

Homebrew installs: queries brew info --json=v2 for the latest version
Direct downloads: continues using the GitHub Release API
doctor and post-command update checks show the correct upgrade command

9) Devcontainer Skill

New built-in skill (devcontainer) that teaches AI assistants:

When to run commands inside the devcontainer vs. on the host
How to use docker exec for isolated testing
Credential-helper management for test isolation
Web UI debugging inside the container

10) UX Polish

All destructive action confirmations (delete, empty, uninstall) now render in red text across trash, restore, and list TUIs for visual safety

Bug Fixes

backup/restore mode flags — -g and -p flags now work correctly; previously -g was misinterpreted as a target name due to missing parseModeArgs()
diff hides .skillshare-meta.json — internal metadata file is no longer shown in file-level diff output
diff --stat implies --no-tui — --stat now correctly skips the TUI

Upgrading

# Homebrew
brew upgrade skillshare

# Direct download
skillshare upgrade

# Or download from GitHub Releases
# https://github.com/runkids/skillshare/releases/tag/v0.16.6

Changelog

ec60453 chore: update docs
7bdb9a4 deps: upgrade sergi/go-diff to v1.4.0 for text diff support
e48a019 docs(diff): update docs for TUI, --stat, --patch, new category labels
2bcd2bf feat(backup): add ListTargetsWithBackups for TUI discovery
71dea4e feat(backup): add version listing and follow top-level symlinks
c72ab5f feat(diff): add --patch and --stat flags with file stat, time info, and unified diff
924487b feat(diff): add file list, text diff, and time info to TUI detail panel
398e0bf feat(diff): add file-level diff engine for skill content comparison
27e5c3a feat(diff): add interactive bubbletea TUI with left-right panel layout
7a22b78 feat(diff): async expand with spinner and support all diff types
c59498b feat(diff): extend diff entries with file-level data, source paths, and mtime
6fea949 feat(diff): redesign labels with git-style symbols and add statistics summary
c5be126 feat(install,update,uninstall): add glob pattern matching for skill names
102b9e3 feat(restore): add --help flag and delete backup from TUI
995eb11 feat(restore): add unified Backup Restore TUI
b371050 feat(skills): add devcontainer skill for AI-guided container execution
3e94539 feat(trash): add SKILL.md preview to TUI detail panel
b2af4f4 feat(trash): add interactive TUI for trash list
6d90481 feat(tui): add red text to all destructive action confirmations
8a37748 feat(version): Homebrew-aware version check
f5a8166 fix(backup,restore): handle -g/-p mode flags correctly
20411ed fix(diff): hide .skillshare-meta.json from file-level diff and make --stat imply --no-tui
d8fb76d fix(restore): handle ReadDir error to prevent accidental backup deletion
ae16181 refactor(auth): consolidate duplicated auth infra and fix GH_TOKEN gap
ada5396 refactor(diff): address code review findings
30458e7 refactor(skill): rewrite built-in SKILL.md from reference manual to recipe-driven guide
d2883e5 refactor(tui): consolidate duplicated utilities and cache detail rendering
13744f8 refactor: consolidate duplicated utilities and simplify diff API
6a90454 test(diff): add integration tests for file stat, patch, new labels, summary

runkids/skillshare v0.16.6 on GitHub

🔍 skillshare v0.16.6 Release Notes

TL;DR

What's New

1) diff Interactive TUI

2) diff --patch and --stat

3) diff File-Level Detail