mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 12:23:22 +00:00
- Add version command page and fix commands index (missing check, trash, hub) - Document target aliases and XDG base directory layout - Rewrite all 9 section index pages with "What do you want to do?" tables - Standardize all 24 command docs with "When to Use" and "See Also" sections - Enhance intro with role-based paths (individual / team / migration) - Add "What Just Happened?" explainer to first-sync getting-started page - Add practical context callouts (:::tip) to all concept pages - Add See Also cross-references to all guide and workflow pages 59 files changed, 547 insertions(+), 163 deletions(-)
4.3 KiB
4.3 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
pull
Pull from git remote and sync to all targets.
skillshare pull # Pull and sync
skillshare pull --dry-run # Preview
When to Use
- Sync skills from another machine that pushed changes
- Get the latest skills after someone else pushed updates
- Start working on a new machine after
init --remote
What Happens
┌─────────────────────────────────────────────────────────────────┐
│ skillshare pull │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 1. Check repository status │
│ → Source is a git repo: ✓ │
│ → Remote configured: ✓ │
│ → No local changes: ✓ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. Pull from remote │
│ → git pull │
│ → ✓ Pull complete │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. Sync to all targets (automatic) │
│ → skillshare sync │
│ → ✓ claude: merged (5 linked) │
│ → ✓ cursor: merged (5 linked) │
└─────────────────────────────────────────────────────────────────┘
Options
| Flag | Description |
|---|---|
--dry-run, -n |
Preview without making changes |
Prerequisites
Your source directory must be a git repository with a remote:
# Check if ready:
skillshare status
# Shows: Git: initialized with remote
Local Changes Warning
If you have uncommitted changes, pull will fail:
$ skillshare pull
Local changes detected
Run: skillshare push
Or: cd ~/.config/skillshare/skills && git stash
Solutions:
# Option 1: Push your changes first
skillshare push
skillshare pull
# Option 2: Stash your changes
cd ~/.config/skillshare/skills
git stash
skillshare pull
git stash pop
Examples
# Standard pull (most common)
skillshare pull
# Preview what would happen
skillshare pull --dry-run
Workflow
Typical workflow on a secondary machine:
# Start of day: get latest skills
skillshare pull
# ... work with AI tools ...
# End of day: share any new skills
skillshare collect claude # If you created new skills
skillshare push -m "Add new skill"
See Also
- push — Push to remote
- sync — Manual sync without pull
- Cross-Machine Sync — Full setup