v0.8.1

v0.8.1

🐛 Bug Fixes

Orchestrator Skill Structure Preserved

Fixed a bug where installing skill packs with nested structure (root + children) would flatten all skills to the root directory.

Before (broken):

skills/
├── game-development/   # only root
├── 2d-games/           # flattened!
├── 3d-games/           # flattened!

After (fixed):

skills/
└── game-development/
    ├── SKILL.md
    ├── 2d-games/
    ├── 3d-games/
    └── ...

GitHub API Rate Limit Handling

• skillshare upgrade now gracefully handles API rate limits
• Uses cached version information to continue upgrades when API fails
• No more blocking error messages when rate limited

Install Script Rate Limit Fix

• install.sh now uses GitHub redirect instead of API to fetch latest version
• Avoids rate limit issues during fresh installations

✨ UX Improvements

Two-Stage Install for Skill Packs

When installing orchestrator-style skill packs, a clearer selection flow is now available:

? Install mode:
  ▸ Install entire pack  game-development + 10 children
    Select individual skills

• Install entire pack: Installs root skill with all children nested underneath
• Select individual skills: Choose specific child skills to install separately

📝 Other Changes

• Optimized built-in skillshare skill for conciseness
• Documentation updates

🔧 Installation

# macOS/Linux
brew install runkids/tap/skillshare

# Or via script
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

# Upgrade existing installation
skillshare upgrade

Changelog

• 2909030 chore(docs): modify docs
• df1c6fa docs(readme): show recent version highlights (0.6-0.8)
• e922f31 fix(install): preserve nested structure for orchestrator skills
• d084e59 fix(upgrade): gracefully handle rate limit, use cached version
• 0355d36 refactor(skill): optimize skillshare skill for conciseness

v0.8.0

⚠️ Breaking Changes

Command Rename for Clearer Symmetry

Before	After	Description
pull claude	collect claude	Collect skills from target to source
pull --all	collect --all	Collect from all targets
pull --remote	pull	Pull from git remote

New Command Structure

Remote (git)
   ↑ push    ↓ pull
Source
   ↓ sync    ↑ collect
Targets

Operation	Commands	Direction
Local sync	sync / collect	Source ↔ Targets
Remote sync	push / pull	Source ↔ Git Remote

🔧 Refactoring

Reduce cyclomatic complexity across CLI commands

Extract options structs and helper functions:

Command	Before	After
init	49	5
uninstall	39	12
list	33	12
install	28	6
search	29	~5
main	24	9
target remove	21	7
update --all	20	~10
push	19	10

Overall: 19 functions > 15 reduced to 11 (42% improvement)

Command separation

• Split pull.go into collect.go (local) and pull.go (git remote)
• Separated concerns: local sync vs remote sync

✨ Improvements

• Added spinner effects to pull and push commands
• Unified error handling with spinner feedback
• Updated help examples with practical daily workflows
• Added team workflow examples in help

📖 Migration

# Before
skillshare pull claude
skillshare pull --remote

# After
skillshare collect claude
skillshare pull

---

Changelog

• ffd019e chore(readme): add GitHub stars badge and call-to-action
• 1ae5921 chore(readme): adjust align
• 743055a chore: remove badge from README
• a739902 feat!: rename pull to collect, simplify pull for git-only
• 3201498 fix(diff,sync): improve diff clarity and fix sync --force for merge mode
• e456500 refactor: reduce cyclomatic complexity across CLI commands

Full Changelog: v0.7.0...v0.8.0

v0.7.2

Changelog

• 0f7ba6f fix(windows): improve junction error messages and path comparison

v0.7.1

Changelog

• 83bd7d4 feat(targets): add 6 new agents to supported targets

v0.7.0

Release Notes

v0.7.0 — Windows & Search 🔍

Release Date: 2026-02-01

Full Windows support and GitHub skill discovery. Find and install skills from the community with a single command.

---

✨ Highlights

🔍 Search Skills Discover skills from GitHub with interactive search. skillshare search vercel # → Select and install instantly	🪟 Full Windows Support Native Windows experience with NTFS junctions. irm .../install.ps1 | iex skillshare sync # No admin required
📝 Create Skills Scaffold new skills with proper SKILL.md template. skillshare new my-skill # → Creates SKILL.md with frontmatter	🎨 Redesigned UI Tree-style output for install, upgrade, and help. ▸ Installing anthropics/skills/pdf ├─ Cloning repository... └─ ✓ Installed: pdf

---

🔍 Search Skills

Search GitHub for skills and install them interactively:

skillshare search vercel

▸  Searching  vercel
│
├─ Found 20 skill(s)

? Select skill to install:
  react-best-practices    ★ 2.3k   OneKeyHQ/app-monorepo/.claude/skills/react-best-practices
  vercel-deploy           ★ 1.7k   quran/quran.com-frontend-next/.agents/skills/vercel-deploy
▸ moai-domain-uiux        ★ 593    modu-ai/moai-adk/.claude/skills/moai-domain-uiux

Features:

• Smart ranking — Results sorted by repository stars
• Interactive selector — Arrow keys to navigate, Enter to install
• Continuous search — Search again without restarting
• Filter forks — Only shows original repositories

Options:

Flag	Description
--list, -l	List results only, no install prompt
--json	Output as JSON (for scripting)
--limit N, -n N	Maximum results (default: 20)

skillshare search pdf --list      # List only
skillshare search react --json    # JSON output
skillshare search commit -n 5     # Limit results

Note: Requires gh auth login or GITHUB_TOKEN environment variable.

---

🪟 Full Windows Support

Windows is now a first-class citizen with native support:

Feature	Implementation
Linking	NTFS Junctions (no admin required)
Installer	PowerShell one-liner
Downloads	ZIP format support
Self-upgrade	Handles executable locking
Backup	Junction-aware copy

Install on Windows:

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

How it differs from macOS/Linux:

	macOS/Linux	Windows
Path	~/.config/skillshare/	%USERPROFILE%\.config\skillshare\
Links	Symlinks	NTFS Junctions
Archive	.tar.gz	.zip
Permissions	Standard	No admin required

---

📝 New Command: new

Create skill templates quickly:

skillshare new my-awesome-skill

Creates my-awesome-skill/SKILL.md with proper frontmatter:

---
name: my-awesome-skill
description: Description of my-awesome-skill
---

# my-awesome-skill

Your skill content here.

---

🎨 UI Improvements

Tree-Style Output

All major commands now use consistent tree-style formatting:

Install:

▸  Installing  anthropics/skills/pdf
├─ Cloning repository...
└─ ✓ Installed: pdf

Upgrade:

▸  Upgrading skillshare
├─ Current: 0.6.31
├─ Latest:  0.7.0
├─ Downloading...
└─ ✓ Upgraded to 0.7.0

Redesigned Help

   _____ __   _ ____     __
  / ___// /__(_) / /____/ /_  ____ __________
  \__ \/ //_/ / / / ___/ __ \/ __ `/ ___/ _ \
 ___/ / ,< / / / (__  ) / / / /_/ / /  /  __/
/____/_/|_/_/_/_/____/_/ /_/\__,_/_/   \___/

Sync AI CLI skills from a single source of truth.

  Workflow        init, sync, pull, push
  Skills          new, install, uninstall, update, list
  ...

---

🤖 Expanded Agent Support

Now supports 35+ AI CLI tools (up from 17):

New additions:

• OpenClaw (formerly Moltbot)
• Kimi CLI
• And 13 more community agents

Run skillshare target list --all to see all supported targets.

---

🔧 Other Improvements

• Upgrade command: GitHub token support, better rate limit handling
• Version check: Notification after commands when update available
• Init progress: Shows spinner when downloading skillshare skill
• Discovery mode: init --discover finds git subdirectories
• Force update: update --force discards local changes

---

⬆️ Upgrade

skillshare upgrade

---

Full Changelog: v0.6.0...v0.7.0

Changelog

• 1aab744 feat(search): add skillshare search command

v0.6.31

Changelog

• bf286f1 fix(upgrade): add Windows zip support
• 31a7b66 fix(upgrade): handle Windows executable locking during self-upgrade

v0.6.30

Changelog

• d9b14b4 fix(upgrade): add Windows zip support

v0.6.29

Changelog

• 829a8f8 fix(upgrade): skip skill confirmation when already installed

v0.6.28

Changelog

• f5798fc fix(upgrade): add GitHub token support and improve rate limit handling

v0.6.27

Changelog

• 4419a63 feat(upgrade): redesign upgrade command with tree-style UI
• 02730e4 fix(upgrade): add logo and show version earlier