Files
skillshare/docs/targets.md
T
Willie Hung 83bd7d45ef feat(targets): add 6 new agents to supported targets
Add AdaL, Augment, iFlow, OpenClaude, Trae CN, and Mistral Vibe.
Total supported agents: 43.
2026-01-31 16:34:36 +08:00

13 KiB

Target Management

Overview

Targets are AI CLI skill directories that skillshare syncs to.

Supported Agents (43)

┌────────────────────────────────────────────────────────────────────────────┐
│                           SUPPORTED TARGETS                                │
│                                                                            │
│  Built-in (auto-detected):                                                 │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌───────────┐ ┌─────────┐             │
│  │  AdaL   │ │ Agents  │ │   Amp   │ │Antigravity│ │ Augment │             │
│  └─────────┘ └─────────┘ └─────────┘ └───────────┘ └─────────┘             │
│  ┌─────────┐ ┌─────────┐ ┌──────────┐ ┌─────────┐ ┌─────────┐              │
│  │ Claude  │ │  Cline  │ │CodeBuddy │ │  Codex  │ │Cmd Code │              │
│  └─────────┘ └─────────┘ └──────────┘ └─────────┘ └─────────┘              │
│  ┌──────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐              │
│  │ Continue │ │ Copilot │ │  Crush  │ │ Cursor  │ │  Droid  │              │
│  └──────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘              │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐              │
│  │ Gemini  │ │  Goose  │ │  iFlow  │ │  Junie  │ │ Kilocode │              │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └──────────┘              │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐               │
│  │  Kimi   │ │  Kiro   │ │  Kode   │ │  Letta  │ │ MCPJam  │               │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘               │
│  ┌─────────┐ ┌──────────┐ ┌───────────┐ ┌─────────┐ ┌──────────┐           │
│  │   Mux   │ │ Neovate  │ │OpenClaude │ │OpenClaw │ │ OpenCode │           │
│  └─────────┘ └──────────┘ └───────────┘ └─────────┘ └──────────┘           │
│  ┌───────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐             │
│  │ OpenHands │ │   Pi    │ │  Pochi  │ │  Qoder  │ │  Qwen   │             │
│  └───────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘             │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐              │
│  │   Roo   │ │  Trae   │ │ Trae CN │ │  Vibe   │ │ Windsurf │              │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └──────────┘              │
│  ┌──────────┐                                                              │
│  │ Zencoder │                                                              │
│  └──────────┘                                                              │
│                                                                            │
│  Custom (add your own):                                                    │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐                                       │
│  │  Aider  │ │   ...   │ │         │                                       │
│  └─────────┘ └─────────┘ └─────────┘                                       │
└────────────────────────────────────────────────────────────────────────────┘

Run skillshare target <name> to see the exact path for any agent.


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