From acca11fa5faa688e75d5ab5eb7d566520719db7a Mon Sep 17 00:00:00 2001 From: Willie Date: Tue, 10 Feb 2026 11:57:28 +0800 Subject: [PATCH] refactor: slim built-in skill to reduce context window cost MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reduce SKILL.md description (959→506 chars) and body (117→66 lines) by removing content already covered in references/ (Quick Start, verbose examples, Finding Skills section). Zero information loss. --- skills/skillshare/SKILL.md | 86 ++++++++------------------------------ 1 file changed, 17 insertions(+), 69 deletions(-) diff --git a/skills/skillshare/SKILL.md b/skills/skillshare/SKILL.md index 18e03adf0..8dccef237 100644 --- a/skills/skillshare/SKILL.md +++ b/skills/skillshare/SKILL.md @@ -3,17 +3,11 @@ name: skillshare version: 0.11.0 description: | Syncs skills across AI CLI tools (Claude, Cursor, Windsurf, etc.) from a single source of truth. - Supports both global mode (~/.config/skillshare/) and project mode (.skillshare/ per-repo). - Use when: "sync skills", "install skill", "search skills", "list skills", "show skill status", - "backup skills", "restore skills", "update skills", "new skill", "collect skills", - "push/pull skills", "add/remove target", "find a skill for X", "is there a skill that can...", - "how do I do X with skills", "skillshare init", "skillshare upgrade", "skill not syncing", - "diagnose skillshare", "doctor", "project skills", "init project", "project setup", - "scope skills to repo", "share skills via git", "web dashboard", "skillshare ui", - "audit skills", "security scan", "check skill safety", - "trash", "restore deleted skill", "undo uninstall", "empty trash", - "operation log", "show history", "what changed", "check for updates", - or any skill/target management across AI tools. + Global mode (~/.config/skillshare/) and project mode (.skillshare/ per-repo). + Commands: status, sync, install, uninstall, update, check, search, new, collect, + push, pull, diff, list, doctor, audit, trash, log, backup, restore, target, ui, upgrade. + Use when: managing skills across AI tools, "skillshare" CLI, skill sync/install/search, + project skills setup, security audit, web dashboard, or troubleshooting. argument-hint: "[command] [target] [--dry-run] [-p|-g]" --- @@ -29,17 +23,6 @@ Project: .skillshare/skills/ → .claude/skills, .cursor/skills (per-repo Auto-detection: commands run in **project mode** when `.skillshare/config.yaml` exists in cwd. Force with `-p` (project) or `-g` (global). -## Quick Start - -```bash -# Global -skillshare status && skillshare sync - -# Project — initialize in a repo -skillshare init -p -skillshare sync -``` - ## Commands | Category | Commands | Project? | @@ -62,60 +45,25 @@ skillshare sync ### Non-Interactive Mode -AI cannot respond to CLI prompts. Always use flags: +AI cannot respond to CLI prompts. Always pass flags to skip interactive prompts. ```bash -# Global init -skillshare init --copy-from claude --all-targets --git # If skills exist -skillshare init --no-copy --all-targets --git # Fresh start - -# Project init (in repo root) -skillshare init -p --targets "claude-code,cursor" # Specific targets -skillshare init -p # Interactive (user only) - -# Install (multi-skill repo non-interactive) -skillshare install user/repo --all # Install all -skillshare install user/repo -s pdf,commit # Select specific -skillshare install user/repo -y # Auto-accept -skillshare install user/repo --force # Override audit block - -# Add new agents later -skillshare init --discover --select "windsurf,kilocode" -skillshare init -p --discover --select "windsurf" +# Key non-interactive patterns +skillshare init --no-copy --all-targets --git # Global fresh start +skillshare init -p --targets "claude-code,cursor" # Project init +skillshare install user/repo --all # Install all skills +skillshare install user/repo -s pdf,commit # Select specific ``` +See [init.md](references/init.md) and [install.md](references/install.md) for all flags. + ### Safety -**Security audit:** `install` auto-scans skills. CRITICAL findings block install; use `--force` to override. +- `install` auto-scans skills; **CRITICAL** findings block install (`--force` to override) +- `uninstall` moves to **trash** (7-day retention) — restore with `trash restore ` +- **NEVER** `rm -rf` symlinked skills — deletes source. Use `skillshare uninstall` or `target remove` -```bash -skillshare audit # Scan all skills -skillshare audit my-skill # Scan specific skill -skillshare install user/repo --force # Override CRITICAL block -``` - -**Soft-delete:** `uninstall` moves skills to trash (7-day retention). Restore with `trash restore`. - -```bash -skillshare trash list # See trashed skills -skillshare trash restore my-skill # Undo uninstall -skillshare trash empty # Permanent delete all -``` - -**NEVER** `rm -rf` symlinked skills — deletes source. Always use: -- `skillshare uninstall ` to remove skills (goes to trash) -- `skillshare target remove ` to unlink targets - -### Finding Skills - -```bash -skillshare search # Browse popular skills -skillshare search # Interactive install -skillshare search --list # List only -skillshare search --json # JSON output -``` - -**Query examples:** `react performance`, `pr review`, `commit`, `changelog` +See [audit.md](references/audit.md) and [trash.md](references/trash.md) for details. ## References