skilldrop-cli 0.11.4 → 0.11.5

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.
Files changed (2) hide show
  1. package/README.md +19 -4
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -297,14 +297,29 @@ npx skilldrop-cli list --json # machine-readable: lis
297
297
 
298
298
  ### Or: the Claude Code plugin marketplace
299
299
 
300
- skilldrop is also a **Claude Code plugin marketplace** — install the whole catalogue as one plugin, no npm step:
300
+ skilldrop is also a **Claude Code plugin marketplace** — one marketplace, seven plugins, no npm step. Add it once:
301
301
 
302
302
  ```text
303
303
  /plugin marketplace add sananthanarayan/skilldrop
304
- /plugin install skilldrop@skilldrop
305
304
  ```
306
305
 
307
- Every skill then invokes as `/skilldrop:<name>` (e.g. `/skilldrop:prfaq`), and the reviewer subagents come with it. The marketplace ships the flat `skills/` and `agents/` trees at the repo root unchanged — same copy-install premise, expressed in Claude's own plugin format. `.claude-plugin/{marketplace,plugin}.json` are generated from `package.json` by [`build_marketplace.py`](build_marketplace.py) (`--check` guards drift in CI). Use the CLI above when you want per-pack or per-skill granularity, another IDE, or hooks; use the marketplace when you're in Claude Code and want everything in two lines. Rationale and the deferred per-pack-plugin step: [RFC-0014](docs/rfcs/0014-agentbundle-interop.md).
306
+ Then take the whole catalogue, or just your role's pack:
307
+
308
+ ```text
309
+ /plugin install skilldrop@skilldrop # all 57 skills + 3 reviewer subagents
310
+ /plugin install solution-architect@skilldrop # 17 skills
311
+ /plugin install dev-team@skilldrop # 14 skills + the 3 reviewer subagents
312
+ /plugin install product-manager@skilldrop # 13 skills
313
+ /plugin install ai-engineering@skilldrop # 12 skills
314
+ /plugin install stakeholder-comms@skilldrop # 9 skills
315
+ /plugin install sre-oncall@skilldrop # 5 skills
316
+ ```
317
+
318
+ Every skill then invokes as `/<plugin>:<name>` (e.g. `/skilldrop:prfaq`). The whole-catalogue plugin ships the flat `skills/` and `agents/` trees at the repo root unchanged — same copy-install premise, expressed in Claude's own plugin format.
319
+
320
+ The six **pack plugins** work differently, because a plugin's skills have to sit in a `skills/` folder inside the plugin. Rather than duplicate every skill into six directories on `main` — physical packs, which [RFC-0001](docs/rfcs/0001-skill-packs.md) rejected — the marketplace entries use Claude's `git-subdir` source to point at `packs/<name>/` on a generated [`plugins`](https://github.com/sananthanarayan/skilldrop/tree/plugins) branch, rebuilt by CI on every push to main. Nothing moves in the source tree, and you still only ever type the one `marketplace add`. A pack carries the reviewer subagents its own skills delegate to, so `dev-team` brings the review panel and `sre-oncall` does not.
321
+
322
+ `.claude-plugin/{marketplace,plugin}.json` are generated from `package.json` + `packs.json` by [`build_marketplace.py`](build_marketplace.py) (`--check` guards drift in CI; `--dist` renders the branch). Use the CLI above when you want per-skill granularity, another IDE, or hooks; use the marketplace when you're in Claude Code. Rationale: [RFC-0027](docs/rfcs/0027-retire-agentbundle-export.md).
308
323
 
309
324
  ### Hooks (opt-in) — wire a skill to an event
310
325
 
@@ -357,7 +372,7 @@ npx skilldrop-cli install --pack starter --from ../local-catalog
357
372
  npx skilldrop-cli update # updates bundled and third-party skills side by side — the ledger remembers each skill's source
358
373
  ```
359
374
 
360
- The CLI also reads **agentbundle-shaped catalogs** ([agent-ready-repo](https://github.com/eugenelim/agent-ready-repo)) — `packs/<pack>/.apm/skills/<name>/SKILL.md` with a `pack.toml` per pack — so you can install *its* packs through the same command ([RFC-0014](docs/rfcs/0014-agentbundle-interop.md)). Both shapes share the agentskills.io `SKILL.md`, so the reader just maps his packs onto the accessors above:
375
+ The CLI also reads **agentbundle-shaped catalogs** ([agent-ready-repo](https://github.com/eugenelim/agent-ready-repo)) — `packs/<pack>/.apm/skills/<name>/SKILL.md` with a `pack.toml` per pack — so you can install *its* packs through the same command ([RFC-0014](docs/rfcs/0014-agentbundle-interop.md)). This is one-directional by design: skilldrop reads his shape, and no longer publishes a generated catalogue back into it ([RFC-0027](docs/rfcs/0027-retire-agentbundle-export.md)). Both shapes share the agentskills.io `SKILL.md`, so the reader just maps his packs onto the accessors above:
361
376
 
362
377
  ```bash
363
378
  npx skilldrop-cli packs --from https://github.com/eugenelim/agent-ready-repo
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skilldrop-cli",
3
- "version": "0.11.4",
3
+ "version": "0.11.5",
4
4
  "description": "Portable AI-agent skills for the deliverables knowledge workers ship — diagrams, ADRs, PRDs, runbooks, decks, reviews — installable into Claude Code, Cursor, Kiro, and any IDE that takes custom instructions. One command per skill or per role-based pack.",
5
5
  "author": {
6
6
  "name": "Sanjay Ananthanarayan",