mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
- Update target counts across README, website docs, and homepage - Rebuild ASCII box diagram with new targets (COMATE, Cortex, Xcode Claude, Xcode Codex) - Replace single-column paths table with global + project path columns - Fix stale paths (droid, copilot, etc.) to match actual targets.yaml
4.2 KiB
4.2 KiB
sidebar_position
| sidebar_position |
|---|
| 1 |
target
Manage sync targets (AI CLI skill directories).
skillshare target add <name> <path> # Add a target
skillshare target remove <name> # Remove a target
skillshare target list # List all targets
skillshare target <name> # Show target info
skillshare target <name> --mode merge # Change sync mode
Subcommands
target add
Add a new target for skill synchronization.
skillshare target add windsurf ~/.windsurf/skills
The command validates:
- Path exists or parent directory exists
- Path looks like a skills directory
- Target name is unique
target remove
Remove a target and restore its skills to regular directories.
skillshare target remove cursor # Remove single target
skillshare target remove --all # Remove all targets
skillshare target remove cursor --dry-run # Preview
What happens:
- Creates backup of target
- Removes symlinks, copies skills back
- Removes target from config
target list
List all configured targets.
skillshare target list
Configured Targets
claude ~/.claude/skills (merge)
cursor ~/.cursor/skills (merge)
codex ~/.openai-codex/skills (symlink)
target info / mode
Show target details or change sync mode.
# Show info
skillshare target claude
# Change mode
skillshare target claude --mode symlink
skillshare target claude --mode merge
skillshare sync # Apply change
Sync Modes
| Mode | Behavior |
|---|---|
merge |
Each skill symlinked individually. Preserves local skills. Default. |
symlink |
Entire directory is one symlink. Exact copies everywhere. |
# Set target to symlink mode
skillshare target claude --mode symlink
skillshare sync # Apply the change
Options
target add
No additional options.
target remove
| Flag | Description |
|---|---|
--all, -a |
Remove all targets |
--dry-run, -n |
Preview without making changes |
target info
| Flag | Description |
|---|---|
--mode, -m <mode> |
Set sync mode (merge or symlink) |
Supported AI CLIs
Skillshare auto-detects these during init:
| CLI | Default Path |
|---|---|
| Claude Code | ~/.claude/skills |
| Cursor | ~/.cursor/skills |
| OpenCode | ~/.opencode/skills |
| Windsurf | ~/.windsurf/skills |
| Codex | ~/.openai-codex/skills |
| Gemini CLI | ~/.gemini/skills |
| Amp | ~/.amp/skills |
| ... and 40+ more | See supported targets |
Examples
# Add custom target
skillshare target add my-tool ~/my-tool/skills
# Check target status
skillshare target claude
# Switch to symlink mode
skillshare target claude --mode symlink
skillshare sync
# Remove target (restores skills)
skillshare target remove cursor
Project Mode
Manage targets for the current project:
skillshare target add windsurf -p # Add known target
skillshare target add custom ./tools/ai/skills -p # Add custom path
skillshare target remove cursor -p # Remove target
skillshare target list -p # List project targets
skillshare target claude-code -p # Show target info
How It Differs
| Global | Project (-p) |
|
|---|---|---|
| Config | ~/.config/skillshare/config.yaml |
.skillshare/config.yaml |
| Paths | Absolute (e.g., ~/.claude/skills) |
Relative or absolute (e.g., .claude/skills) |
| Sync mode | Merge or symlink | Merge or symlink (default merge) |
| Mode change | --mode flag |
--mode flag |
Project Target List Example
Project Targets
claude-code .claude/skills (merge)
cursor .cursor/skills (merge)
custom-tool ./tools/ai/skills (merge)
Targets in project mode support:
- Known target names (e.g.,
claude-code,cursor) — resolved to project-local paths - Custom paths — relative to project root or absolute with
~expansion
Related
- sync — Sync skills to targets
- status — Show target status
- Targets — Target management guide
- Project Skills — Project mode concepts