Refactored GitHub API logic into shared internal/version/github.go:
- Support GITHUB_TOKEN and GH_TOKEN environment variables
- Clear error message when rate limit exceeded with fix instructions
- Removed duplicate API code from upgrade.go and check.go
- Use tree structure (▸ → ├─ → └─) for upgrade progress
- Show CLI version and status in structured format
- Show skill status before download
- Use TreeSpinner for async operations
- Add tree structure UI (▸ → ├─ → └─) for install progress
- Add SkillBox component for displaying skill details
- Customize survey multi-select with cleaner icons (✓, ▸)
- Unify UI across all install modes (discovery, track, subdir, direct)
- Show version number in logo for install commands
- Add logo to doctor and status commands
- Quiet git clone output for cleaner experience
Replace plain text with animated spinner from pterm library:
- init: show spinner while downloading skillshare skill
- upgrade: show spinner while downloading skill
The spinner displays elapsed time and success/failure status.
Windows symlinks require admin or Developer Mode. This commit:
- Add platform-specific link creation (junction on Windows, symlink on Unix)
- Show git clone progress instead of quiet mode for better UX
- Update doctor to test link support using the new createLink function
- Add figlet-style ASCII art logo with brand yellow color
- Group commands into logical sections (Core, Skill, Target, Sync, Utilities)
- Apply color scheme: yellow commands, cyan arguments, gray examples
- Implement ANSI-aware padding for proper column alignment
- `update --all` now updates both tracked repos and skills with
.skillshare-meta.json
- Add spinner with progress indicator [1/7] for each item
- Safe update: install to temp dir first, then swap (prevents data
loss on failure)
- Show warning (yellow) instead of error (red) for update failures
- Add Spinner.Warn() method for warning state
- `skillshare new <name>` creates SKILL.md with frontmatter
- Validates skill name (lowercase, hyphens, underscores)
- Converts kebab-case to Title Case for headings
- Supports --dry-run to preview
- Update docs/targets.md with ASCII art diagram
The upgrade command replaces the binary but the current process still
runs the old version. Skip version check notification after upgrade
to avoid showing stale update prompts.
When installing from a git subdirectory (e.g., user/repo/path/to/skills),
automatically scan for multiple skills within that subdirectory. If found,
enter discovery mode to let users select which skills to install.
- Add DiscoverFromGitSubdir() for subdirectory scanning
- Add includeRoot parameter to discoverSkills() to include root SKILL.md
- Add handleGitSubdirInstall() for subdir discovery flow
- Display "root" label for root-level skills in selection UI
- Auto-install if only one skill found, prompt selection if multiple
- Check GitHub releases API for new versions (24h cache)
- Display colorful update notification when update available
- Skip check for dev builds
- Cache stored at ~/.skillshare/version-check.json
- Add PTerm library for modern CLI output
- Add internal/ui/pterm.go with spinner, box, progress bar utilities
- Add internal/git/info.go for git diff/commit info retrieval
- Update install.go with header boxes, spinners, progress bars
- Update update.go with header boxes, spinners, change summaries
- Fallback to plain text for non-TTY environments
Previously --force only skipped the warning. Now it runs
git restore . to discard uncommitted changes before git pull,
ensuring a clean sync with remote.
New features:
- Discover mode: ss init --discover to add new agents
- Version display: status/doctor show CLI and skill versions
- Shorthand: ss command (symlink to skillshare)
- 5 new agents: clawdbot, droid, kilocode, roo, windsurf
Improvements:
- Interactive arrow-key selection for init targets
- upgrade --cli creates ss symlink for existing installs
- Better error messages with --discover suggestion
- Add --discover flag to detect new agents
- Add --select flag for non-interactive mode (AI use)
- Use survey.MultiSelect for interactive target selection
- Update init.md with discover flags documentation
- Add 8 test cases for discover functionality
- Change TargetPath validation to return error when path doesn't exist
instead of just a warning
- Add sync reminder message after successful target add
- Add TestTargetPath unit tests and integration test for non-existent path
- Rename `update` command to `upgrade`
- Add CLI binary self-update from GitHub releases
- Add `--cli` and `--skill` flags to upgrade specific components
- Detect Homebrew installation and use `brew install` instead
- Refactor SKILL.md with progressive disclosure pattern
- Split references into separate files (status, sync, install, etc.)
- Move run.sh to skills/skillshare/scripts/
- Fix --update flag to auto-reinstall when git pull not possible
BREAKING CHANGE: `skillshare update` is now `skillshare upgrade`
- Show message when remote is already configured with same URL
- Show warning and hint when trying to set different remote
- Show warning when git is not initialized
- Add tests for all edge cases
When config exists and --remote is provided, only add the git remote
instead of returning an error. This enables adding remote to existing
setups without re-initialization.
Doctor now distinguishes between errors (broken symlinks, missing source)
and warnings (uncommitted git changes, duplicate skills). Summary shows
"N warning(s)" instead of "All checks passed!" when warnings exist.
Add new diagnostic checks:
- Git status: uncommitted changes, remote configuration
- Skill validation: detect skills without SKILL.md
- Broken symlinks: find invalid symlinks in targets
- Duplicate skills: warn about same skill in multiple locations
- Backup status: show last backup time
- Version check: notify if newer version available
Replace text-based number input with survey's MultiSelect widget:
- Use arrow keys to navigate
- Space to toggle selection
- Enter to confirm
This provides a more intuitive UX similar to modern CLI tools.
Support owner/repo shorthand that expands to github.com/owner/repo:
- skillshare install anthropics/skills
- skillshare install anthropics/skills/skills/pdf
This matches the UX of npm, go get, and skild for faster installs.
- uninstall: remove skills from source with confirmation prompt
- list: show installed skills with source info
- --verbose flag for detailed output
- integration tests for both commands
- README documentation
- Only auto-add target when user copies from it
- Ask user before adding other detected targets
- Detect CLI tools with parent directory (not initialized)
- Add "Sync Across Machines" section to README
- Add `skillshare target <name>` to show target details
- Add `skillshare target <name> --mode <mode>` to change target mode
- Show sync mode [merge/symlink] in status and doctor output
- Show warning when configured mode doesn't match actual state
- Fix sync to properly convert between symlink and merge modes
- Simplify module name to `skillshare`
- Remove go install option from README (incompatible with simplified module)
- Add `diff` command to show differences between source and target
- Add `backup` command for manual backup with recent backup list
- Add `doctor` command to diagnose configuration issues
- Add internal/backup package for backup functionality
- Fix diff command incorrectly showing "not linked" for symlink mode targets
- Update README with new commands documentation