Files
skillshare/website/docs/reference/commands/init.md
T
Willie caa525b8aa feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
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)
2026-02-26 22:27:23 +08:00

4.9 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.

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.

# 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 <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, -c <name|path> Copy skills from a specific CLI or path
--no-copy Start with empty source (skip copy prompt)
--targets, -t <list> Comma-separated target names
--all-targets Add all detected targets
--no-targets Skip target selection
--mode, -m <mode> 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 <list> 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:

skillshare target cursor --mode copy
skillshare sync

Common Scenarios

Remote setup (pick one)

Interactive (recommended for first-time setup when you want guided prompts):

skillshare init --remote git@github.com:you/my-skills.git

Non-interactive (no prompts, auto-detect installed targets):

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):

skillshare init --remote git@github.com:you/my-skills.git --copy-from claude --all-targets --no-skill

Other scenarios

# 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