Skillshare CLI

Global: ~/.config/skillshare/skills/ → all AI CLIs. Project: .skillshare/skills/ → repo-local. Auto-detects project mode when .skillshare/config.yaml exists. Force with -p or -g.

Recipes

Getting Started

bash
1skillshare init --no-copy --all-targets --git --skill  # Fresh global setup
2skillshare init -p --targets "claude,cursor"            # Fresh project setup
3skillshare init --copy-from claude --all-targets --git  # Import from existing CLI
4skillshare init --discover --select "windsurf"          # Add new AI tool later

Installing Skills

bash
1skillshare install user/repo -s pdf,commit       # Select specific skills
2skillshare install user/repo --all               # Install everything
3skillshare install user/repo --into frontend     # Place in subdirectory
4skillshare install gitlab.com/team/repo          # Any Git host
5skillshare install user/repo --track             # Enable `update` later
6skillshare install user/repo -s pdf -p           # Install to project
7skillshare install                               # Reinstall all tracked remotes from config
8skillshare sync                                  # Always sync after install
9skillshare sync extras                           # Sync non-skill extras (rules, commands)
10skillshare sync --all                            # Sync skills + extras together

Creating & Discovering Skills

bash
1skillshare new my-skill                          # Create a new skill from template
2skillshare search "react testing"                # Search GitHub for skills
3skillshare collect                               # Pull target-local changes back to source

Removing Skills

bash
1skillshare uninstall my-skill                    # Remove one (moves to trash)
2skillshare uninstall skill-a skill-b             # Remove multiple
3skillshare uninstall -G frontend                 # Remove entire group
4skillshare sync                                  # Always sync after uninstall

Team / Organization

bash
1# Creator: init project (see Getting Started) → add skills → commit .skillshare/
2skillshare install -p && skillshare sync                  # Member: clone → install → sync
3skillshare install github.com/team/repo --track -p        # Track shared repo
4skillshare push                                           # Cross-machine: push on A
5skillshare pull                                           # Cross-machine: pull on B

Skill Hubs

bash
1skillshare hub add https://example.com/hub.json          # Save a hub source
2skillshare hub add https://example.com/hub.json --label my-hub  # With custom label
3skillshare hub list                                      # List saved hubs
4skillshare hub default my-hub                            # Set default hub
5skillshare hub remove my-hub                             # Remove a hub
6skillshare hub index --source ~/.config/skillshare/skills/ --full --audit  # Build hub index

Controlling Where Skills Go

bash
1# SKILL.md frontmatter: targets: [claude]        → only syncs to Claude
2skillshare target claude --add-include "team-*"   # glob filter
3skillshare target claude --add-exclude "_legacy*"  # exclude pattern
4skillshare target codex --mode copy && skillshare sync --force  # copy mode

See targets.md for details.

Updates & Maintenance

bash
1skillshare check                              # See what has updates
2skillshare update my-skill && skillshare sync  # Update one
3skillshare update --all && skillshare sync     # Update all
4skillshare update --all --diff                 # Show what changed

Scripting & CI/CD

bash
1skillshare status --json                       # Full status as JSON
2skillshare check --json                        # Update status as JSON
3skillshare sync --json                         # Sync results as JSON
4skillshare diff --json                         # Diff results as JSON
5skillshare install user/repo --json            # Install result as JSON (implies --force --all)
6skillshare update --all --json                 # Update results as JSON
7skillshare uninstall my-skill --json           # Uninstall result as JSON (implies --force)
8skillshare collect claude --json               # Collect result as JSON (implies --force)
9skillshare target list --json                  # Target list as JSON
10skillshare list --json                         # Skill list as JSON
11skillshare search react --json                 # Search results as JSON
12skillshare audit --format json                 # Audit results as JSON

Recovery & Troubleshooting

bash
1skillshare trash restore <name> && skillshare sync  # Undo delete
2skillshare sync                                     # Skill missing? Re-sync
3skillshare doctor && skillshare status              # Diagnose issues
4skillshare install user/repo --force                 # Override audit block
5skillshare install user/repo --skip-audit            # Bypass scan entirely

See TROUBLESHOOTING.md for more.

Quick Lookup

AI Caller Rules

1. Non-interactive — AI cannot answer prompts. Use --force, --all, -s, --targets, --no-copy, --all-targets, --yes.
2. Sync after mutations — install, uninstall, update, collect, target all need sync.
3. Audit — install auto-scans; CRITICAL blocks. --force to override, --skip-audit to bypass. Detects hardcoded secrets (API keys, tokens, private keys).
4. Uninstall safely — moves to trash (7 days). trash restore <name> to undo. NEVER rm -rf symlinks.
5. Output — --json for structured data (12 commands support it, see Quick Lookup). --no-tui for plain text on TUI commands (list, log, audit, diff, trash list, backup list). tui off disables TUI globally. --dry-run to preview.

References