Files
skillshare/docs/targets.md
T
Willie Hung 8bcf5b6a13 feat: add 5 new agents to DefaultTargets
- clawdbot, droid, kilocode, roo, windsurf
- Fix amp path to ~/.config/agents/skills
- Update docs/targets.md with new agents list
2026-01-21 00:41:57 +08:00

10 KiB

Target Management

Overview

Targets are AI CLI skill directories that skillshare syncs to.

┌──────────────────────────────────────────────────────────────────┐
│                     SUPPORTED TARGETS                            │
│                                                                  │
│   Built-in (auto-detected):                                      │
│   ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐    │
│   │ Agents  │ │  Amp    │ │Clawdbot │ │ Claude  │ │ Codex   │    │
│   └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘    │
│   ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐    │
│   │ Copilot │ │  Crush  │ │ Cursor  │ │  Droid  │ │ Gemini  │    │
│   └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘    │
│   ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐    │
│   │  Goose  │ │Kilocode │ │  Letta  │ │OpenCode │ │   Roo   │    │
│   └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘    │
│   ┌───────────┐ ┌─────────┐                                      │
│   │Antigravity│ │Windsurf │                                      │
│   └───────────┘ └─────────┘                                      │
│                                                                  │
│   Custom (add your own):                                         │
│   ┌─────────┐ ┌─────────┐ ┌─────────┐                            │
│   │  Aider  │ │   ...   │ │         │                            │
│   └─────────┘ └─────────┘ └─────────┘                            │
└──────────────────────────────────────────────────────────────────┘

Commands

Command Description
target list List all configured targets
target <name> Show target details
target <name> --mode <mode> Change sync mode
target add <name> <path> Add custom target
target remove <name> Safely unlink target

List Targets

skillshare target list

Example Output

Targets
─────────────────────────────────────────
  claude    merge     ~/.claude/skills         5 skills
  cursor    merge     ~/.cursor/skills         5 skills
  codex     symlink   ~/.codex/skills          linked
  myapp     merge     ~/.myapp/skills          3 skills

Show Target Details

skillshare target claude

Example Output

Target: claude
─────────────────────────────────────────
  Path:     ~/.claude/skills
  Mode:     merge
  Status:   synced (5/5 skills)

  Skills:
    my-skill        → source/my-skill (symlink)
    another         → source/another (symlink)
    local-only      (local, not synced)

Add Custom Target

Add any tool with a skills directory.

skillshare target add <name> <path>

Examples

# Add Aider
skillshare target add aider ~/.aider/skills

# Add custom app
skillshare target add myapp ~/apps/myapp/skills

# Then sync
skillshare sync

Requirements

  • Path must exist (create with mkdir -p first)
  • Path should end with /skills (recommended)
# If path doesn't exist:
mkdir -p ~/.myapp/skills
skillshare target add myapp ~/.myapp/skills

Change Sync Mode

skillshare target <name> --mode <mode>

Modes

Mode Behavior
merge Each skill symlinked individually. Local skills preserved. (default)
symlink Entire directory is one symlink.

Examples

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

# Switch back to merge mode
skillshare target codex --mode merge
skillshare sync

Visual Comparison

Merge mode:

~/.claude/skills/
├── my-skill/     → ~/.config/skillshare/skills/my-skill/ (symlink)
├── another/      → ~/.config/skillshare/skills/another/  (symlink)
└── local-only/   (local file, preserved)

Symlink mode:

~/.claude/skills  → ~/.config/skillshare/skills/ (entire dir is symlink)

Remove Target

Safely unlink a target (preserves your files).

skillshare target remove <name>
skillshare target remove <name> --dry-run    # Preview
skillshare target remove --all               # Remove all

What Happens

┌─────────────────────────────────────────────────────────────────┐
│ skillshare target remove claude                                 │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│ 1. Create backup                                                │
│    → ~/.config/skillshare/backups/2026-01-20.../claude/         │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. Detect mode                                                  │
└─────────────────────────────────────────────────────────────────┘
                    │                   │
           merge mode                   symlink mode
                    │                   │
                    ▼                   ▼
┌───────────────────────────┐   ┌───────────────────────────┐
│ For each symlink:         │   │ Remove symlink:           │
│  • Remove symlink         │   │  ~/.claude/skills →       │
│  • Copy source file back  │   │                           │
│                           │   │ Copy source contents:     │
│ Local files: preserved    │   │  → ~/.claude/skills/      │
└───────────────────────────┘   └───────────────────────────┘
                    │                   │
                    └─────────┬─────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. Remove from config.yaml                                      │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│ Result:                                                         │
│  • ~/.claude/skills/ now contains real files (not symlinks)     │
│  • skillshare no longer manages this target                     │
│  • Backup available if needed                                   │
└─────────────────────────────────────────────────────────────────┘

Why This Is Safe

Operation Danger Safety
rm -rf ~/.claude/skills Deletes source files! ❌
skillshare target remove Backs up, copies files back ✅

Common Scenarios

Add a new AI CLI tool

# 1. Create the skills directory
mkdir -p ~/.newtool/skills

# 2. Add as target
skillshare target add newtool ~/.newtool/skills

# 3. Sync skills
skillshare sync

# 4. Verify
skillshare target newtool

Stop managing a target temporarily

# Remove (keeps your files)
skillshare target remove cursor

# Re-add later
skillshare target add cursor ~/.cursor/skills
skillshare sync
for target in claude cursor codex; do
  skillshare target $target --mode symlink
done
skillshare sync