feat: remove ss symlink, add alias docs

- Remove automatic ss symlink creation from install.sh and upgrade
- Add optional alias setup instructions to README
- Update skill version to 0.6.4
This commit is contained in:
Willie Hung
2026-01-21 01:11:30 +08:00
parent f2aa06e729
commit f60d46c4f5
6 changed files with 18 additions and 56 deletions
+11 -5
View File
@@ -67,8 +67,6 @@ AI reads skillshare skill → runs: skillshare sync
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
```
> **Shorthand:** After install, use `ss` instead of `skillshare` (e.g., `ss status`)
### Homebrew (macOS)
```bash
@@ -78,9 +76,17 @@ brew install runkids/tap/skillshare
### Uninstall
```bash
brew uninstall skillshare # Homebrew
sudo rm /usr/local/bin/skillshare /usr/local/bin/ss # Manual install
rm -rf ~/.config/skillshare # Config & data (optional)
brew uninstall skillshare # Homebrew
sudo rm /usr/local/bin/skillshare # Manual install
rm -rf ~/.config/skillshare # Config & data (optional)
```
### Shorthand (Optional)
Add an alias to your shell config (`~/.zshrc` or `~/.bashrc`):
```bash
alias ss='skillshare'
```
## Quick Start
+1 -36
View File
@@ -95,12 +95,7 @@ func upgradeCLIBinary(dryRun, force bool) error {
return nil
}
ui.Info("Running: brew upgrade runkids/tap/skillshare")
if err := runBrewUpgrade(); err != nil {
return err
}
// Ensure symlink after brew upgrade
ensureShorthandSymlink(execPath)
return nil
return runBrewUpgrade()
}
// Get current version
@@ -117,8 +112,6 @@ func upgradeCLIBinary(dryRun, force bool) error {
if currentVersion == latestVersion && !force {
ui.Success("Already up to date")
// Still ensure symlink exists
ensureShorthandSymlink(execPath)
return nil
}
@@ -145,9 +138,6 @@ func upgradeCLIBinary(dryRun, force bool) error {
return fmt.Errorf("failed to upgrade: %w", err)
}
// Create ss symlink
ensureShorthandSymlink(execPath)
ui.Success("Upgraded to %s", latestVersion)
return nil
}
@@ -359,28 +349,3 @@ Examples:
skillshare upgrade --skill # Upgrade skill only
skillshare upgrade --dry-run # Preview upgrades`)
}
// ensureShorthandSymlink creates ss -> skillshare symlink if not exists
func ensureShorthandSymlink(skillsharePath string) {
dir := filepath.Dir(skillsharePath)
ssPath := filepath.Join(dir, "ss")
// Check if ss already exists and points to skillshare
if target, err := os.Readlink(ssPath); err == nil {
if filepath.Base(target) == "skillshare" {
return // Already correct
}
}
// Remove existing ss (file or wrong symlink)
os.Remove(ssPath)
// Create symlink
if err := os.Symlink(skillsharePath, ssPath); err != nil {
// Try with sudo hint
ui.Warning("Could not create 'ss' shorthand: %v", err)
ui.Info(" Run: sudo ln -sf %s %s", skillsharePath, ssPath)
} else {
ui.Success("Created 'ss' shorthand")
}
}
+2 -10
View File
@@ -83,13 +83,6 @@ install() {
fi
chmod +x "$INSTALL_DIR/$BINARY_NAME"
# Create shorthand symlink (ss -> skillshare)
if [ -w "$INSTALL_DIR" ]; then
ln -sf "$INSTALL_DIR/$BINARY_NAME" "$INSTALL_DIR/ss"
else
sudo ln -sf "$INSTALL_DIR/$BINARY_NAME" "$INSTALL_DIR/ss"
fi
}
# Verify installation
@@ -97,13 +90,12 @@ verify() {
if command -v "$BINARY_NAME" >/dev/null 2>&1; then
info ""
info "Successfully installed skillshare to $INSTALL_DIR/$BINARY_NAME"
info "Shorthand 'ss' also available"
info ""
"$BINARY_NAME" version
info ""
info "Get started:"
info " ss init # Initialize (or: skillshare init)"
info " ss --help # Show help"
info " skillshare init"
info " skillshare --help"
else
warn "Installed but '$BINARY_NAME' not in PATH. Add $INSTALL_DIR to your PATH."
fi
+1 -3
View File
@@ -1,14 +1,12 @@
---
name: skillshare
version: 0.6.3
version: 0.6.4
description: Syncs skills across AI CLI tools from a single source of truth. Use when asked to "sync skills", "pull skills", "show status", "list skills", "install skill", "initialize skillshare", or manage skill targets.
argument-hint: "[command] [target] [--dry-run]"
---
# Skillshare CLI
> **Shorthand:** `ss` = `skillshare` (e.g., `ss status`, `ss sync`)
```
Source: ~/.config/skillshare/skills ← Edit here (single source of truth)
↓ sync
+2 -2
View File
@@ -17,8 +17,8 @@ Targets:
cursor ⚠ 1 diff ~/.cursor/skills
Version:
✓ CLI: 0.6.3
✓ Skill: 0.6.3 (up to date)
✓ CLI: 0.6.4
✓ Skill: 0.6.4 (up to date)
```
## diff
+1
View File
@@ -118,3 +118,4 @@ targets: {}
// Source is github.com/runkids/skillshare/skills/skillshare
result.AssertOutputContains(t, "github.com/runkids/skillshare")
}