mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
Add a global automatic-update preference with an environment override, CLI controls and dashboard settings. Suppress automatic release checks and cached notices while retaining explicit checks and upgrades. Recheck policy before publishing in-flight results, preserve structured JSON errors, and reject incomplete manual checks. Include schema, completion, localization, documentation and regression coverage. Closes #846.
213 lines
6.9 KiB
Markdown
213 lines
6.9 KiB
Markdown
---
|
|
sidebar_position: 1
|
|
---
|
|
|
|
# Commands
|
|
|
|
Complete reference for all skillshare commands.
|
|
|
|
## What do you want to do?
|
|
|
|
| I want to... | Command |
|
|
|--------------|---------|
|
|
| Set up skillshare for the first time | [`init`](./init.md) |
|
|
| Manage project folders from the global config | [`project`](/docs/reference/commands/project) |
|
|
| Install a skill from GitHub | [`install`](./install.md) |
|
|
| Create my own skill | [`new`](./new.md) |
|
|
| Sync skills to all AI CLIs | [`sync`](./sync.md) |
|
|
| Check what's out of sync | [`status`](./status.md) / [`diff`](./diff.md) |
|
|
| Search for community skills | [`search`](./search.md) |
|
|
| Update installed skills | [`check`](./check.md) then [`update`](./update.md) |
|
|
| Temporarily hide a skill without removing it | [`enable` / `disable`](./enable.md) |
|
|
| Move installed skills into folders | [`move`](./move.md) |
|
|
| Save or sync changes with git | [`commit`](./commit.md) / [`push`](./push.md) / [`pull`](./pull.md) |
|
|
| Set up an MCP server once for every tool | [`mcp`](./mcp.md) |
|
|
| Manage native hooks across tools | [`hooks`](./hooks.md) |
|
|
| Manage complete plugins across supported tools | [`plugin`](./plugin.md) |
|
|
| Manage non-skill resources (rules, commands) | [`extras`](./extras.md) |
|
|
| Manage single-file `.md` agents | Most commands accept `agents` or `--kind agent` — see [Agents](/docs/understand/agents) |
|
|
| See which skills use the most context tokens | [`analyze`](./analyze.md) |
|
|
| Fix something broken | [`doctor`](./doctor.md) |
|
|
| Enable tab-completion in my shell | [`completion`](./completion.md) |
|
|
| Open the web dashboard | [`ui`](./ui.md) |
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
| Category | Commands |
|
|
|----------|----------|
|
|
| **Core** | `init`, `install`, `uninstall`, `link`, `unlink`, `list`, `search`, `sync`, `status` |
|
|
| **Skill Management** | `new`, `check`, `update`, `upgrade`, `enable`, `disable`, `move` |
|
|
| **MCP Connections** | `mcp` (`add`, `edit`, `import`, `list`, `remove`, `restore`), `sync mcp` |
|
|
| **Hooks** | `hooks` (`list`, `add`, `edit`, `import`, `enable`, `disable`, `remove`, `sync`, `restore`) |
|
|
| **Plugin Management** | `plugin` (`list`, `discover`, `add`, `import`, `unimport`, `inspect`, `sync`, `check`, `update`, `enable`, `disable`, `remove`) |
|
|
| **Target Management** | `target`, `project`, `diff` |
|
|
| **Extras Management** | `extras` (`init`, `list`, `remove`, `collect`) |
|
|
| **Sync Operations** | `collect`, `backup`, `restore`, `trash`, `commit`, `push`, `pull` |
|
|
| **Security & Utilities** | `analyze`, `audit`, `hub`, `log`, `doctor`, `tui`, `ui`, `completion`, `version` |
|
|
|
|
---
|
|
|
|
## Core Commands
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| [init](./init.md) | First-time setup |
|
|
| [install](./install.md) | Add a skill from a repo or path |
|
|
| [uninstall](./uninstall.md) | Remove a skill |
|
|
| [link](./link.md) | Link a folder of your own skills into the source |
|
|
| [unlink](./unlink.md) | Remove a link from the source |
|
|
| [list](./list.md) | List all skills |
|
|
| [search](./search.md) | Search for skills |
|
|
| [sync](./sync.md) | Push skills to all targets |
|
|
| [status](./status.md) | Show sync state |
|
|
|
|
## Skill Management
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| [new](./new.md) | Create a new skill |
|
|
| [check](./check.md) | Check for available updates |
|
|
| [update](./update.md) | Update a skill or tracked repo |
|
|
| [updates](/docs/reference/commands/updates) | Control automatic version checks and notifications |
|
|
| [upgrade](./upgrade.md) | Upgrade CLI or built-in skill |
|
|
| [enable / disable](./enable.md) | Temporarily enable or disable skills |
|
|
| [move](./move.md) | Move installed skills or folders without losing install records |
|
|
|
|
## Target Management
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| [target](./target.md) | Manage targets |
|
|
| [project](/docs/reference/commands/project) | Manage project folders and sync their skills and agents |
|
|
| [diff](./diff.md) | Show differences between source and targets |
|
|
|
|
## Extras Management
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| [extras](./extras.md) | Manage non-skill resources (rules, commands, prompts) |
|
|
|
|
## MCP, Hooks and Plugins
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| [mcp](./mcp.md) | Define MCP servers once and sync them into each tool's native config |
|
|
| [hooks](./hooks.md) | Manage native hook definitions, synchronization and recovery |
|
|
| [plugin](./plugin.md) | Install complete plugins and choose which tools receive them |
|
|
|
|
## Sync Operations
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| [collect](./collect.md) | Collect skills from target to source |
|
|
| [backup](./backup.md) | Create backup of targets |
|
|
| [restore](./restore.md) | Restore targets from backup |
|
|
| [trash](./trash.md) | Manage uninstalled skills in trash |
|
|
| [commit](./commit.md) | Create a local git commit without pushing |
|
|
| [push](./push.md) | Commit and push to git remote |
|
|
| [pull](./pull.md) | Pull from git remote and sync |
|
|
|
|
## Security & Utilities
|
|
|
|
| Command | Description |
|
|
|---------|-------------|
|
|
| [analyze](./analyze.md) | Analyze context window usage |
|
|
| [audit](./audit.md) | Scan skills for security threats |
|
|
| [log](./log.md) | View operations and audit logs |
|
|
| [doctor](./doctor.md) | Diagnose issues |
|
|
| [tui](./tui.md) | Toggle interactive TUI mode |
|
|
| [ui](./ui.md) | Launch web dashboard |
|
|
| [hub](./hub.md) | Manage skill hub sources |
|
|
| [completion](./completion.md) | Generate shell completion scripts |
|
|
| [version](./version.md) | Show CLI version |
|
|
|
|
---
|
|
|
|
## Common Flags
|
|
|
|
Most commands support:
|
|
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `--dry-run`, `-n` | Preview without making changes |
|
|
| `--help`, `-h` | Show help |
|
|
|
|
---
|
|
|
|
## Quick Reference
|
|
|
|
```bash
|
|
# Setup
|
|
skillshare init
|
|
skillshare init --remote git@github.com:you/skills.git
|
|
|
|
# Install skills
|
|
skillshare install anthropics/skills/skills/pdf
|
|
skillshare install github.com/team/skills --track
|
|
|
|
# Create skill
|
|
skillshare new my-skill
|
|
|
|
# Sync
|
|
skillshare sync
|
|
skillshare sync --dry-run
|
|
|
|
# Git checkpoints / cross-machine
|
|
skillshare commit -m "Update skill"
|
|
skillshare push -m "Add skill"
|
|
skillshare pull
|
|
|
|
# Status
|
|
skillshare status
|
|
skillshare list
|
|
skillshare diff
|
|
|
|
# Enable/disable skills
|
|
skillshare disable draft-*
|
|
skillshare enable draft-*
|
|
|
|
# Maintenance
|
|
skillshare update --all
|
|
skillshare analyze
|
|
skillshare audit
|
|
skillshare log
|
|
skillshare doctor
|
|
skillshare backup
|
|
|
|
# TUI preferences
|
|
skillshare tui # Show current status
|
|
skillshare tui off # Disable interactive TUI
|
|
skillshare tui on # Re-enable TUI
|
|
|
|
# Web UI
|
|
skillshare ui
|
|
skillshare ui -p # Project mode
|
|
|
|
# Hub
|
|
skillshare hub list
|
|
skillshare hub add https://hub.example.com/index.json
|
|
|
|
# Check for updates
|
|
skillshare check
|
|
|
|
# Trash management
|
|
skillshare trash list
|
|
skillshare trash restore my-skill
|
|
|
|
# Shell completion
|
|
skillshare completion bash --install
|
|
skillshare completion zsh --install
|
|
|
|
# Version
|
|
skillshare version
|
|
```
|
|
|
|
---
|
|
|
|
## Related
|
|
|
|
- [Quick Reference](/docs/getting-started/quick-reference) — Command cheat sheet
|
|
- [Workflows](/docs/how-to/daily-tasks) — Common usage patterns
|