v0.9.0
✨ Project-Level Skills
Scope skills to a single repository — shared with your team via git.
The biggest feature in this release: skillshare now supports project mode. Instead of managing skills globally in ~/.config/skillshare/, you can manage them per-project in .skillshare/ — committed directly to your repo.
How It Works
<project-root>/
├── .skillshare/
│ ├── config.yaml # Targets + remote skills list
│ ├── .gitignore # Ignores cloned remote/tracked skill dirs
│ └── skills/
│ ├── my-skill/ # Local skill
│ └── _team-repo/ # Tracked repo (--track)
├── .claude/skills/ # ← symlinked from .skillshare/skills/
└── .cursor/skills/ # ← symlinked from .skillshare/skills/
Quick Start
# Initialize project-level skills
skillshare init -p
# Create or install skills
skillshare new my-skill -p
skillshare install anthropics/skills/skills/pdf -p
# Sync to targets
skillshare syncKey Features
- Project-scoped — Skills live in
.skillshare/skills/, committed to the project repo - Auto-detection — Commands auto-detect project mode when
.skillshare/config.yamlexists (no-pflag needed) - Force flags — Use
-p(project) or-g(global) to override auto-detection - Team onboarding — New members just run
skillshare install -p && skillshare sync - Coexists with global — Project and global skills work independently
- Tracked repos —
skillshare install --track -pworks in project mode, auto-added to.gitignore
All Commands Support Project Mode
| Command | Project Mode | Notes |
|---|---|---|
init -p
| ✓ | Creates .skillshare/ with config, gitignore, and skills directory
|
sync
| ✓ | Auto-detects project mode |
install -p
| ✓ | Install remote skills to project source |
uninstall -p
| ✓ | Remove skills from project source |
update -p
| ✓ | Update remote/tracked skills |
list
| ✓ | Auto-detects project mode |
status
| ✓ | Auto-detects project mode |
target add/remove/list -p
| ✓ | Manage project targets |
collect
| ✓ | Collect local skills from project targets |
push / pull
| ✗ | Not needed — use git directly |
backup / restore
| ✗ | Not needed — project targets are reproducible |
🔍 Search with Project Mode
skillshare search now supports --project / -p and --global / -g flags. When you find a skill interactively, it installs directly to .skillshare/skills/ — no separate install -p step needed.
skillshare search pdf -p # Search → select → install to project
skillshare search react --global # Force global install- Auto-detects project mode when
.skillshare/config.yamlexists - Auto-runs
init -pif the project hasn't been initialized yet - Updates
.skillshare/config.yamland.gitignoreautomatically
🎯 Per-Target Sync Mode (Project Mode)
Project targets can now set sync mode individually — merge (default) or symlink — matching the global mode behavior.
# .skillshare/config.yaml
targets:
- claude-code # merge (default)
- name: cursor
mode: symlink # symlink for this target only
- name: custom-ide
path: ./tools/ide/skills
mode: mergeFeatures
- Per-target
modefield inconfig.yamlwith YAML marshal/unmarshal skillshare target <name> --mode symlink -pto change mode- Mode-aware
target remove(proper cleanup for both modes) - Unified sync UI output format between project and global modes
🔧 Internal
- New
mode.gohandles-p/-gflag parsing and auto-detection logic - New
project_runtime.gofor project config loading - Extracted
internal/config/targets.gowithtargets.yamlfor known target definitions internal/config/project.gofor project-specific config types (ProjectTargetEntrywithModefield)- Comprehensive integration test coverage for all project-mode commands
📖 Documentation
- New concept page: Project Skills
- New guide: Project Setup
- New workflow: Project Workflow
- Updated all command docs with project-mode sections (
init,install,list,status,sync,target,uninstall,update) - Updated README with Project Skills section
Changelog
- 010b707 chore(docs): update docs
- 1bbfb66 chore: update website links to new domain
- 7e8cab2 docs(skill): improve built-in skillshare skill v0.8.2
- 46d1ee5 docs(skill): update built-in skill to v0.9.0 with project mode support
- 4b914b0 docs(website): add Docusaurus docs synced from docs/
- 9cef926 docs(website): refactor docs
- 087ac0b feat(website): add SEO essentials - sitemap, robots.txt, social card
- 0162bdd feat: add per-target sync mode support for project mode
- b83300a feat: project level skills
- 671ea97 fix(install.sh): use redirect to avoid API rate limit
- 6cba953 fix(website): responsive footer padding and README link corrections
- 6650a8c style: fix docs formatting
Full Changelog: v0.8.1...v0.9.0