Files
skillshare/website/docs/reference/targets/adding-custom-targets.md
T
Willie caa525b8aa feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 22:27:23 +08:00

174 lines
2.6 KiB
Markdown

---
sidebar_position: 3
---
# Adding Custom Targets
Add any tool with a skills directory to skillshare.
## Overview
If your AI CLI isn't in the [supported list](./supported-targets.md), you can add it manually.
---
## Add a Target
```bash
skillshare target add <name> <path>
```
### Example
```bash
skillshare target add aider ~/.aider/skills
skillshare sync
```
---
## Requirements
### Path must exist
Create the directory first if needed:
```bash
mkdir -p ~/.myapp/skills
skillshare target add myapp ~/.myapp/skills
```
### Path should end with `/skills`
This is recommended but not required:
```bash
# Recommended
skillshare target add myapp ~/.myapp/skills
# Also works
skillshare target add myapp ~/.myapp/prompts
```
---
## Verify
After adding:
```bash
# Check target
skillshare target myapp
# Sync to new target
skillshare sync
# Verify
skillshare status
```
---
## Common Scenarios
### Add new AI CLI tool
```bash
# 1. Find where the tool stores skills
# (Check tool documentation)
# 2. Create directory if needed
mkdir -p ~/.newtool/skills
# 3. Add as target
skillshare target add newtool ~/.newtool/skills
# 4. Sync
skillshare sync
```
### Add project-specific target
```bash
# Sync skills to a specific project
skillshare target add myproject ~/projects/myapp/.ai/skills
skillshare sync
```
### Add multiple tools
```bash
skillshare target add tool1 ~/.tool1/skills
skillshare target add tool2 ~/.tool2/skills
skillshare target add tool3 ~/.tool3/skills
skillshare sync
```
---
## Change Sync Mode
After adding, you can change the sync mode:
```bash
# Default is merge mode
skillshare target myapp --mode symlink
skillshare sync
```
See [Sync Modes](/docs/understand/sync-modes) for details.
---
## Remove Target
If you no longer need a target:
```bash
skillshare target remove myapp
```
This:
1. Creates a backup
2. Replaces symlinks with real files (in merge mode, only source-managed symlinks are removed; local skills are preserved)
3. Removes from config
---
## Troubleshooting
### "path does not exist"
Create the directory first:
```bash
mkdir -p ~/.myapp/skills
skillshare target add myapp ~/.myapp/skills
```
### Target not syncing
Check if the target is enabled:
```bash
skillshare target list
skillshare target myapp
```
### Wrong path
Remove and re-add:
```bash
skillshare target remove myapp
skillshare target add myapp /correct/path/skills
```
---
## Related
- [Supported Targets](./supported-targets.md) — Built-in targets
- [Configuration](./configuration.md) — Edit config directly
- [Sync Modes](/docs/understand/sync-modes) — Merge, copy, symlink