Update skills
This commit is contained in:
admin
@@ -1,108 +1,90 @@
|
||||
---
|
||||
name: skillshare
|
||||
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.
|
||||
version: 0.8.2
|
||||
description: |
|
||||
Syncs skills across AI CLI tools (Claude, Cursor, Windsurf, etc.) from a single source of truth.
|
||||
Use when: "sync skills", "install skill", "search skills", "list skills", "show skill status",
|
||||
"backup skills", "restore skills", "update skills", "new skill", "collect skills",
|
||||
"push/pull skills", "add/remove target", "find a skill for X", "is there a skill that can...",
|
||||
"how do I do X with skills", "skillshare init", "skillshare upgrade", "skill not syncing",
|
||||
"diagnose skillshare", "doctor", or any skill/target management across AI tools.
|
||||
argument-hint: "[command] [target] [--dry-run]"
|
||||
---
|
||||
|
||||
# Skillshare CLI
|
||||
|
||||
```
|
||||
Source: ~/.config/skillshare/skills ← Edit here (single source of truth)
|
||||
↓ sync
|
||||
Targets: ~/.claude/skills, ~/.cursor/skills, ... ← Symlinked from source
|
||||
Source: ~/.config/skillshare/skills ← Single source of truth
|
||||
↓ sync (symlinks)
|
||||
Targets: ~/.claude/skills, ~/.cursor/skills, ...
|
||||
```
|
||||
|
||||
## Quick Reference
|
||||
## Quick Start
|
||||
|
||||
```bash
|
||||
skillshare status # Always run first
|
||||
skillshare sync # Push to all targets
|
||||
skillshare sync --dry-run # Preview changes
|
||||
skillshare pull claude # Import from target → source
|
||||
skillshare list # Show skills and tracked repos
|
||||
skillshare status # Check state
|
||||
skillshare sync --dry-run # Preview
|
||||
skillshare sync # Execute
|
||||
```
|
||||
|
||||
## Command Patterns
|
||||
## Commands
|
||||
|
||||
| Intent | Command |
|
||||
|--------|---------|
|
||||
| Sync skills | `skillshare sync` |
|
||||
| Preview first | `skillshare sync --dry-run` then `sync` |
|
||||
| Create new skill | `skillshare new <name>` then `sync` |
|
||||
| Pull from target | `skillshare pull <name>` then `sync` |
|
||||
| Install skill | `skillshare install <source>` then `sync` |
|
||||
| Install from repo (browse) | `skillshare install owner/repo` (discovery mode) |
|
||||
| Install team repo | `skillshare install <git-url> --track` then `sync` |
|
||||
| Update skill/repo | `skillshare update <name>` then `sync` |
|
||||
| Update all tracked | `skillshare update --all` then `sync` |
|
||||
| Remove skill | `skillshare uninstall <name>` then `sync` |
|
||||
| List skills | `skillshare list` or `list --verbose` |
|
||||
| Cross-machine push | `skillshare push -m "message"` |
|
||||
| Cross-machine pull | `skillshare pull --remote` |
|
||||
| Backup/restore | `skillshare backup --list`, `restore <target>` |
|
||||
| Add custom target | `skillshare target add <name> <path>` |
|
||||
| Change sync mode | `skillshare target <name> --mode merge\|symlink` |
|
||||
| Upgrade CLI/skill | `skillshare upgrade` |
|
||||
| Diagnose issues | `skillshare doctor` |
|
||||
| Category | Commands |
|
||||
|----------|----------|
|
||||
| **Inspect** | `status`, `diff`, `list`, `doctor` |
|
||||
| **Sync** | `sync`, `collect`, `push`, `pull` |
|
||||
| **Skills** | `new`, `install`, `uninstall`, `update`, `search` |
|
||||
| **Targets** | `target add/remove/list`, `backup`, `restore` |
|
||||
| **Upgrade** | `upgrade [--cli\|--skill]` |
|
||||
|
||||
## Init (Non-Interactive)
|
||||
**Workflow:** Most commands require `sync` afterward to distribute changes.
|
||||
|
||||
**CRITICAL:** Use flags — AI cannot respond to CLI prompts.
|
||||
## AI Usage Notes
|
||||
|
||||
**Source path:** Always use default `~/.config/skillshare/skills`. Only use `--source` if user explicitly requests a different location.
|
||||
### Non-Interactive Mode
|
||||
|
||||
AI cannot respond to CLI prompts. Always use flags:
|
||||
|
||||
**Step 1:** Check existing skills
|
||||
```bash
|
||||
# Init - check existing skills first
|
||||
ls ~/.claude/skills ~/.cursor/skills 2>/dev/null | head -10
|
||||
|
||||
# Then run with appropriate flags
|
||||
skillshare init --copy-from claude --all-targets --git # If skills exist
|
||||
skillshare init --no-copy --all-targets --git # Fresh start
|
||||
|
||||
# Add new agents later
|
||||
skillshare init --discover --select "windsurf,kilocode"
|
||||
```
|
||||
|
||||
**Step 2:** Run init based on findings
|
||||
### Safety
|
||||
|
||||
| Found | Command |
|
||||
|-------|---------|
|
||||
| Skills in one target | `skillshare init --copy-from <name> --all-targets --git` |
|
||||
| Skills in multiple | Ask user which to import |
|
||||
| No existing skills | `skillshare init --no-copy --all-targets --git` |
|
||||
**NEVER** `rm -rf` symlinked skills — deletes source. Always use:
|
||||
- `skillshare uninstall <name>` to remove skills
|
||||
- `skillshare target remove <name>` to unlink targets
|
||||
|
||||
**Step 3:** `skillshare status`
|
||||
### Finding Skills
|
||||
|
||||
**Adding new agents later (AI must use --select):**
|
||||
```bash
|
||||
skillshare init --discover --select "windsurf,kilocode" # Non-interactive (AI use this)
|
||||
# skillshare init --discover # Interactive only (NOT for AI)
|
||||
```
|
||||
|
||||
See [init.md](references/init.md) for all flags.
|
||||
|
||||
## Team Edition
|
||||
When users ask "how do I do X" or "find a skill for...":
|
||||
|
||||
```bash
|
||||
skillshare install github.com/team/skills --track # Install as tracked repo
|
||||
skillshare update _team-skills # Update later
|
||||
skillshare search <query> # Interactive install
|
||||
skillshare search <query> --list # List only
|
||||
skillshare search <query> --json # JSON output
|
||||
```
|
||||
|
||||
Tracked repos: `_` prefix, nested paths use `__` (e.g., `_team__frontend__ui`).
|
||||
**Query examples:** `react performance`, `pr review`, `commit`, `changelog`
|
||||
|
||||
**Naming convention:** Use `{team}:{name}` in SKILL.md to avoid collisions.
|
||||
|
||||
## Safety
|
||||
|
||||
- **NEVER** `rm -rf` on symlinked skills — deletes source
|
||||
- Use `skillshare uninstall <name>` to safely remove
|
||||
|
||||
## Zero-Install
|
||||
|
||||
```bash
|
||||
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/skills/skillshare/scripts/run.sh | sh -s -- status
|
||||
```
|
||||
**No results?** Try different keywords, or offer to help directly.
|
||||
|
||||
## References
|
||||
|
||||
- [init.md](references/init.md) - Init flags
|
||||
- [sync.md](references/sync.md) - Sync, pull, push
|
||||
- [install.md](references/install.md) - Install, update, uninstall
|
||||
- [status.md](references/status.md) - Status, diff, list, doctor
|
||||
- [targets.md](references/targets.md) - Target management
|
||||
- [backup.md](references/backup.md) - Backup, restore
|
||||
- [TROUBLESHOOTING.md](references/TROUBLESHOOTING.md) - Recovery
|
||||
| Topic | File |
|
||||
|-------|------|
|
||||
| Init flags | [init.md](references/init.md) |
|
||||
| Sync/collect/push/pull | [sync.md](references/sync.md) |
|
||||
| Install/update/new | [install.md](references/install.md) |
|
||||
| Status/diff/list/search | [status.md](references/status.md) |
|
||||
| Target management | [targets.md](references/targets.md) |
|
||||
| Backup/restore | [backup.md](references/backup.md) |
|
||||
| Troubleshooting | [TROUBLESHOOTING.md](references/TROUBLESHOOTING.md) |
|
||||
|
||||
Reference in New Issue
Block a user