mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-18 18:04:17 +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)
2.6 KiB
2.6 KiB
sidebar_position
| 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, you can add it manually.
Add a Target
skillshare target add <name> <path>
Example
skillshare target add aider ~/.aider/skills
skillshare sync
Requirements
Path must exist
Create the directory first if needed:
mkdir -p ~/.myapp/skills
skillshare target add myapp ~/.myapp/skills
Path should end with /skills
This is recommended but not required:
# Recommended
skillshare target add myapp ~/.myapp/skills
# Also works
skillshare target add myapp ~/.myapp/prompts
Verify
After adding:
# Check target
skillshare target myapp
# Sync to new target
skillshare sync
# Verify
skillshare status
Common Scenarios
Add new AI CLI tool
# 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
# Sync skills to a specific project
skillshare target add myproject ~/projects/myapp/.ai/skills
skillshare sync
Add multiple tools
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:
# Default is merge mode
skillshare target myapp --mode symlink
skillshare sync
See Sync Modes for details.
Remove Target
If you no longer need a target:
skillshare target remove myapp
This:
- Creates a backup
- Replaces symlinks with real files (in merge mode, only source-managed symlinks are removed; local skills are preserved)
- Removes from config
Troubleshooting
"path does not exist"
Create the directory first:
mkdir -p ~/.myapp/skills
skillshare target add myapp ~/.myapp/skills
Target not syncing
Check if the target is enabled:
skillshare target list
skillshare target myapp
Wrong path
Remove and re-add:
skillshare target remove myapp
skillshare target add myapp /correct/path/skills
Related
- Supported Targets — Built-in targets
- Configuration — Edit config directly
- Sync Modes — Merge, copy, symlink