ccski 1.0.3 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -37,7 +37,7 @@ Run with `--skill-dir` to add extra roots, or `--no-refresh` to disable live rel
37
37
  | ------------------------------------------- | ---------------------------------------------------------------------------------------- |
38
38
  | `ccski list` | Show discovered skills (projects, home, plugin marketplace) with status badges |
39
39
  | `ccski info <name>` | Inspect metadata and preview content |
40
- | `ccski install <source> [-i\|--all\|--use]` | Install skills from git/dir/marketplace; interactive picker shows final one-shot command |
40
+ | `ccski install <source> [-i\|--all\|--path]` | Install skills from git/dir/marketplace; interactive picker shows final one-shot command |
41
41
  | `ccski enable [names...] [-i\|--all]` | Restore `.SKILL.md` → `SKILL.md`; interactive defaults **unchecked** |
42
42
  | `ccski disable [names...] [-i\|--all]` | Disable skills by flipping to `.SKILL.md` |
43
43
  | `ccski mcp` | Start MCP server (stdio/http/sse) |
@@ -45,6 +45,36 @@ Run with `--skill-dir` to add extra roots, or `--no-refresh` to disable live rel
45
45
 
46
46
  Interactive pickers across install/enable/disable share the same layout, colors, and live “Command:” preview so you can copy/paste the equivalent non-interactive invocation.
47
47
 
48
+ ### Install deep dive
49
+
50
+ - **Sources**: git URL (with `--branch`, `--path`, `--mode git` default for http/https), local dir/file (`--mode file`), `marketplace.json`, or direct `SKILL.md`.
51
+ - **Granular selection**: `-i/--interactive` to pick; `--all`; positional filters for fuzzy name matching.
52
+ - **Where it lands**: project `.claude/skills` by default, or `--global` to `~/.claude/skills`.
53
+ - **Force/overwrite**: `--force`/`--override` to replace existing skill folder.
54
+
55
+ #### Examples
56
+
57
+ - Repo root(default branch, auto-detect marketplace)
58
+ `ccski install https://github.com/wshobson/agents`
59
+
60
+ - Repo branch with marketplace
61
+ `ccski install https://github.com/wshobson/agents/tree/main` or `--branch main`
62
+
63
+ - Specific file inside repo (auto clone, blob path)
64
+ `ccski install https://github.com/wshobson/agents/blob/main/.claude-plugin/marketplace.json`
65
+
66
+ - Local directory (no git)
67
+ `ccski install /path/to/skills --mode file`
68
+
69
+ - Direct SKILL.md
70
+ `ccski install ./plugins/foo/SKILL.md`
71
+
72
+ ### How this differs from “claude plugin install”
73
+
74
+ - **Install target**: ccski copies **SKILL.md skills** into `.claude/skills`; `claude plugin install` pulls a **Claude plugin package** (commands + metadata) into the Claude app. Two different ecosystems.
75
+ - **Sources**: ccski supports git / local dir / marketplace.json / direct SKILL.md. Claude plugins come from the Claude plugin directory/store.
76
+ - **Flexibility**: ~ccski can mix many repos (including private git) and expose them via MCP; Claude plugin installs can’t be combined this way.~
77
+
48
78
  ## 3) Thanks & lineage
49
79
 
50
80
  - **openskills** — established the SKILL.md authoring pattern; we align with that spec for compatibility.