skillshare v0.11.6 Release Notes

Release date: 2026-02-11

TL;DR

v0.11.6 makes cross-machine setup seamless — init --remote now handles everything automatically:

1. Auto-pull — remote skills are fetched during init, no manual git commands needed
2. Clean git history — second machine gets a linear history identical to the remote
3. Error hints — SSH, network, and identity issues get actionable fix suggestions
4. Sandbox improvements — --bare mode and --volumes reset for faster iteration

Why These Changes

Cross-machine setup required too many manual steps

The promise of skillshare init --remote <url> was "run one command on a new machine and you're done." In practice, users hit multiple friction points:

• git pull failed with "Local changes detected" (uncommitted .gitignore)
• Git identity not configured → silent commit failure
• merge.ff=only (modern Git default) blocked the merge
• Unrelated histories created ugly merge commits

All of these are now handled automatically. The second machine experience is truly one command.

Docker sandbox needed more flexibility

Testing init flows required destroying and recreating containers. --bare mode skips auto-init so you can test init manually. --volumes reset clears persistent state without rebuilding the image.

New Features

Seamless cross-machine init

First machine — push skills to remote:

skillshare init --remote git@github.com:you/my-skills.git
skillshare push

Second machine — one command, everything synced:

skillshare init --remote git@github.com:you/my-skills.git
# → Creates source, inits git, fetches remote, resets to remote HEAD
# → Detects and configures local AI CLI targets
# → Ready to use immediately

Behind the scenes:

1. Creates source directory and initializes git with an initial commit
2. Adds remote and runs git fetch
3. Detects remote has skills → resets local to match remote
4. Sets up tracking branch for future push/pull
5. Auto-detects and configures local targets

Git identity fallback

If user.name / user.email aren't configured (common on fresh machines and Docker), skillshare sets a repo-local fallback identity and shows a hint:

ℹ Git identity not configured, using local default
  Set yours: git config --global user.name "Your Name"
             git config --global user.email "you@example.com"

Actionable git error hints

Push, pull, and init now detect common git errors and suggest fixes:

✗ Push failed
  Check SSH keys: ssh -T git@github.com
  Or use HTTPS:   git remote set-url origin https://github.com/you/repo.git

Covers: SSH authentication, remote URL not found, network connectivity.

Docker sandbox improvements

make sandbox-bare     # Start playground without auto-init
make sandbox-reset    # Stop + remove volume (full reset)

--bare is useful for testing the init flow from scratch. --volumes ensures no stale state persists between test runs.

Important Changes

• init --remote in project directories — previously, running init --remote from a directory with .skillshare/config.yaml would fail with "unknown option." Global-only flags now correctly bypass project-mode auto-detection. Use -g or -p to be explicit if needed.
• Target selection display — multi-select labels shortened from full paths to name (status). Paths are shown during the detection phase above the prompt.
• Pro tip conditional — the "Let AI manage your skills!" hint only appears when the built-in skill is installed.

Upgrade Notes

No breaking changes. This release is primarily UX improvements for init and cross-machine workflows.

If you previously had issues with init --remote, simply re-run:

rm -rf ~/.config/skillshare    # clean slate (or backup first)
skillshare init --remote git@github.com:you/my-skills.git
skillshare sync

Changelog

• 1939a31 feat: auto-commit and auto-pull on init, improve git UX
• 1b162dd fix: shorten target multi-select labels for readability
• f03049558a2f377b001f6bcb2832d20b8edca6e5 fix: use git reset for clean history on init --remote, skip project auto-detect for global flags