mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
Allow project targets to set mode individually (merge or symlink), mirroring global behavior. Default remains merge. - Add Mode field to ProjectTargetEntry with YAML marshal/unmarshal - Add mode branching in project sync (reuses syncMergeMode/syncSymlinkMode) - Support --mode flag in target info for project targets - Mode-aware unlink in target remove - Unify project sync UI with global sync output format - Update docs to reflect per-target mode support
4.6 KiB
4.6 KiB
sidebar_position
| sidebar_position |
|---|
| 6 |
Project Workflow
The edit → sync → commit cycle for project-level skill management.
Overview
┌─────────────────────────────────────────────────────────────────┐
│ PROJECT WORKFLOW │
│ │
│ EDIT ──► SYNC ──► COMMIT ──► PUSH │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ .skillshare/ .claude/ Remote │
│ skills/ .cursor/ (GitHub) │
│ etc. │ │
│ ▼ │
│ Team members │
│ clone + install + sync │
│ │
└─────────────────────────────────────────────────────────────────┘
Common Operations
Add a New Skill
# Create the skill
skillshare new my-skill -p
$EDITOR .skillshare/skills/my-skill/SKILL.md
# Sync to targets
skillshare sync
# Commit
git add .skillshare/
git commit -m "Add my-skill"
Install a Remote Skill
# Install from GitHub
skillshare install anthropics/skills/skills/pdf -p
# Sync to targets
skillshare sync
# Commit config changes
git add .skillshare/
git commit -m "Add pdf skill from anthropic"
Update Remote Skills
# Update a specific skill
skillshare update pdf -p
# Or update all remote skills
skillshare update --all -p
# Sync updated skills
skillshare sync
# Commit if config changed
git add .skillshare/
git commit -m "Update remote skills"
Remove a Skill
# Uninstall
skillshare uninstall my-skill -p
# Sync to clean up symlinks
skillshare sync
# Commit
git add .skillshare/
git commit -m "Remove my-skill"
New Team Member Joins
# Clone the project
git clone github.com/team/project
cd project
# Install remote skills listed in config
skillshare install -p
# Sync to targets
skillshare sync
Managing Targets
Add a Target
# Add a known target
skillshare target add windsurf -p
# Add a custom target with path
skillshare target add custom-tool ./tools/ai/skills -p
# Sync to new target
skillshare sync
Remove a Target
skillshare target remove windsurf -p
List Targets
skillshare target list -p
Project Targets
claude-code .claude/skills (merge)
cursor .cursor/skills (merge)
Check Status
skillshare status
Project Skills (.skillshare/)
Source
✓ .skillshare/skills (3 skills)
Targets
✓ claude-code [merge] .claude/skills (3 synced)
✓ cursor [merge] .cursor/skills (3 synced)
Remote Skills
✓ pdf anthropic/skills/pdf
✓ review github.com/team/tools
List Skills
skillshare list
Installed skills (project)
─────────────────────────────────────────
→ my-skill local
→ pdf anthropic/skills/pdf
→ review github.com/team/tools
→ 3 skill(s): 2 remote, 1 local
Tips
Auto-Detection
Once .skillshare/config.yaml exists, most commands auto-detect project mode:
cd my-project/
skillshare sync # Auto project mode
skillshare status # Auto project mode
skillshare list # Auto project mode
Edit and See Changes Instantly
Skills are symlinked — editing in .skillshare/skills/ is immediately visible in targets:
$EDITOR .skillshare/skills/my-skill/SKILL.md
# Change is already in .claude/skills/my-skill/ (symlink)
Only run sync when adding/removing skills or targets.
Preview Before Syncing
skillshare sync --dry-run
Related
- Project Skills — Core concepts
- Project Setup — Initial setup guide
- Daily Workflow — Global mode daily workflow
- Commands: sync — Sync command details