mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
Add a third sync mode (`copy`) that copies skills as real files instead of symlinks, with a `.skillshare-manifest.json` tracking managed skills and SHA256 checksums for incremental updates. - Manifest-based tracking: skip unchanged, update modified, --force all - Pruning: remove managed copies no longer in source - Mode conversion: bidirectional merge↔copy and symlink↔copy - Full command support: sync, status, doctor, diff, target, collect - Server API + Web UI: targets list, drift detection, filter editing - include/exclude filters work in both merge and copy modes - 12 integration tests covering all acceptance criteria - Documentation updated across 13 pages Closes #31
2.6 KiB
2.6 KiB
sidebar_position
| sidebar_position |
|---|
| 3 |
Adding Custom Targets
Add any tool with a skills directory to skillshare.
Overview
If your AI CLI isn't in the supported list, you can add it manually.
Add a Target
skillshare target add <name> <path>
Example
skillshare target add aider ~/.aider/skills
skillshare sync
Requirements
Path must exist
Create the directory first if needed:
mkdir -p ~/.myapp/skills
skillshare target add myapp ~/.myapp/skills
Path should end with /skills
This is recommended but not required:
# Recommended
skillshare target add myapp ~/.myapp/skills
# Also works
skillshare target add myapp ~/.myapp/prompts
Verify
After adding:
# Check target
skillshare target myapp
# Sync to new target
skillshare sync
# Verify
skillshare status
Common Scenarios
Add new AI CLI tool
# 1. Find where the tool stores skills
# (Check tool documentation)
# 2. Create directory if needed
mkdir -p ~/.newtool/skills
# 3. Add as target
skillshare target add newtool ~/.newtool/skills
# 4. Sync
skillshare sync
Add project-specific target
# Sync skills to a specific project
skillshare target add myproject ~/projects/myapp/.ai/skills
skillshare sync
Add multiple tools
skillshare target add tool1 ~/.tool1/skills
skillshare target add tool2 ~/.tool2/skills
skillshare target add tool3 ~/.tool3/skills
skillshare sync
Change Sync Mode
After adding, you can change the sync mode:
# Default is merge mode
skillshare target myapp --mode symlink
skillshare sync
See Sync Modes for details.
Remove Target
If you no longer need a target:
skillshare target remove myapp
This:
- Creates a backup
- Replaces symlinks with real files (in merge mode, only source-managed symlinks are removed; local skills are preserved)
- Removes from config
Troubleshooting
"path does not exist"
Create the directory first:
mkdir -p ~/.myapp/skills
skillshare target add myapp ~/.myapp/skills
Target not syncing
Check if the target is enabled:
skillshare target list
skillshare target myapp
Wrong path
Remove and re-add:
skillshare target remove myapp
skillshare target add myapp /correct/path/skills
Related
- Supported Targets — Built-in targets
- Configuration — Edit config directly
- Sync Modes — Merge, copy, symlink