mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
Add skillshare move and POST /api/resources/batch/move so skills and whole folders can change folder inside the source while keeping their .metadata.json entry, accepted audit findings, lockfile pin, config group, .gitignore and literal .skillignore lines. Moving by hand lost the record and made the next install start over. install --into now refuses a folder inside a skill or a tracked checkout. Refs #510
210 lines
6.6 KiB
Markdown
210 lines
6.6 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) |
|
|
| 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`, `inspect`, `sync`, `check`, `update`, `enable`, `disable`, `remove`) |
|
|
| **Target Management** | `target`, `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 |
|
|
| [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 |
|
|
| [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
|