mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
ASCII box-drawing characters (┌─┐│└─┘) render inconsistently on
Windows due to monospace font width differences. Replace all 30+
diagrams across docs with Mermaid flowcharts rendered as SVG.
- Add Mermaid handDrawn config (Rough.js sketchy style, seed 42)
- Add CSS fix for foreignObject overflow clipping in handDrawn mode
- Convert supported-targets grid to HTML with anchor navigation
- Simplify all node labels to short, readable single-line text
- Strip redundant %%{init}%% directives (covered by global config)
3.7 KiB
3.7 KiB
sidebar_position
| sidebar_position |
|---|
| 1 |
init
First-time setup. Auto-detects installed AI CLIs and configures targets.
skillshare init # Interactive setup
skillshare init --dry-run # Preview without changes
When to Use
- First time setting up skillshare on a machine
- Migrating to a new computer (with
--remoteto connect to existing repo) - Adding skillshare to a project (with
--project) - Discovering newly installed AI CLIs (with
--discover)
What Happens
flowchart TD
TITLE["skillshare init"]
S1["1. Create source directory"]
S2["2. Auto-detect AI CLIs"]
S3["3. Initialize git"]
S4["4. Set up remote"]
S5["5. Create config.yaml"]
S6["6. Built-in skill"]
TITLE --> S1 --> S2 --> S3 --> S4 --> S5 --> S6
Project Mode
Initialize project-level skills with -p:
skillshare init -p # Interactive
skillshare init -p --targets claude,cursor # Non-interactive
What Happens
flowchart TD
TITLE["skillshare init -p"]
S1["1. Create .skillshare/ directory"]
S2["2. Detect AI CLI directories"]
S3["3. Create target skill directories"]
S4["4. Write config.yaml"]
TITLE --> S1 --> S2 --> S3 --> S4
After init, commit .skillshare/ to git. See Project Setup for the full guide.
Discover Mode
Re-run init on an existing setup to detect and add new AI CLI targets:
Global
skillshare init --discover # Interactive selection
skillshare init --discover --select codex,opencode # Non-interactive
Scans for newly installed AI CLIs not yet in your config and prompts you to add them.
Project
skillshare init -p --discover # Interactive selection
skillshare init -p --discover --select gemini # Non-interactive
Scans the project directory for new AI CLI directories (e.g., .gemini/) and adds them as targets.
:::tip
If you run skillshare init on an already-initialized setup without --discover, the error message will hint you to use it.
:::
Options
| Flag | Description |
|---|---|
--source <path> |
Custom source directory |
--remote <url> |
Set git remote (implies --git; auto-pulls if remote has skills) |
--project, -p |
Initialize project-level skills in current directory |
--copy-from <name|path> |
Copy skills from a specific CLI or path |
--no-copy |
Start with empty source (skip copy prompt) |
--targets <list> |
Comma-separated target names |
--all-targets |
Add all detected targets |
--no-targets |
Skip target selection |
--git |
Initialize git without prompting |
--no-git |
Skip git initialization |
--skill |
Install built-in skillshare skill without prompting (adds /skillshare to AI CLIs) |
--no-skill |
Skip built-in skill installation |
--discover, -d |
Detect and add new AI CLI targets to existing config |
--select <list> |
Comma-separated targets to add (requires --discover) |
--dry-run |
Preview without changes |
Common Scenarios
# Standard setup (auto-detect everything)
skillshare init
# Setup with git remote for cross-machine sync
# → Auto-pulls existing skills if the remote is not empty
skillshare init --remote git@github.com:you/my-skills.git
# Second machine: same command pulls your skills automatically
skillshare init --remote git@github.com:you/my-skills.git
# Use existing skills directory
skillshare init --source ~/.config/skillshare/skills
# Project-level setup
skillshare init -p
skillshare init -p --targets claude,cursor
# Fully non-interactive setup
skillshare init --no-copy --all-targets --git --skill
# Add newly installed CLIs to existing config
skillshare init --discover
skillshare init -p --discover