--- sidebar_position: 1 --- # init First-time setup. Auto-detects installed AI CLIs and configures targets. ```bash 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 ```mermaid 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`: ```bash skillshare init -p # Interactive skillshare init -p --targets claude,cursor # Non-interactive ``` ### What Happens ```mermaid 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](/docs/how-to/sharing/project-setup) for the full guide. ## Discover Mode Re-run init on an existing setup to detect and add new AI CLI targets: ### Global ```bash 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 ```bash 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. ### Discover + Mode behavior When you combine `--discover` with `--mode`, the mode is applied **only** to targets added in this discover run. Existing targets in config are left unchanged. ```bash # Adds cursor with mode=copy, does not change existing targets skillshare init --discover --select cursor --mode copy # Project mode variant (same rule) skillshare init -p --discover --select cursor --mode copy ``` :::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, -s ` | Custom source directory | | `--remote ` | Set git remote (implies `--git`; auto-pulls if remote has skills) | | `--project, -p` | Initialize project-level skills in current directory | | `--copy-from, -c ` | Copy skills from a specific CLI or path | | `--no-copy` | Start with empty source (skip copy prompt) | | `--targets, -t ` | Comma-separated target names | | `--all-targets` | Add all detected targets | | `--no-targets` | Skip target selection | | `--mode, -m ` | Set default mode for newly configured targets (`merge`, `copy`, `symlink`). With `--discover`, affects only newly added targets. | | `--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 ` | Comma-separated targets to add (requires `--discover`) | | `--dry-run, -n` | Preview without changes | `init` sets your starting mode policy. You can always fine-tune per target later: ```bash skillshare target cursor --mode copy skillshare sync ``` ## Common Scenarios ### Remote setup (pick one) Interactive (recommended for first-time setup when you want guided prompts): ```bash skillshare init --remote git@github.com:you/my-skills.git ``` Non-interactive (no prompts, auto-detect installed targets): ```bash skillshare init --remote git@github.com:you/my-skills.git --no-copy --all-targets --no-skill ``` Non-interactive (no prompts, and import existing Claude skills now): ```bash skillshare init --remote git@github.com:you/my-skills.git --copy-from claude --all-targets --no-skill ``` ### Other scenarios ```bash # Standard setup (auto-detect everything) skillshare init # 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 # Start with copy mode defaults for newly added targets skillshare init --mode copy # Add newly installed CLIs to existing config skillshare init --discover skillshare init -p --discover # Add a newly discovered target and force copy mode only for that new target skillshare init --discover --select cursor --mode copy ```