ProjectSkill gains `tracked: true` (omitempty) so `install -p` can correctly dispatch tracked repos via InstallTrackedRepo instead of regular Install. ReconcileProjectSkills now detects .git/ dirs and reads git remote origin URL for tracked repos that lack meta files, fixing the bug where tracked repos were silently skipped during reconcile. SkillName validation is moved after the tracked branch so _ prefixed repo names no longer fail. Docs updated to position config.yaml as a portable skill manifest usable by teams, open source contributors, and community templates.
6.1 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"
Anyone Joins the Project
Whether it's a new team member, an open source contributor, or someone trying a community template — the setup is the same:
# 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
The config.yaml acts as a portable skill manifest — no manual skill hunting required.
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
Related
- Project Skills — Core concepts
- Project Setup — Initial setup guide
- Daily Workflow — Global mode daily workflow
- Commands: sync — Sync command details