mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
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)
174 lines
2.6 KiB
Markdown
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
|