Skip to main content

Daily Workflow

The edit → sync → push/pull cycle for everyday skill management.

Overview​

Editing Skills​

$EDITOR ~/.config/skillshare/skills/my-skill/SKILL.md

Changes are immediately visible in all targets (via symlinks).

Option 2: Edit in target​

$EDITOR ~/.claude/skills/my-skill/SKILL.md

Because targets are symlinked, this edits the source file directly.

Syncing​

After editing, sync is usually not needed because of symlinks. However, run sync when:

  • You've installed or removed skills
  • You've changed sync mode
  • You've added or removed targets
  • You see "out of sync" in status
skillshare sync
Why is sync a separate step?

Sync is intentionally decoupled from install/update/uninstall. This lets you batch multiple changes (e.g., install 3 skills → sync once), preview with --dry-run before propagating, and keep full control of when targets update. See Source & Targets: Why Sync is a Separate Step for details.

Preview first​

skillshare sync --dry-run

Cross-Machine Sync​

If you use git remote:

Push changes (from this machine)​

skillshare push -m "Add new skill"

This runs:

  1. git add .
  2. git commit -m "Add new skill"
  3. git push

Pull changes (to this machine)​

skillshare pull

This runs:

  1. git pull
  2. skillshare sync

Common Daily Tasks​

Create a new skill​

skillshare new code-review
$EDITOR ~/.config/skillshare/skills/code-review/SKILL.md
skillshare sync

Update a tracked repo​

skillshare update _team-skills
skillshare sync

Update all tracked repos​

skillshare update --all
skillshare sync

Check status​

skillshare status

Shows:

  • Source directory status
  • Git status (commits ahead/behind)
  • Target sync status

Tips​

Make it automatic​

Add to your shell startup:

# ~/.bashrc or ~/.zshrc
alias ss="skillshare"
alias sss="skillshare sync"
alias ssp="skillshare push"
alias ssl="skillshare pull"

Check before important work​

# Start of day
skillshare pull
skillshare status

# Before committing
skillshare diff

Keep things clean​

# Weekly maintenance
skillshare audit             # Scan for security threats
skillshare backup --cleanup  # Remove old backups
skillshare doctor            # Check for issues

See Also​