Files
skillshare/website/docs/getting-started/quick-reference.md
T
Willie 8ec53065b5 feat(install): fix hidden-dir discovery, add fuzzy search, and improve install UX
discoverSkills() skipped all dot-prefixed dirs, causing repos like
openai/skills (which use .curated/ and .system/) to find 0 skills.
Fix: only skip .git, traverse all other hidden dirs.

CLI --skill flag now falls back to fuzzy matching (via lithammer/fuzzysearch)
when exact match fails. Single fuzzy match auto-selects; ambiguous matches
show "did you mean" suggestions.

UI SkillPickerModal gains a filter input (autofocus, substring on name+path)
that appears for >5 skills. Select All toggles only filtered skills.

Batch install toast fix: always show summary toast even when some skills
are blocked by security audit (previously early-returned with no feedback).
Audit dialog now targets only blocked skills for force-retry.

CLI output for mixed results: use warning banner instead of success,
show failures first, condense >10 successes into a single line.
2026-02-10 02:23:16 +08:00

3.6 KiB

sidebar_position
sidebar_position
4

Quick Reference

Command cheat sheet for skillshare.

Core Commands

Command Description
init First-time setup
install <source> Add a skill
uninstall <name> Remove a skill
list List all skills
search <query> Search for skills
sync Push to all targets
status Show sync state

Skill Management

Command Description
new <name> Create a new skill
update <name> Update a skill (git pull)
update --all Update all tracked repos
upgrade Upgrade CLI and built-in skill

Target Management

Command Description
target list List all targets
target <name> Show target details
target <name> --mode <mode> Change sync mode
target add <name> <path> Add custom target
target remove <name> Remove target safely
diff [target] Show differences

Sync Operations

Command Description
collect <target> Collect skills from target to source
collect --all Collect from all targets
backup [target] Create backup
backup --list List backups
restore <target> Restore from backup
push [-m "msg"] Push to git remote
pull Pull from git and sync

Utilities

Command Description
doctor Diagnose issues
ui Launch web dashboard on localhost:19420
mise run test:docker Run offline Docker sandbox tests
mise run test:docker:online Run optional online Docker tests
mise run sandbox:up Start persistent playground container
mise run sandbox:shell Enter playground shell
mise run sandbox:down Stop playground container
make test-docker Run offline Docker sandbox tests
make test-docker-online Run optional online Docker tests
make sandbox-up Start persistent playground container
make sandbox-shell Enter playground shell
make sandbox-down Stop playground container
mise run ui:build Build frontend + copy to embed
mise run build:all Full binary with embedded frontend
make ui-build Build frontend + copy to embed
make build-all Full binary with embedded frontend

Common Workflows

Install and sync a skill

skillshare install anthropics/skills/skills/pdf
skillshare sync

Create and deploy a skill

skillshare new my-skill
# Edit ~/.config/skillshare/skills/my-skill/SKILL.md
skillshare sync

Cross-machine sync

# Machine A: push changes
skillshare push -m "Add new skill"

# Machine B: pull and sync
skillshare pull

Team skill sharing

# Install team repo
skillshare install github.com/team/skills --track

# Update from team
skillshare update --all
skillshare sync

Sandbox playground session

mise run sandbox:up
mise run sandbox:shell
skillshare --help
ss status
mise run sandbox:down
make sandbox-up
make sandbox-shell
skillshare --help
ss status
make sandbox-down

Key Paths

Path Description
~/.config/skillshare/config.yaml Configuration file
~/.config/skillshare/skills/ Source directory
~/.config/skillshare/backups/ Backup directory

Flags Available on Most Commands

Flag Description
--dry-run, -n Preview without making changes
--help, -h Show help

See Also