@amsterdamdatalabs/enact-extensions 0.1.0

package/plugins/net-revenue-management/skills/net-revenue-risks/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: net-revenue-risks
+description: Surface retailer terms risks, Asda delisting exposure, and Asda non-compliance impact for a CPG pricing event. Grounded in Meridian Confections UK Premium Snacks January 2026 data.
+---
+
+## Net Revenue Risk Assessment
+
+Use this skill to identify and quantify risks associated with a pricing event before committing to a recommendation.
+
+### Workflow
+
+1. **Check retailer terms** — call `check_retailer_terms` (optionally filtered by `accounts`) to surface SKUs where the new RSP breaches the Asda 15p own-label price-gap policy. Galaxy Sharing 150g and 200g are flagged at Asda; combined exposure ~£643K.
+
+2. **Model Asda non-compliance** — call `model_asda_non_compliance` with `hold_weeks` (1–13) to quantify Q1 net revenue lost if Asda delays compliance. At a full 13-week hold the loss ≈ −£210K vs full compliance.
+
+3. **Get all identified risks** — call `get_risks` to return the complete risk register: Asda delisting (~£643K), Tesco MFC clause, and the Jan W1 timing upside (+£340K opportunity).
+
+### Key thresholds
+
+- **Asda price-gap policy**: 15p branded-above-own-label threshold. A +5% RSP increase on Galaxy Sharing bags breaches this, triggering a delisting review.
+- **Asda hold breakeven**: Every additional week of hold costs ~£16K net revenue on the sharing segment.
+- **Split mitigation**: Applying only +3% to sharing SKUs keeps Galaxy Sharing 150g/200g below the 15p gap threshold, protecting the Asda account while still delivering ~+£1.92M net revenue impact range-wide.
+
+### Example prompts
+
+- "What is the total Asda delisting risk for the +5% price event?"
+- "Model 8 weeks of Asda non-compliance on sharing SKUs."
+- "Show all risks for the January 2026 price event, ordered by severity."
+
+> **Draft note**: skill body is a starter draft for review. Validate risk thresholds and non-compliance formula against future data refreshes.

package/plugins/net-revenue-management/skills/net-revenue-scenario/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: net-revenue-scenario
+description: Model pricing scenarios for a CPG price event using Revenue Growth Management tools. Covers full-range and split price increases, P&L waterfall cascades, and volume response across SKU segments.
+---
+
+## Net Revenue Scenario Modelling
+
+Use this skill to model the financial impact of a pricing event on the Meridian Confections UK Premium Snacks range (January 2026, 14 SKUs).
+
+### Workflow
+
+1. **Load the elasticity model** — call `load_elasticity_model` first. This grounds all subsequent tools in the actual SKU economics (own-price elasticity coefficients, RSP, net price, gross margin %).
+
+2. **Model volume response** — call `calculate_volume_response` with the target `price_delta_pct` (e.g. `5.0` for Full 5%) and optionally filter by `segments` (`["premium","sharing","standard"]`).
+
+3. **Run the P&L cascade** — call `run_pl_cascade` with `scenario` set to one of:
+   - `"conservative"` — lower list-price step, more volume drag
+   - `"base"` — the reference scenario (net revenue impact +£2.1M)
+   - `"optimistic"` — tighter volume response, fuller recovery
+
+4. **Model a split increase** — if Asda delisting risk is a concern, call `model_split_scenario` with a lower `sharing_pct` (e.g. `3.0`) to keep Galaxy Sharing bags below the 15p Asda price-gap policy threshold while applying the full increase to premium and standard SKUs.
+
+5. **Compare all options** — call `get_scenario_comparison` to return the four strategic options (Full 5%, Split recommended, Phased Q1/Q2, No change) with net revenue, GM%, EBITDA, and risk level.
+
+### Example prompts
+
+- "Model a +5%/+3% split scenario: premium at 5%, sharing at 3%."
+- "What is the net revenue impact of the optimistic base scenario?"
+- "Compare all four pricing options for the January 2026 price event."
+
+> **Draft note**: skill body is a starter draft for review. Refine tool call sequences and example prompts based on actual agent testing.

package/scripts/enact-extensions.mjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import { resolvePluginRoot } from "./lib/resolve-plugin-root.mjs";
+import { runValidate } from "./lib/run-validate.mjs";
+import { runSync } from "./lib/run-sync.mjs";
+import { runInstall } from "./lib/run-install.mjs";
+
+const HELP = `enact-extensions — Enact multi-platform plugin manifests
+
+Usage:
+  enact-extensions validate [path]   Validate manifests (default: cwd)
+  enact-extensions sync [path]       Sync host manifests from .agents/plugin.json (default: cwd)
+  enact-extensions sync [path] --name <id>   Create .agents/plugin.json then sync (new plugin)
+  enact-extensions install [path]    Sync and install plugin into Codex-compatible homes (default: cwd)
+  enact-extensions install [path] --platform claude    Install to Claude Code
+  enact-extensions install [path] --platform cursor   Install to Cursor
+  enact-extensions install [path] --platform enact    Install to Enact (Codex fork)
+  enact-extensions install [path] --platform codex    Install to Codex (explicit)
+
+Options:
+  path    Plugin root (skills/, .agents/, etc.). Defaults to process.cwd().
+  --platform <name>        Target platform: codex (default), claude, cursor, enact
+  --codex-home <path>      Install only into the given Codex-compatible home
+  --enact-home <path>      Target a specific local Enact home (default: ~/.enact)
+  --claude-home <path>     Target a specific local Claude home (default: ~/.claude)
+  --cursor-home <path>     Target a specific local Cursor home (default: ~/.cursor)
+  --marketplace <name>     Marketplace name (default: enact-os-plugins)
+  --no-enable              Install files without enabling the Codex/Enact plugin
+  --skip-sync              Install current manifests without regenerating them
+
+Examples:
+  cd ../enact-operator/extensions && enact-extensions validate
+  enact-extensions sync . --name my-plugin
+  enact-extensions install ../enact-operator/extensions
+  enact-extensions install ../enact-operator/extensions --platform claude
+  enact-extensions install ../enact-operator/extensions --platform cursor
+  enact-extensions install ../enact-operator/extensions --platform enact
+  enact-extensions validate ../enact-operator/extensions
+`;
+
+function parseArgs(argv) {
+  const positional = [];
+  const options = {};
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--name" && argv[i + 1]) {
+      options.name = argv[++i];
+    } else if (arg === "--codex-home" && argv[i + 1]) {
+      options.codexHome = argv[++i];
+    } else if (arg === "--marketplace" && argv[i + 1]) {
+      options.marketplaceName = argv[++i];
+    } else if (arg === "--no-enable") {
+      options.enable = false;
+    } else if (arg === "--skip-sync") {
+      options.sync = false;
+    } else if (arg === "--platform" && argv[i + 1]) {
+      options.platform = argv[++i];
+    } else if (arg === "--claude-home" && argv[i + 1]) {
+      options.claudeHome = argv[++i];
+    } else if (arg === "--cursor-home" && argv[i + 1]) {
+      options.cursorHome = argv[++i];
+    } else if (arg === "--enact-home" && argv[i + 1]) {
+      options.enactHome = argv[++i];
+    } else if (arg === "-h" || arg === "--help") {
+      positional.push("help");
+    } else if (!arg.startsWith("-")) {
+      positional.push(arg);
+    }
+  }
+
+  return { command: positional[0], path: positional[1], options };
+}
+
+const { command, path, options } = parseArgs(process.argv.slice(2));
+
+if (!command || command === "help") {
+  console.log(HELP);
+  process.exit(command ? 0 : 1);
+}
+
+const pluginRoot = resolvePluginRoot(path);
+
+try {
+  if (command === "validate") {
+    const ok = runValidate(pluginRoot);
+    process.exit(ok ? 0 : 1);
+  }
+
+  if (command === "sync") {
+    runSync(pluginRoot, { name: options.name });
+    process.exit(0);
+  }
+
+  if (command === "install") {
+    runInstall(pluginRoot, options);
+    process.exit(0);
+  }
+
+  console.error(`Unknown command: ${command}\n`);
+  console.log(HELP);
+  process.exit(1);
+} catch (err) {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+}

package/scripts/install.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# ── Node.js version check ──────────────────────────────────────────────────────
+NODE_MAJOR="$(node --version 2>/dev/null | sed 's/v//' | cut -d. -f1)"
+if [ -z "$NODE_MAJOR" ] || [ "$NODE_MAJOR" -lt 22 ]; then
+  echo "error: Node.js >= 22 is required (found: $(node --version 2>/dev/null || echo 'none'))" >&2
+  exit 1
+fi
+
+cd "$REPO_ROOT"
+
+# ── Install dependencies ───────────────────────────────────────────────────────
+echo "→ npm install"
+npm install --no-audit --no-fund
+
+# ── Build TypeScript ───────────────────────────────────────────────────────────
+echo "→ npm run build"
+npm run build
+
+# ── Bundle into a single file ─────────────────────────────────────────────────
+echo "→ bundling"
+# Bundle the CLI and all JS/TS dependencies into one ESM file.
+# The bundle is installed into <support>/dist/internal/ so that import.meta.url
+# resolves ../../ to <support>/ — matching the dist/internal/schema.js assumption
+# about where spec/ lives relative to the compiled output.
+SUPPORT_DIR="$HOME/.local/share/enact-extensions"
+BUNDLE_DIR="$SUPPORT_DIR/dist/internal"
+mkdir -p "$BUNDLE_DIR"
+
+npx --yes esbuild scripts/enact-extensions.mjs \
+  --bundle \
+  --platform=node \
+  --format=cjs \
+  "--banner:js=const __import_meta_url=require('url').pathToFileURL(__filename).href;" \
+  "--define:import.meta.url=__import_meta_url" \
+  --outfile="$BUNDLE_DIR/enact-extensions.js"
+
+chmod +x "$BUNDLE_DIR/enact-extensions.js"
+
+# ── Copy spec/ alongside the bundle ───────────────────────────────────────────
+# schema.ts resolves spec/ as ../../spec/ relative to dist/internal/ — keep that layout.
+rm -rf "$SUPPORT_DIR/spec"
+cp -r "$REPO_ROOT/spec" "$SUPPORT_DIR/spec"
+
+# ── Install launcher ───────────────────────────────────────────────────────────
+if [ "$(id -u)" = "0" ]; then
+  INSTALL_DIR="/usr/local/bin"
+else
+  INSTALL_DIR="$HOME/.local/bin"
+  mkdir -p "$INSTALL_DIR"
+fi
+
+LAUNCHER="$INSTALL_DIR/enact-extensions"
+{
+  echo '#!/usr/bin/env bash'
+  echo "exec node \"$BUNDLE_DIR/enact-extensions.js\" \"\$@\""
+} > "$LAUNCHER"
+chmod +x "$LAUNCHER"
+
+echo ""
+echo "installed: $LAUNCHER"
+
+if [ "$(id -u)" != "0" ] && [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
+  echo ""
+  echo "  Add to your shell profile to use the command:"
+  echo "    export PATH=\"\$HOME/.local/bin:\$PATH\""
+fi

package/scripts/lib/resolve-plugin-root.mjs

@@ -0,0 +1,9 @@
+import { resolve } from "node:path";
+import { cwd } from "node:process";
+
+/**
+ * Resolve plugin root: explicit path arg or current working directory.
+ */
+export function resolvePluginRoot(pathArg) {
+  return resolve(pathArg ?? cwd());
+}

package/scripts/lib/run-install.mjs

@@ -0,0 +1,66 @@
+import {
+  installPluginBundle,
+  installClaudePluginBundle,
+  installCursorPluginBundle,
+  installCodexPluginBundle,
+  defaultEnactHome,
+} from "../../dist/index.js";
+
+export function runInstall(pluginRoot, options = {}) {
+  const platform = options.platform ?? "codex";
+
+  if (platform === "claude") {
+    const result = installClaudePluginBundle({
+      pluginRoot,
+      claudeHome: options.claudeHome,
+      marketplaceName: options.marketplaceName,
+      sync: options.sync,
+    });
+    console.log(`installed ${result.name} -> ${result.installedPluginPath}`);
+    console.log(`registered marketplace ${result.marketplaceName} -> ${result.marketplaceDir}`);
+    for (const path of result.refreshedPaths) {
+      console.log(`refreshed ${path}`);
+    }
+    return result;
+  }
+
+  if (platform === "cursor") {
+    const result = installCursorPluginBundle({
+      pluginRoot,
+      cursorHome: options.cursorHome,
+      sync: options.sync,
+    });
+    console.log(`installed ${result.name} -> ${result.installedPluginPath}`);
+    for (const path of result.refreshedPaths) {
+      console.log(`refreshed ${path}`);
+    }
+    return result;
+  }
+
+  if (platform === "enact") {
+    const result = installCodexPluginBundle({
+      pluginRoot,
+      codexHome: options.enactHome ?? defaultEnactHome(),
+      marketplaceName: options.marketplaceName,
+      enable: options.enable,
+      sync: options.sync,
+    });
+    console.log(`installed ${result.pluginConfigKey} -> ${result.configPath}`);
+    console.log(`wrote ${result.marketplacePath}`);
+    for (const path of result.refreshedPaths) {
+      console.log(`refreshed ${path}`);
+    }
+    return result;
+  }
+
+  // codex (default) or explicit --platform codex
+  const result = installPluginBundle({ pluginRoot, cwd: options.cwd ?? pluginRoot, ...options });
+  for (const install of result.results) {
+    console.log(`installed ${install.pluginConfigKey} -> ${install.configPath}`);
+    console.log(`wrote ${install.marketplacePath}`);
+    for (const path of install.refreshedPaths) {
+      console.log(`refreshed ${path}`);
+    }
+  }
+  return result;
+}

package/scripts/lib/run-sync.mjs

@@ -0,0 +1,24 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { syncPlatformManifests, createEnactManifest } from "../../dist/index.js";
+
+export function runSync(pluginRoot, { name } = {}) {
+  const enactPath = join(pluginRoot, ".agents/plugin.json");
+  let enact;
+
+  if (existsSync(enactPath)) {
+    enact = JSON.parse(readFileSync(enactPath, "utf8"));
+  } else if (!name) {
+    throw new Error(
+      `No .agents/plugin.json in ${pluginRoot}. Pass --name <kebab-name> to create one.`,
+    );
+  } else {
+    enact = createEnactManifest({ name });
+  }
+
+  const results = syncPlatformManifests(pluginRoot, enact);
+  for (const r of results) {
+    console.log(`${r.written ? "wrote" : "skip"} ${r.manifestPath}`);
+  }
+  return results;
+}

package/scripts/lib/run-validate.mjs

@@ -0,0 +1,36 @@
+import {
+  validatePluginBundle,
+  checkComponentPaths,
+  checkPluginBundleComponentPaths,
+  readManifestFile,
+} from "../../dist/index.js";
+
+export function runValidate(pluginRoot, platforms) {
+  const report = validatePluginBundle(pluginRoot, platforms);
+  let warnings = [];
+
+  try {
+    const enact = readManifestFile(pluginRoot, "enact");
+    warnings = checkComponentPaths(pluginRoot, enact);
+  } catch {
+    // enact manifest optional for partial bundles
+  }
+
+  for (const result of report.results) {
+    const status = result.ok ? "ok" : "FAIL";
+    console.log(`[${status}] ${result.platform} (${pluginRoot})`);
+    for (const err of result.errors) {
+      console.log(`  - ${err}`);
+    }
+  }
+
+  for (const warn of warnings) {
+    console.log(`[warn] ${warn}`);
+  }
+  const componentIssues = checkPluginBundleComponentPaths(pluginRoot, platforms);
+  for (const issue of componentIssues) {
+    console.log(`[FAIL] ${issue}`);
+  }
+
+  return report.ok && componentIssues.length === 0;
+}

package/scripts/rename-supervisor-to-operator.pl

@@ -0,0 +1,66 @@
+#!/usr/bin/env perl
+use strict;
+use warnings;
+
+my @files = @ARGV;
+for my $file (@files) {
+  open my $fh, '<', $file or die "Cannot read $file: $!";
+  my $content = do { local $/; <$fh> };
+  close $fh;
+
+  my $orig = $content;
+
+  $content =~ s|\.\./enact-operator|../enact-operator|g;
+  $content =~ s|enact-operator|enact-operator|g;
+  $content =~ s|\@enact/operator|\@enact/operator|g;
+  $content =~ s|validate:operator|validate:operator|g;
+  $content =~ s|sync:operator|sync:operator|g;
+  $content =~ s|\$enact-operator:|\$enact-operator:|g;
+  $content =~ s|enact-operator-tasks-|enact-operator-tasks-|g;
+  $content =~ s|enact-operator-factory-|enact-operator-factory-|g;
+  $content =~ s|enact-operator-setup-|enact-operator-setup-|g;
+  $content =~ s|enact-operator-doctor-|enact-operator-doctor-|g;
+  $content =~ s|enact-operator-parent-|enact-operator-parent-|g;
+  $content =~ s|enact-operator-hook-cont-|enact-operator-hook-cont-|g;
+  $content =~ s|enact-operator-followup-|enact-operator-followup-|g;
+  $content =~ s|enact-operator-provider-boundary-|enact-operator-provider-boundary-|g;
+  $content =~ s|enact-operator-skill-act-|enact-operator-skill-act-|g;
+  $content =~ s|enact-operator-authority-|enact-operator-authority-|g;
+  $content =~ s|enact-operator-reconcile-integration-|enact-operator-reconcile-integration-|g;
+  $content =~ s|enact-operator-subagent-runtime-|enact-operator-subagent-runtime-|g;
+  $content =~ s|basename\(root\) === 'enact-operator'|basename(root) === 'enact-operator'|g;
+  $content =~ s|basename\(root\) !== 'enact-operator'|basename(root) !== 'enact-operator'|g;
+  $content =~ s|/some/enact-operator|/some/enact-operator|g;
+  $content =~ s|join\(base, 'enact-operator'\)|join(base, 'enact-operator')|g;
+  $content =~ s|the enact-operator repo|the enact-operator repo|g;
+  $content =~ s|is enact-operator|is enact-operator|g;
+  $content =~ s|actor: 'enact-operator'|actor: 'enact-operator'|g;
+  $content =~ s|'enact-operator',|'enact-operator',|g;
+  $content =~ s|"enact-operator"|"enact-operator"|g;
+  $content =~ s|enact-operator doctor|enact-operator doctor|g;
+  $content =~ s|enact-operator hud|enact-operator hud|g;
+  $content =~ s|enact-operator session|enact-operator session|g;
+  $content =~ s|enact-operator CLI|enact-operator CLI|g;
+  $content =~ s|enact-operator setup|enact-operator setup|g;
+  $content =~ s|enact-operator build|enact-operator build|g;
+  $content =~ s|enact-operator dir|enact-operator dir|g;
+  $content =~ s|enact-operator not found|enact-operator not found|g;
+  $content =~ s|enact-operator repo|enact-operator repo|g;
+  $content =~ s|enact-operator even|enact-operator even|g;
+  $content =~ s|/Users/tarunrana/Documents/enact-os/enact-operator/|/Users/tarunrana/Documents/enact-os/enact-operator/|g;
+  $content =~ s|enact-operator |enact-operator |g;
+  $content =~ s|enact-operator`|enact-operator`|g;
+  $content =~ s|enact-operator/|enact-operator/|g;
+  $content =~ s|enact-operator@|enact-operator@|g;
+  $content =~ s|enact-operator-|enact-operator-|g;
+  $content =~ s|_git/enact-operator|_git/enact-operator|g;
+  $content =~ s|enact-operator MCP|enact-operator MCP|g;
+  $content =~ s|the enact-operator plugin|the enact-operator plugin|g;
+  $content =~ s|enact-operator plugin|enact-operator plugin|g;
+
+  next if $content eq $orig;
+
+  open my $out, '>', $file or die "Cannot write $file: $!";
+  print {$out} $content;
+  close $out;
+}

package/scripts/setup-enact-context.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+# Wire enact-context setup into the enact-extensions workspace.
+# Validates the plugin bundle (catalog) then runs consolidated agent setup.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+REPO_ROOT="$(cd "$ROOT/.." && pwd)"
+
+if ! command -v enact-context >/dev/null 2>&1; then
+  if [[ -x "$REPO_ROOT/enact-context/rust/target/release/enact-context" ]]; then
+    export PATH="$REPO_ROOT/enact-context/rust/target/release:$PATH"
+  else
+    echo "enact-context binary not found on PATH" >&2
+    exit 1
+  fi
+fi
+
+cd "$ROOT"
+npm run validate:catalog
+
+echo ""
+echo "Running enact-context setup (claude, codex, opencode, enact, zed)..."
+enact-context setup "$@"

package/scripts/sync-manifests.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * @deprecated Prefer: enact-extensions sync [path]
+ * Defaults to cwd when path is omitted.
+ */
+import { resolvePluginRoot } from "./lib/resolve-plugin-root.mjs";
+import { runSync } from "./lib/run-sync.mjs";
+
+function parseName(argv) {
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === "--name" && argv[i + 1]) {
+      return argv[i + 1];
+    }
+  }
+  const positional = argv.filter((a) => !a.startsWith("-"));
+  return positional[1];
+}
+
+const rest = process.argv.slice(2);
+const pathArg = rest[0]?.startsWith("-") ? undefined : rest[0];
+const name = parseName(rest);
+
+runSync(resolvePluginRoot(pathArg), { name });

package/scripts/validate-catalog.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFileSync } from 'node:child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const workspaceRoot = resolve(__dirname, '..');
+const catalogDir = join(workspaceRoot, 'catalog');
+const repoRoot = resolve(workspaceRoot, '..');
+
+const entries = readdirSync(catalogDir)
+  .filter((f) => f.endsWith('.json'))
+  .map((f) => JSON.parse(readFileSync(join(catalogDir, f), 'utf8')));
+
+let allPassed = true;
+
+for (const entry of entries) {
+  const bundleAbsPath = resolve(repoRoot, entry.repo, entry.bundlePath);
+  if (!existsSync(bundleAbsPath)) {
+    console.error(`[catalog] FAIL ${entry.id}: bundle path not found: ${bundleAbsPath}`);
+    allPassed = false;
+    continue;
+  }
+  try {
+    execFileSync('enact-extensions', ['validate', bundleAbsPath], { stdio: 'inherit' });
+    console.log(`[catalog] OK   ${entry.id}: ${bundleAbsPath}`);
+  } catch {
+    console.error(`[catalog] FAIL ${entry.id}: enact-extensions validate failed`);
+    allPassed = false;
+  }
+}
+
+if (!allPassed) {
+  process.exit(1);
+}
+console.log(`\n[catalog] All ${entries.length} bundle(s) passed validation.`);

package/scripts/validate-plugin.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * @deprecated Prefer: enact-extensions validate [path]
+ * Defaults to cwd when path is omitted.
+ */
+import { resolvePluginRoot } from "./lib/resolve-plugin-root.mjs";
+import { runValidate } from "./lib/run-validate.mjs";
+
+const ok = runValidate(resolvePluginRoot(process.argv[2]));
+process.exit(ok ? 0 : 1);

package/spec/claude.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "claude-plugin.json",
+  "title": "Claude Code Plugin Manifest",
+  "description": "Validates .claude-plugin/plugin.json for Claude Code plugins. Components (skills/, agents/, hooks/, .mcp.json, etc.) are auto-discovered from default directories; path overrides are optional.",
+  "type": "object",
+  "required": ["name"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Unique plugin identifier and skill namespace prefix (skills become /name:skill-name).",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version. If omitted, the git commit SHA is used for version tracking.",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string",
+      "description": "Shown in the plugin manager when browsing or installing plugins."
+    },
+    "author": {
+      "type": "object",
+      "required": ["name"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "email": { "type": "string", "format": "email" },
+        "url": { "type": "string", "format": "uri" }
+      }
+    },
+    "homepage": {
+      "type": "string",
+      "format": "uri",
+      "description": "Plugin or developer homepage URL."
+    },
+    "repository": {
+      "type": "string",
+      "description": "URL to the source repository."
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier."
+    },
+    "keywords": {
+      "type": "array",
+      "items": { "type": "string" },
+      "uniqueItems": true,
+      "description": "Discovery tags shown in the plugin manager."
+    },
+    "skills": {
+      "type": "string",
+      "description": "Custom path to skills directory (default: ./skills/).",
+      "default": "./skills/"
+    },
+    "commands": {
+      "type": "string",
+      "description": "Custom path to commands directory (flat Markdown files; prefer skills/ for new plugins).",
+      "default": "./commands/"
+    },
+    "agents": {
+      "type": "string",
+      "description": "Custom path to agents directory.",
+      "default": "./agents/"
+    },
+    "hooks": {
+      "type": "string",
+      "description": "Custom path to hooks configuration file.",
+      "default": "./hooks/hooks.json"
+    },
+    "mcpServers": {
+      "type": "string",
+      "description": "Custom path to .mcp.json MCP server configuration.",
+      "default": "./.mcp.json"
+    },
+    "lsp": {
+      "type": "string",
+      "description": "Custom path to .lsp.json LSP server configuration.",
+      "default": "./.lsp.json"
+    },
+    "monitors": {
+      "type": "string",
+      "description": "Custom path to monitors configuration file.",
+      "default": "./monitors/monitors.json"
+    },
+    "settings": {
+      "type": "string",
+      "description": "Custom path to default settings file applied when the plugin is enabled.",
+      "default": "./settings.json"
+    },
+    "bin": {
+      "type": "string",
+      "description": "Custom path to executables directory added to Bash PATH while the plugin is active.",
+      "default": "./bin/"
+    }
+  }
+}