Files
skillshare/website/docs/workflows/project-workflow.md
T
Willie 0162bddfde feat: add per-target sync mode support for project mode
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
2026-02-05 13:20:12 +08:00

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