Files
skillshare/website/docs/workflows/project-workflow.md
T
Willie 14bd568b9a feat: add project mode support to web dashboard (skillshare ui -p)
The web dashboard now fully supports project-level skills. When launched
with `-p` or when `.skillshare/config.yaml` is auto-detected, the UI
adapts: Git Sync and Backup pages are hidden, Config edits the project
config, Install reconciles ProjectConfig.Skills[], and targets resolve
from project-level definitions.

Server: add NewProject constructor, IsProjectMode/configPath/saveConfig/
reloadConfig helpers, branch all handlers for project mode.

Frontend: AppContext propagates isProjectMode, Layout filters nav items,
Git/Backup pages show unavailable message, Config/Dashboard adapt.

Extract ReconcileProjectSkills to internal/config for reuse by both CLI
and server. Add unit tests and integration tests for project UI.

Update docs, README, and Docker playground with project mode demo project
and skillshare-ui-p alias.
2026-02-08 17:15:59 +08:00

5.9 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             │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Team Collaboration Scenario

A typical team workflow showing how project skills stay in sync:

Alice (adds a skill)                    Bob (gets the update)
──────────────────────                  ──────────────────────
skillshare new api-guide -p
$EDITOR .skillshare/skills/api-guide/
skillshare sync
git add . && git commit && git push
                                        git pull
                                        skillshare install -p
                                        skillshare sync
                                        → api-guide now in .claude/skills/

Bob doesn't need to know which skills were added — skillshare install -p reads the config and installs everything listed.


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

Web Dashboard

Use the web UI for visual project skill management:

skillshare ui -p

Or just skillshare ui if .skillshare/config.yaml exists (auto-detected). The dashboard hides Git Sync (use your project's own git) and edits .skillshare/config.yaml directly.


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

:::tip Zero Config Just cd into a project directory — skillshare detects .skillshare/config.yaml and automatically switches to project mode. No flags needed. :::

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