@ssheleg/make-skill 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## v0.2.0 — 2026-07-24
+
+Correct multi-agent + cross-platform distribution guidance (learned shipping the
+`sshlg-skills` umbrella).
+
+- **skills CLI, multiple agents:** documented that multiple agents need
+  **repeated `--agent` flags** (`--agent cursor --agent zed`) — a comma/space
+  value is read as one invalid agent. Exact agent ids (`kimi` → `kimi-code-cli`,
+  `hermes` → `hermes-agent`), the `universal`/`*` targets, and the
+  `--agent __x__` trick to print the valid list.
+- **Umbrella / family distribution** (new matrix item): ship a family of skills
+  from their own repos aggregated as git submodules, with a zero-dep launcher
+  wrapping `npx skills add` + `claude plugin` + `git submodule update --remote`
+  and a `skills.json` source of truth — reference impl `ssheleg/sshlg-skills`.
+- **Platforms:** the Node installer, `npx github:`, the plugin, and the skills
+  CLI are cross-platform; `install.sh` is POSIX-only (on Windows use npx/plugin/
+  skills CLI). Build bin paths with `path.join`, never hardcoded `/`.
+
 ## v0.1.0 — 2026-07-24
 
 Initial release — the `make-skill` meta-skill promoted from a personal skill into

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssheleg/make-skill",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Create, retrofit, and ship agent skills & Claude Code plugins the proven ssheleg way — marketplace repo layout, four-way version sync, validator + CI, multi-channel distribution (plugin, vercel skills CLI, npx, Cursor), npm gotchas, end-to-end first publish. This package is the installer CLI.",
   "bin": {
     "make-skill": "bin/make-skill.js"

package/plugins/make-skill/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "make-skill",
   "description": "Create, retrofit, and ship agent skills & Claude Code plugins the proven ssheleg way: marketplace repo layout, four-way version sync, validator + CI, multi-channel distribution (plugin, vercel skills CLI, npx, Cursor), npm gotchas, end-to-end first publish. Reference impls: super-ux (structure) + task-pipeline (config-contract + release automation).",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "author": { "name": "ssheleg" },
   "homepage": "https://github.com/ssheleg/make-skill",
   "repository": "https://github.com/ssheleg/make-skill",

package/plugins/make-skill/skills/make-skill/SKILL.md

@@ -158,11 +158,16 @@ duplicate skill listings confuse agents.
 2. **vercel-labs skills CLI (70+ agents):** `npx skills add <owner>/<repo>`
    — discovers skills through `.claude-plugin/marketplace.json`
    automatically; correct manifest = free compatibility. Non-interactive
-   flags: `--agent <name>|'*'`, `--global`, `--yes`, `--all` (= `--skill '*'
-   --agent '*' -y`); update with `npx skills update <name> --global --yes`.
-   Copies land in `~/.agents/skills/<name>`. **Do NOT `--agent '*'` when the
-   skill is also a Claude Code plugin** — it re-creates a `~/.claude/skills`
-   copy that shadows the plugin (see Gotchas).
+   flags: `--global`, `--yes`, `--all` (= `--skill '*' --agent '*' -y`);
+   update with `npx skills update <name> --global --yes`. Copies land in
+   `~/.agents/skills/<name>`. **Multiple agents = REPEATED `--agent` flags**
+   (`--agent cursor --agent zed`); a comma/space-joined value
+   (`--agent cursor,zed`) is read as one invalid agent. Agent ids are exact:
+   `kimi` → `kimi-code-cli`, `hermes` → `hermes-agent`; `universal` and `*`
+   target everything; `npx skills add <repo> --agent __x__` prints the valid
+   list. **Do NOT include `claude-code` (or `--agent '*'`) when the skill is
+   also a Claude Code plugin** — it re-creates a `~/.claude/skills` copy that
+   shadows the plugin (see Gotchas).
 3. **npx installer:** package.json (`bin`, `files` whitelist) + zero-dep
    CLI; works WITHOUT registry publish via `npx github:<owner>/<repo>`;
    registry publish only buys the short `npx <name>`.
@@ -173,6 +178,20 @@ duplicate skill listings confuse agents.
    `globs`); NO relative links inside .mdc (copied into foreign projects —
    embed contracts inline). Cursor has no native *global rules* dir, so global
    = skills CLI, per-project = `.mdc`, or paste into Cursor Settings → Rules.
+5. **Ship a FAMILY via an umbrella repo** (reference: `ssheleg/sshlg-skills`):
+   the skills live in their own repos, aggregated as git **submodules**, with a
+   zero-dep **launcher** that wraps the three engines above — `npx skills add`
+   (non-Claude agents, repeated `--agent`), `claude plugin` (Claude Code, to
+   avoid the shadow copy), and `git submodule update --remote` (bump pinned
+   snapshots on `update`). A `skills.json` manifest is the source of truth; the
+   validator keeps it in sync with `.gitmodules`. One command installs/updates
+   the whole family everywhere.
+
+**Platforms.** The Node installer (`bin/*.js`, `os.homedir()`/`path.join`), `npx
+github:…`, the Claude Code plugin, and the skills CLI are **cross-platform**
+(macOS / Linux / Windows). `install.sh` is POSIX-only — on Windows use `npx`,
+the plugin, or the skills CLI, never `install.sh`. Keep bin paths built with
+`path.join`, never hardcoded `/`.
 
 ## Gotchas (each cost a debugging round)
 
@@ -185,6 +204,11 @@ duplicate skill listings confuse agents.
   names are exempt) + `"publishConfig": {"access": "public"}` so `npm publish`
   needs no flag; or pick a clearly dissimilar unscoped name. The `bin` command
   name is independent of the package name — keep it short even when scoped.
+- **First scoped publish lags the read path:** right after a successful publish,
+  `npm view @scope/pkg` can still E404 for ~1–2 min (write-master has it, read
+  replica hasn't). A publish that 403s "cannot publish over previously published
+  versions" PROVES it already landed — poll `npm view`, don't re-publish or assume
+  failure.
 - **npx inside the package's own repo** resolves to the local package →
   false `command not found`. Always e2e-test from another cwd.
 - **Piped stdin + readline:** sequential `rl.question()` drops buffered