skilldrop-cli 0.8.4 → 0.9.0

package/README.md

@@ -14,6 +14,8 @@ npx skilldrop-cli list                               #     sre-oncall, stakehold
 
 Originally scoped to solution architects, now broadly useful to PMs, founders, consultants, engineering leaders, exec assistants — anyone who turns ideas into stakeholder-ready artifacts.
 
+Every skill is a plain `SKILL.md` folder — the [**Agent Skills open standard**](https://agentskills.io) Anthropic ratified — so the same folder runs unchanged in Claude.ai, Claude Code, the Claude Agent SDK, Cursor, Kiro, Codex, Copilot, Antigravity, and anything else that reads the format. Portable by construction: no runtime, no platform, no lock-in.
+
 **Why skilldrop over heavier agent platforms:** every skill is a plain folder (`SKILL.md` + `manifest.json` + supporting files) and installs by *copy, never transformation* — what runs in your IDE is byte-identical to what's reviewed in this repo. The flat layout doubles as an open catalog contract: [any repo shaped like this one](#third-party-catalogs--publish-your-own-skills-through-the-same-cli) is installable through the same CLI. Skills are *opinionated* — each ships a quality bar, anti-patterns, and acceptance evals, so the output is an artifact, not a vibe.
 
 ## How skilldrop works
@@ -259,6 +261,7 @@ npx skilldrop-cli install --pack sre-oncall --ide kiro  # .kiro/skills — Kiro
 npx skilldrop-cli install adr-generator --dest .agents/skills   # Codex + Copilot CLI (see below)
 npx skilldrop-cli agents                                # the reviewer subagents
 npx skilldrop-cli install --agent devils-advocate       # -> ~/.claude/agents/ (RFC-0012)
+npx skilldrop-cli install --panel review                # the whole review fleet: 3 subagents + the pre-merge-review orchestrator (RFC-0020)
 npx skilldrop-cli outdated && npx skilldrop-cli update  # skills improve; cp -R never tells you
 npx skilldrop-cli list | skilldrop info <skill> | skilldrop packs | skilldrop uninstall <skill>
 ```

package/agents/README.md

@@ -26,6 +26,28 @@ npx skilldrop-cli install --agent devils-advocate --ide kiro   # .kiro/agents/*.
 
 They are deliberately **split, not merged.** A single "review my code" agent dilutes all three — bug-hunting, craft, and exploitability pull in different directions. Run them as separate passes; together they are the reviewer panel [`feature-implement-loop`](../skills/feature-implement-loop/SKILL.md) drives after each generation round. `devils-advocate` here is the subagent form of the [`devils-advocate` skill](../skills/devils-advocate/SKILL.md); same persona, packaged for a tool's native agent slot instead of on-demand skill invocation.
 
+## Fire them as a panel
+
+The three reviewers are meant to run **together** on a change. Install the whole fleet in one command:
+
+```bash
+npx skilldrop-cli install --panel review            # 3 subagents + the pre-merge-review orchestrator -> ~/.claude/
+npx skilldrop-cli install --panel review --project  # .claude/ (shared with the repo)
+```
+
+The [`pre-merge-review`](../skills/pre-merge-review/SKILL.md) skill is the **portable orchestrator** — it dispatches the three as **parallel subagents** where the tool has a native subagent runner, and sweeps the lenses inline otherwise. The orchestration lives in the *skill* (portable); the reviewers are *native subagents* (per-tool):
+
+| Tool | How the panel fires in parallel |
+|---|---|
+| **Claude Code** | Native parallel subagents — `pre-merge-review` fires all three at once. `--panel review` installs both halves. |
+| **Kiro** | Native subagents — `--panel review --ide kiro` installs both halves. |
+| **Codex** | Multi-agent runner — install the agents (`--agent … --ide codex`) + the skill; Codex runs the fleet in parallel (confirm the invocation against your Codex version). |
+| **Antigravity** | Lead → specialist delegation — install the agents (`--agent … --ide antigravity`) + the skill; the lead agent delegates to the three, each in its own context. |
+| **Copilot** | Agents install (`--agent … --ide copilot`); the skill drives them — sequentially unless your Copilot build exposes parallel subagents. |
+| **Cursor** | No agent format — `pre-merge-review` sweeps the three lenses inline (no subagents). |
+
+Designing your own fleet? Use [`subagent-design`](../skills/subagent-design/SKILL.md) — the reviewer panel is its "judge panel" topology.
+
 ## Installing an agent into your tool
 
 ### Claude Code (native subagents)

package/bin/skilldrop.js

@@ -20,6 +20,16 @@ const BUNDLED = "bundled";
 // Neutral hook vocabulary (RFC-0006). Kept in sync with validate.py's HOOK_EVENTS.
 const HOOK_EVENTS = ["session-start", "pre-commit-review", "on-demand"];
 
+// Panels (RFC-0020): a named bundle of reviewer subagents + the orchestrator skill that fires
+// them in parallel. `install --panel <name>` installs the whole fleet in one command.
+const PANELS = {
+  review: {
+    agents: ["devils-advocate", "security-reviewer", "code-quality"],
+    skill: "pre-merge-review",
+    blurb: "correctness + security + craft reviewers, fired in parallel by pre-merge-review",
+  },
+};
+
 const HELP = `skilldrop — portable AI-agent skills for Claude Code, Cursor, Kiro, and more
 
 Usage:
@@ -31,6 +41,8 @@ Usage:
   skilldrop install --pack <name>         install a whole pack
   skilldrop install --all                 install every skill in the catalog
   skilldrop install --agent <name...>     install reviewer subagents (RFC-0012)
+  skilldrop install --panel review        install the review panel — the 3 reviewer subagents +
+                                          the pre-merge-review orchestrator that fires them (RFC-0020)
   skilldrop update                        re-copy installed skills whose version changed
   skilldrop outdated                      show installed vs current versions, change nothing
   skilldrop uninstall <skill...>          remove skills (and wiring files this tool wrote)
@@ -74,7 +86,7 @@ function parseArgs(argv) {
   const out = { _: [], flags: {} };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
-    if (a === "--pack" || a === "--ide" || a === "--dest" || a === "--from") out.flags[a.slice(2)] = argv[++i];
+    if (a === "--pack" || a === "--ide" || a === "--dest" || a === "--from" || a === "--panel") out.flags[a.slice(2)] = argv[++i];
     else if (a.startsWith("--")) out.flags[a.slice(2)] = true;
     else out._.push(a);
   }
@@ -567,7 +579,33 @@ function copyOne(cat, s, dest, ide, l, notes) {
   return m;
 }
 
+/* Install a whole review panel — the reviewer subagents + the orchestrator skill — in one
+   command (RFC-0020). Needs a target with BOTH a subagent and a skill format, so it accepts
+   the default (Claude Code), --project, --ide kiro, or --dest; other IDEs install the halves
+   separately. Delegates to installAgents + install so every existing safety/craft gate applies. */
+function installPanel(args) {
+  const name = args.flags.panel;
+  const p = PANELS[name];
+  if (!p) die(`unknown panel '${name}' — available: ${Object.keys(PANELS).join(", ")}`);
+  const ide = args.flags.ide;
+  if (ide && ide !== "kiro" && !args.flags.dest)
+    die(`--panel installs subagents + the orchestrator skill together, so it needs a target with both formats:\n` +
+        `       (default | --project) Claude Code, --ide kiro, or --dest <dir>.\n` +
+        `       For ${ide}: install the agents (skilldrop install --agent ${p.agents.join(" ")} --ide ${ide}) ` +
+        `and the skill (skilldrop install ${p.skill} --ide ${ide}) separately.`);
+  const flags = Object.assign({}, args.flags);
+  delete flags.panel;
+  console.log(`Installing the '${name}' panel — ${p.agents.length} reviewer subagents + the ${p.skill} orchestrator skill.\n`);
+  installAgents({ _: p.agents.slice(), flags: Object.assign({}, flags, { agent: true }) });
+  console.log("");
+  install({ _: [p.skill], flags });
+  console.log(`\nPanel installed. Fire it with the ${p.skill} skill — e.g. "run a pre-merge review on this change".`);
+  console.log(`It dispatches the three subagents in parallel where your tool has native subagents (Claude Code today;`);
+  console.log(`Codex / Antigravity multi-agent runners), and sweeps the lenses inline otherwise. Per-tool: agents/README.md.`);
+}
+
 function install(args) {
+  if (args.flags.panel) return installPanel(args);
   if (args.flags.agent) return installAgents(args);
   const cat = resolveCatalog(args.flags.from);
   let names = expandNames(args, cat);

package/model-routing.json

@@ -21,8 +21,8 @@
       "label": "Claude Code (Anthropic)",
       "models": {
         "light": "claude-haiku-4-5-20251001",
-        "standard": "claude-sonnet-4-6",
-        "heavy": "claude-opus-4-8"
+        "standard": "claude-sonnet-5",
+        "heavy": "claude-opus-5"
       },
       "select_via": "`/model <model-id>` in the session, or hand the skill to the model-router agent for automatic dispatch.",
       "automation": ".claude/agents/model-router.md"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skilldrop-cli",
-  "version": "0.8.4",
+  "version": "0.9.0",
   "description": "Portable AI-agent skills for the deliverables knowledge workers ship \u2014 diagrams, ADRs, PRDs, runbooks, decks, reviews \u2014 installable into Claude Code, Cursor, Kiro, and any IDE that takes custom instructions. One command per skill or per role-based pack.",
   "author": {
     "name": "Sanjay Ananthanarayan",