Skip to main content

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

When to Use​

  • Add a new AI CLI target after installing a new tool
  • Remove a target you no longer use
  • Change sync mode (merge, copy, or symlink) for a target
  • Tune compatibility target-by-target instead of forcing one global mode
  • Set up include/exclude filters for selective skill syncing

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. Detects sync mode:
    • Symlink mode: Removes the directory symlink, copies source contents back as a real directory
    • Merge mode: Removes only symlinks pointing to source (by path prefix), copies each skill back as real files. Local (non-symlink) skills are preserved.
    • Copy mode: Removes .skillshare-manifest.json. Managed copies and local skills are preserved as regular directories.
  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​

ModeBehavior
mergeEach skill symlinked individually. Preserves local skills. Default.
copyEach skill copied as real files. For AI CLIs that can't follow symlinks.
symlinkEntire directory is one symlink. Exact copies everywhere.

target --mode is the main compatibility control surface. Keep your global default simple, then override only where needed. In sync/doctor hints, the example target is prioritized as cursor → antigravity → copilot → opencode. If none exist, no compatibility hint is shown.

# Set target to copy mode (for Cursor, Copilot CLI, etc.)
skillshare target cursor --mode copy
skillshare sync  # Apply the change

Mixed strategy example​

# Keep default merge behavior for most targets
skillshare target claude --mode merge

# Compatibility-first for one target
skillshare target cursor --mode copy

# Exact mirror for another target
skillshare target codex --mode symlink

skillshare sync

Target Filters (include/exclude)​

Manage per-target include/exclude filters from the CLI:

skillshare target claude --add-include "team-*"
skillshare target claude --add-exclude "_legacy*"
skillshare target claude --remove-include "team-*"
skillshare target claude --remove-exclude "_legacy*"

After changing filters, run skillshare sync to apply.

Filters work in merge and copy modes. Patterns use Go filepath.Match syntax (*, ?, [...]). In symlink mode, filters are ignored.

See Configuration for pattern cheat sheet and scenarios.

Options​

target add​

No additional options.

target remove​

FlagDescription
--all, -aRemove all targets
--dry-run, -nPreview without making changes

target info / filters​

FlagDescription
--mode, -m <mode>Set sync mode (merge, copy, or symlink)
--add-include <pattern>Add an include filter pattern
--add-exclude <pattern>Add an exclude filter pattern
--remove-include <pattern>Remove an include filter pattern
--remove-exclude <pattern>Remove an exclude filter pattern

Supported AI CLIs​

skillshare auto-detects these during init:

CLIDefault 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 45+ moreSee supported targets

Examples​

# Add custom target
skillshare target add my-tool ~/my-tool/skills

# Check target status
skillshare target claude

# Switch to copy mode (for AI CLIs that can't read symlinks)
skillshare target cursor --mode copy
skillshare sync

# Switch to symlink mode
skillshare target claude --mode symlink
skillshare sync

# Add/remove filters
skillshare target claude --add-include "team-*"
skillshare target claude --add-exclude "_legacy*"
skillshare target claude --remove-include "team-*"
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 -p                                  # Show target info
skillshare target claude --add-include "team-*" -p          # Add filter

How It Differs​

GlobalProject (-p)
Config~/.config/skillshare/config.yaml.skillshare/config.yaml
PathsAbsolute (e.g., ~/.claude/skills)Relative or absolute (e.g., .claude/skills)
Sync modeMerge, copy, or symlinkMerge, copy, or symlink (default merge)
Mode change--mode flag--mode flag

Project Target List Example​

Project Targets
  claude    .claude/skills (merge)
  cursor         .cursor/skills (merge)
  custom-tool    ./tools/ai/skills (merge)

Targets in project mode support:

  • Known target names (e.g., claude, cursor) — resolved to project-local paths
  • Custom paths — relative to project root or absolute with ~ expansion

See Also​