Files
skillshare/website/docs/commands/init.md
T
Willie 0e25056df8 refactor(docs): replace ASCII box-drawing diagrams with Mermaid SVG
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)
2026-02-19 23:56:11 +08:00

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 --remote to 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