Files
skillshare/website/docs/commands/target.md
T
Willie dde62dd733 docs: update target count to 45+, add project/global paths to table
- 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
2026-02-13 14:21:36 +08:00

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:

  1. Creates backup of target
  2. Removes symlinks, copies skills back
  3. 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