claude-skills/skillshare/references/init.md

Init Command

Initializes skillshare configuration.

Key Concept

Source is always ~/.config/skillshare/skills — never a CLI directory like .claude/skills.

• --copy-from claude = import skills FROM claude INTO source
• --copy-from does NOT change where source is located

Copy Source Flags (mutually exclusive)

Flag	Description
--copy-from <name|path>	Copy skills from target name or directory path
--no-copy	Start with empty source

Target Flags (mutually exclusive)

Flag	Description
--targets <list>	Comma-separated targets: "claude,cursor,codex"
--all-targets	Add all detected CLI targets
--no-targets	Skip target setup

Git Flags (mutually exclusive)

Flag	Description
--git	Initialize git in source (recommended)
--no-git	Skip git initialization

Discover Flags (for adding new agents to existing config)

Flag	Description
--discover	Detect and add new agents to existing config (interactive)
--select <list>	Comma-separated agents to add (non-interactive, requires --discover)

Other Flags

Flag	Description
--source <path>	Custom source directory (only if user explicitly requests)
--remote <url>	Set git remote (implies --git)
--dry-run	Preview without making changes

AI Note: Never use --source unless the user explicitly asks to change the source location.

Examples

# Fresh start with all targets and git
skillshare init --no-copy --all-targets --git

# Copy from Claude, specific targets
skillshare init --copy-from claude --targets "claude,cursor" --git

# Minimal setup
skillshare init --no-copy --no-targets --no-git

# Custom source with remote
skillshare init --source ~/my-skills --remote git@github.com:user/skills.git

# Add new agents to existing config (non-interactive)
skillshare init --discover --select "windsurf,kilocode"

# Add new agents (interactive)
skillshare init --discover