skillset 0.1.0-beta.9 → 0.13.1

package/dist/cli.js

@@ -7517,12 +7517,12 @@ var skillsetFeatureRegistry = defineFeatureRegistry([
         status: "externally_managed"
       },
       cursor: {
-        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos/superpowers")],
+        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos.yaml")],
         reason: "Cursor support needs target documentation and adapter evidence before Skillset can lower or distribute it.",
         status: "planned"
       },
       "gemini-cli": {
-        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos/superpowers")],
+        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos.yaml")],
         reason: "Gemini support needs target documentation and adapter evidence before Skillset can lower or distribute it.",
         status: "planned"
       },
@@ -7537,7 +7537,7 @@ var skillsetFeatureRegistry = defineFeatureRegistry([
         status: "future"
       },
       opencode: {
-        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos/superpowers")],
+        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos.yaml")],
         reason: "OpenCode support needs target documentation and adapter evidence before Skillset can lower or distribute it.",
         status: "planned"
       }
@@ -7624,7 +7624,7 @@ var skillsetFeatureRegistry = defineFeatureRegistry([
     status: "implemented",
     summary: "Normalizes tool policy intent into Claude allowed-tools fields and Codex metadata sidecars.",
     targetSupport: {
-      claude: { status: "native" },
+      claude: { status: "transformed" },
       codex: { status: "metadata_only" }
     },
     title: "Tool Intent",
@@ -7679,6 +7679,9 @@ function defineFeatureRegistry(entries) {
   assertRuntimeSupportVocabulary(entries);
   return [...entries].sort((left, right) => compareStrings(left.id, right.id));
 }
+function listSkillsetFeatures(registry = skillsetFeatureRegistry) {
+  return registry;
+}
 function getSkillsetFeature(id, registry = skillsetFeatureRegistry) {
   return registry.find((entry) => entry.id === id);
 }
@@ -14447,6 +14450,9 @@ async function exists6(path) {
     throw error;
   }
 }
+// packages/core/src/host-leak.ts
+var textDecoder3 = new TextDecoder;
+
 // packages/core/src/normalized-output-tree.ts
 var DEFAULT_STRUCTURED_JSON_BASENAMES = new Set([".skillset.lock"]);
 
@@ -14454,7 +14460,7 @@ var DEFAULT_STRUCTURED_JSON_BASENAMES = new Set([".skillset.lock"]);
 var textEncoder4 = new TextEncoder;
 // packages/core/src/destination-ownership.ts
 import { basename as basename3 } from "path";
-var textDecoder3 = new TextDecoder;
+var textDecoder4 = new TextDecoder;
 function classifyDestinationOwnership(args) {
   const file = classifyFileOwnership(args.path, args.target);
   const fields = args.content === undefined ? [] : classifyFieldOwnership(args.path, args.target, args.content);
@@ -14493,7 +14499,7 @@ function classifyFieldOwnership(path, target, content) {
     return [];
   let record;
   try {
-    const parsed = JSON.parse(textDecoder3.decode(content));
+    const parsed = JSON.parse(textDecoder4.decode(content));
     if (!isJsonRecord(parsed))
       return [];
     record = parsed;
@@ -17585,7 +17591,7 @@ var CI_WORKFLOW_PATH = ".github/workflows/skillset-ci.yml";
 function renderCiWorkflow() {
   return [
     "# Scaffolded by skillset init --include ci. Skillset does not manage this file; edit freely.",
-    "# Pin skillset to an exact version for reproducible CI runs.",
+    "# Consider pinning skillset to an exact version for reproducible CI runs.",
     "# Notes:",
     "# - Mechanical fixes pushed with GITHUB_TOKEN do not retrigger workflows; if your",
     "#   branch protection requires checks on the fixed commit, push with a PAT instead.",
@@ -17627,7 +17633,7 @@ function renderCiWorkflow() {
     "      - name: Run skillset ci",
     "        id: skillset",
     "        run: >-",
-    "          bunx skillset@beta ci",
+    "          bunx skillset ci",
     "          ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && '--fix' || '' }}",
     '          --report "$RUNNER_TEMP/skillset-ci-report.md"',
     "        continue-on-error: true",
@@ -19064,7 +19070,7 @@ async function exists12(path2) {
 
 // apps/skillset/src/authoring.ts
 import { resolve as resolve8, relative as relative15 } from "path";
-var textDecoder4 = new TextDecoder;
+var textDecoder5 = new TextDecoder;
 async function explainPath(rootPath, inputPath, options = {}) {
   const graph = await loadBuildGraph(rootPath, options);
   const allRendered = await renderBuildGraph(graph);
@@ -19077,33 +19083,39 @@ async function explainPath(rootPath, inputPath, options = {}) {
   const items = collectLockItems(rendered);
   const asSource = items.filter((item) => item.sourcePath === target);
   if (asSource.length > 0) {
+    const matchedLoweringOutcomes = explainLoweringOutcomes(target, asSource, loweringOutcomes);
     return {
       path: target,
       kind: explainSourceKind(graph, target),
       entries: asSource.map((item) => item.entry),
-      loweringOutcomes: explainLoweringOutcomes(target, asSource, loweringOutcomes),
+      features: featureCapabilitiesForPath(graph, target, asSource, matchedLoweringOutcomes),
+      loweringOutcomes: matchedLoweringOutcomes,
       notes: sourceNotes(graph, target)
     };
   }
   const asGenerated = items.filter((item) => item.outputPath === target || item.files.some((file) => joinOutputRoot2(item.outputRoot, file) === target));
   if (asGenerated.length > 0) {
+    const matchedLoweringOutcomes = explainLoweringOutcomes(target, asGenerated, loweringOutcomes, {
+      includeSourcePaths: false
+    });
     return {
       path: target,
       kind: "generated",
       entries: asGenerated.map((item) => item.entry),
-      loweringOutcomes: explainLoweringOutcomes(target, asGenerated, loweringOutcomes, {
-        includeSourcePaths: false
-      }),
+      features: featureCapabilitiesForPath(graph, target, asGenerated, matchedLoweringOutcomes),
+      loweringOutcomes: matchedLoweringOutcomes,
       notes: [`Generated output; rebuild with skillset build, verify with skillset check.`]
     };
   }
   const prefixMatch = items.filter((item) => item.sourcePath.startsWith(`${target}/`));
   if (prefixMatch.length > 0) {
+    const matchedLoweringOutcomes = explainLoweringOutcomes(target, prefixMatch, loweringOutcomes);
     return {
       path: target,
       kind: "source-plugin",
       entries: prefixMatch.map((item) => item.entry),
-      loweringOutcomes: explainLoweringOutcomes(target, prefixMatch, loweringOutcomes),
+      features: featureCapabilitiesForPath(graph, target, prefixMatch, matchedLoweringOutcomes),
+      loweringOutcomes: matchedLoweringOutcomes,
       notes: [`Matched ${prefixMatch.length} generated entries under this source path.`]
     };
   }
@@ -19113,6 +19125,7 @@ async function explainPath(rootPath, inputPath, options = {}) {
       path: target,
       kind: explainSourceKind(graph, target),
       entries: [],
+      features: featureCapabilitiesForPath(graph, target, [], sourceOnlyOutcomes),
       loweringOutcomes: sourceOnlyOutcomes,
       notes: [`Matched ${sourceOnlyOutcomes.length} lowering outcome(s) under this source path.`]
     };
@@ -19121,6 +19134,7 @@ async function explainPath(rootPath, inputPath, options = {}) {
     path: target,
     kind: "unknown",
     entries: [],
+    features: [],
     loweringOutcomes: [],
     notes: [
       `No lock entry references ${target}. Pass a source path under ${graph.sourceDir}/ or a generated output path.`
@@ -19132,6 +19146,21 @@ async function listGeneratedEntries(rootPath, options = {}) {
   const rendered = scopedRenderedFiles(graph, await renderBuildGraph(graph), options.scopes);
   return collectLockItems(rendered).map((item) => item.entry);
 }
+function listFeatureCapabilities(featureId) {
+  const features = featureId === undefined ? listSkillsetFeatures() : [getSkillsetFeature(featureId)].filter((feature2) => feature2 !== undefined);
+  return features.map(featureCapability);
+}
+function summarizeFeatureCapabilities(features = listFeatureCapabilities()) {
+  return {
+    byFeatureStatus: countBy(features.map((feature2) => feature2.status)),
+    byTargetSupport: {
+      claude: countBy(features.map((feature2) => feature2.targetSupport.claude.status)),
+      codex: countBy(features.map((feature2) => feature2.targetSupport.codex.status))
+    },
+    featureIds: features.map((feature2) => feature2.id).sort(compareStrings),
+    total: features.length
+  };
+}
 async function doctorSkillset(rootPath, options = {}) {
   let graph;
   try {
@@ -19143,6 +19172,7 @@ async function doctorSkillset(rootPath, options = {}) {
       buildError: errorMessage3(error),
       buildDiagnostics: buildDiagnostics2,
       drift: { added: [], changed: [], missing: [], removed: [] },
+      featureCapabilities: summarizeFeatureCapabilities(),
       lintIssues: [],
       loweringOutcomes: loweringOutcomes2,
       notableLoweringOutcomes: notableLoweringOutcomes(loweringOutcomes2),
@@ -19170,6 +19200,7 @@ async function doctorSkillset(rootPath, options = {}) {
     ...buildError === undefined ? {} : { buildError },
     buildDiagnostics,
     drift,
+    featureCapabilities: summarizeFeatureCapabilities(),
     lintIssues: lint.issues,
     loweringOutcomes,
     notableLoweringOutcomes: notable,
@@ -19230,7 +19261,7 @@ function collectLockItems(rendered) {
       continue;
     let parsed;
     try {
-      parsed = JSON.parse(textDecoder4.decode(file.content));
+      parsed = JSON.parse(textDecoder5.decode(file.content));
     } catch {
       continue;
     }
@@ -19331,6 +19362,82 @@ function sourceNotes(graph, target) {
   }
   return notes;
 }
+function featureCapabilitiesForPath(graph, target, items, outcomes) {
+  const featureIds = new Set;
+  for (const item of items) {
+    if (item.entry.feature !== undefined)
+      featureIds.add(item.entry.feature);
+  }
+  for (const outcome of outcomes) {
+    featureIds.add(outcome.featureId);
+  }
+  for (const featureId of inferredFeatureIdsForSourcePath(graph, target)) {
+    featureIds.add(featureId);
+  }
+  return [...featureIds].map((featureId) => getSkillsetFeature(featureId)).filter((feature2) => feature2 !== undefined).map(featureCapability).sort((left, right) => compareStrings(left.id, right.id));
+}
+function inferredFeatureIdsForSourcePath(graph, target) {
+  const featureIds = [];
+  if (graph.rules.some((rule) => relative15(graph.rootPath, rule.sourcePath) === target)) {
+    featureIds.push("project-instructions");
+  }
+  if (graph.projectAgents.some((agent) => relative15(graph.rootPath, agent.sourcePath) === target)) {
+    featureIds.push("project-agents");
+  }
+  if (graph.projectIslands.some((island) => pathMatchesSource(graph, target, island.sourcePath))) {
+    featureIds.push("target-native-islands");
+  }
+  for (const skill of graph.standaloneSkills) {
+    if (!pathMatchesSource(graph, target, skill.sourcePath))
+      continue;
+    featureIds.push("standalone-skills");
+    if (skill.resources.length > 0)
+      featureIds.push("resources");
+  }
+  for (const plugin of graph.plugins) {
+    if (pathMatchesSource(graph, target, plugin.configPath)) {
+      featureIds.push("plugin-manifests");
+    }
+    for (const skill of plugin.skills) {
+      if (!pathMatchesSource(graph, target, skill.sourcePath))
+        continue;
+      featureIds.push("plugin-skills");
+      if (skill.resources.length > 0)
+        featureIds.push("resources");
+    }
+  }
+  return featureIds;
+}
+function pathMatchesSource(graph, target, sourcePath) {
+  const relativePath2 = relative15(graph.rootPath, sourcePath).replaceAll("\\", "/");
+  return target === relativePath2 || target.startsWith(`${relativePath2}/`);
+}
+function featureCapability(feature2) {
+  return {
+    docs: feature2.docs,
+    id: feature2.id,
+    status: feature2.status,
+    targetSupport: {
+      claude: supportCapability(feature2.targetSupport.claude),
+      codex: supportCapability(feature2.targetSupport.codex)
+    },
+    title: feature2.title
+  };
+}
+function supportCapability(support) {
+  return {
+    ...support.note === undefined ? {} : { note: support.note },
+    ...support.reason === undefined ? {} : { reason: support.reason },
+    status: support.status
+  };
+}
+function countBy(values) {
+  const counts = {};
+  for (const value of [...values].sort(compareStrings)) {
+    counts[value] = (counts[value] ?? 0) + 1;
+  }
+  return counts;
+}
 function normalizeRepoPath(rootPath, inputPath) {
   const absolute = resolve8(rootPath, inputPath);
   return relative15(rootPath, absolute).replaceAll("\\", "/");
@@ -19372,14 +19479,14 @@ async function resolveSkillsetCommand(rootPath = process.cwd(), env = process.en
   if (await isLocalSkillsetCheckout(rootPath)) {
     return { argv: ["bun", "./apps/skillset/src/cli.ts"], kind: "argv" };
   }
-  if (await commandExists("skillset", rootPath))
+  if (await commandExists("skillset", rootPath, env))
     return { argv: ["skillset"], kind: "argv" };
-  if (await commandExists("bunx", rootPath))
-    return { argv: ["bunx", "skillset@beta"], kind: "argv" };
-  if (await commandExists("bun", rootPath))
-    return { argv: ["bun", "x", "skillset@beta"], kind: "argv" };
-  if (await commandExists("npx", rootPath))
-    return { argv: ["npx", "--yes", "skillset@beta"], kind: "argv" };
+  if (await commandExists("bunx", rootPath, env))
+    return { argv: ["bunx", "skillset"], kind: "argv" };
+  if (await commandExists("bun", rootPath, env))
+    return { argv: ["bun", "x", "skillset"], kind: "argv" };
+  if (await commandExists("npx", rootPath, env))
+    return { argv: ["npx", "--yes", "skillset"], kind: "argv" };
   throw new Error("skillset: could not find a Skillset CLI runner; install skillset or set SKILLSET_HOOK_COMMAND");
 }
 async function runSkillsetCommand(args, options) {
@@ -19410,8 +19517,11 @@ async function runShell(command, args, options) {
   });
   return proc.exited;
 }
-async function commandExists(command, cwd) {
-  const result = await capture(["sh", "-lc", `command -v ${shellQuote(command)} >/dev/null 2>&1`], { cwd });
+async function commandExists(command, cwd, env) {
+  const result = await capture(["/bin/sh", "-lc", `command -v ${shellQuote(command)} >/dev/null 2>&1`], {
+    cwd,
+    env
+  });
   return result.exitCode === 0;
 }
 async function isLocalSkillsetCheckout(rootPath) {
@@ -19430,7 +19540,7 @@ async function capture(argv, options) {
   const proc = Bun.spawn({
     cmd: [...argv],
     cwd: options.cwd,
-    env: gitSafeEnv(),
+    env: gitSafeEnv(options.env),
     stderr: "ignore",
     stdout: "ignore"
   });
@@ -20632,6 +20742,7 @@ var USAGE = [
   "       skillset release apply [--yes|--dry-run] [--root <path>] [--source <dir>] [--dist <dir>]",
   "       skillset restore <backup-id> [--yes|--dry-run] [--root <path>]",
   "       skillset distribute plan [name] [--root <path>] [--source <dir>] [--dist <dir>]",
+  "       skillset features [feature-id] [--json]",
   "       skillset test [name] [--root <path>] [--source <dir>]",
   "       skillset hooks print --runner <lefthook|husky|pre-commit|git> [--pre-commit] [--pre-push]",
   "       skillset hooks print --target <claude|codex> --agent-runtime",
@@ -20965,6 +21076,25 @@ async function runCli(rawArgs = process.argv.slice(2), invokedName = basename8(p
     console.log(`skillset: listed ${entries.length} generated entries`);
     return;
   }
+  if (command === "features") {
+    const features = listFeatureCapabilities(importPath);
+    if (jsonOutput) {
+      process.stdout.write(renderValidatedJson({ features }, "skillset features"));
+      if (importPath !== undefined && features.length === 0)
+        process.exitCode = 1;
+      return;
+    }
+    if (features.length === 0) {
+      console.log(`skillset: feature ${importPath ?? ""} not found`);
+      process.exitCode = 1;
+      return;
+    }
+    for (const feature2 of features) {
+      printFeatureCapability(feature2);
+    }
+    console.log(`skillset: listed ${features.length} feature${features.length === 1 ? "" : "s"}`);
+    return;
+  }
   if (command === "explain") {
     if (importPath === undefined) {
       throw new Error("skillset: expected a path to explain");
@@ -21007,6 +21137,11 @@ async function runCli(rawArgs = process.argv.slice(2), invokedName = basename8(p
       if (entry.outputHash !== undefined)
         console.log(`    output hash: ${entry.outputHash}`);
     }
+    for (const feature2 of result3.features) {
+      console.log(`  feature ${feature2.id}: ${feature2.title}`);
+      console.log(`    claude: ${feature2.targetSupport.claude.status}`);
+      console.log(`    codex: ${feature2.targetSupport.codex.status}`);
+    }
     for (const outcome of result3.loweringOutcomes) {
       printLoweringOutcome(outcome);
     }
@@ -21036,6 +21171,9 @@ async function runCli(rawArgs = process.argv.slice(2), invokedName = basename8(p
     if (driftCount > 0) {
       console.log(`  drift: ${added.length} added, ${changed.length} changed, ${missing.length} missing, ${removed.length} removed (run skillset build --yes)`);
     }
+    console.log(`  features: ${report.featureCapabilities.total} registry entries; status ${formatCountSummary(report.featureCapabilities.byFeatureStatus)}`);
+    console.log(`  feature support: claude ${formatCountSummary(report.featureCapabilities.byTargetSupport.claude)}`);
+    console.log(`  feature support: codex ${formatCountSummary(report.featureCapabilities.byTargetSupport.codex)}`);
     for (const outcome of report.notableLoweringOutcomes) {
       printLoweringOutcome(outcome);
     }
@@ -21395,6 +21533,22 @@ function printSkillsetTest(report) {
   if (report.activationPath !== undefined)
     console.log(`  activation: ${report.activationPath}`);
 }
+function printFeatureCapability(feature2) {
+  console.log(`feature ${feature2.id}: ${feature2.title}`);
+  console.log(`  status: ${feature2.status}`);
+  console.log(`  claude: ${formatFeatureSupport(feature2.targetSupport.claude)}`);
+  console.log(`  codex: ${formatFeatureSupport(feature2.targetSupport.codex)}`);
+  if (feature2.docs.length > 0)
+    console.log(`  docs: ${feature2.docs.join(", ")}`);
+}
+function formatFeatureSupport(support) {
+  const reason = support.reason === undefined ? "" : ` (${support.reason})`;
+  const note = support.note === undefined ? "" : ` note: ${support.note}`;
+  return `${support.status}${reason}${note}`;
+}
+function formatCountSummary(counts) {
+  return Object.entries(counts).sort(([left], [right]) => left.localeCompare(right)).map(([key, count]) => `${key} ${count}`).join(", ");
+}
 function printLoweringOutcome(outcome) {
   const target = outcome.target ?? "workspace";
   const policy = outcome.policy === undefined ? "" : ` policy: ${outcome.policy}`;
@@ -21409,8 +21563,8 @@ function printLoweringOutcome(outcome) {
 }
 function parseArgs(args) {
   const command = args[0];
-  if (command !== "adopt" && command !== "build" && command !== "change" && command !== "check" && command !== "ci" && command !== "create" && command !== "diff" && command !== "distribute" && command !== "doctor" && command !== "explain" && command !== "hooks" && command !== "import" && command !== "init" && command !== "lint" && command !== "list" && command !== "release" && command !== "restore" && command !== "test") {
-    throw new Error(`skillset: expected command adopt, build, change, check, ci, create, diff, distribute, doctor, explain, hooks, import, init, lint, list, release, restore, or test
+  if (command !== "adopt" && command !== "build" && command !== "change" && command !== "check" && command !== "ci" && command !== "create" && command !== "diff" && command !== "distribute" && command !== "doctor" && command !== "explain" && command !== "features" && command !== "hooks" && command !== "import" && command !== "init" && command !== "lint" && command !== "list" && command !== "release" && command !== "restore" && command !== "test") {
+    throw new Error(`skillset: expected command adopt, build, change, check, ci, create, diff, distribute, doctor, explain, features, hooks, import, init, lint, list, release, restore, or test
 ` + USAGE);
   }
   let changeSubcommand;
@@ -21534,6 +21688,13 @@ function parseArgs(args) {
     importPath = rawPath;
     index += 1;
   }
+  if (command === "features") {
+    const rawFeatureId = args[index];
+    if (rawFeatureId !== undefined && !rawFeatureId.startsWith("--")) {
+      importPath = rawFeatureId;
+      index += 1;
+    }
+  }
   if (command === "restore") {
     const rawBackupId = args[index];
     if (rawBackupId === undefined || rawBackupId.startsWith("--")) {
@@ -21989,9 +22150,9 @@ function validateAdoptFlags(command, adopt) {
 function validateJsonFlags(command, jsonOutput) {
   if (!jsonOutput)
     return;
-  if (command === "doctor" || command === "explain")
+  if (command === "doctor" || command === "explain" || command === "features")
     return;
-  throw new Error("skillset: --json is only supported with doctor or explain");
+  throw new Error("skillset: --json is only supported with doctor, explain, or features");
 }
 function isImportKind(value) {
   return value === "skill" || value === "skills" || value === "plugin" || value === "plugins";

package/dist/create.js

@@ -7517,12 +7517,12 @@ var skillsetFeatureRegistry = defineFeatureRegistry([
         status: "externally_managed"
       },
       cursor: {
-        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos/superpowers")],
+        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos.yaml")],
         reason: "Cursor support needs target documentation and adapter evidence before Skillset can lower or distribute it.",
         status: "planned"
       },
       "gemini-cli": {
-        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos/superpowers")],
+        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos.yaml")],
         reason: "Gemini support needs target documentation and adapter evidence before Skillset can lower or distribute it.",
         status: "planned"
       },
@@ -7537,7 +7537,7 @@ var skillsetFeatureRegistry = defineFeatureRegistry([
         status: "future"
       },
       opencode: {
-        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos/superpowers")],
+        evidence: [docs("docs/features/runtime-adapters.md"), fixture("fixtures/external/repos.yaml")],
         reason: "OpenCode support needs target documentation and adapter evidence before Skillset can lower or distribute it.",
         status: "planned"
       }
@@ -7624,7 +7624,7 @@ var skillsetFeatureRegistry = defineFeatureRegistry([
     status: "implemented",
     summary: "Normalizes tool policy intent into Claude allowed-tools fields and Codex metadata sidecars.",
     targetSupport: {
-      claude: { status: "native" },
+      claude: { status: "transformed" },
       codex: { status: "metadata_only" }
     },
     title: "Tool Intent",
@@ -7679,6 +7679,9 @@ function defineFeatureRegistry(entries) {
   assertRuntimeSupportVocabulary(entries);
   return [...entries].sort((left, right) => compareStrings(left.id, right.id));
 }
+function listSkillsetFeatures(registry = skillsetFeatureRegistry) {
+  return registry;
+}
 function getSkillsetFeature(id, registry = skillsetFeatureRegistry) {
   return registry.find((entry) => entry.id === id);
 }
@@ -14447,6 +14450,9 @@ async function exists6(path) {
     throw error;
   }
 }
+// packages/core/src/host-leak.ts
+var textDecoder3 = new TextDecoder;
+
 // packages/core/src/normalized-output-tree.ts
 var DEFAULT_STRUCTURED_JSON_BASENAMES = new Set([".skillset.lock"]);
 
@@ -14454,7 +14460,7 @@ var DEFAULT_STRUCTURED_JSON_BASENAMES = new Set([".skillset.lock"]);
 var textEncoder4 = new TextEncoder;
 // packages/core/src/destination-ownership.ts
 import { basename as basename3 } from "path";
-var textDecoder3 = new TextDecoder;
+var textDecoder4 = new TextDecoder;
 function classifyDestinationOwnership(args) {
   const file = classifyFileOwnership(args.path, args.target);
   const fields = args.content === undefined ? [] : classifyFieldOwnership(args.path, args.target, args.content);
@@ -14493,7 +14499,7 @@ function classifyFieldOwnership(path, target, content) {
     return [];
   let record;
   try {
-    const parsed = JSON.parse(textDecoder3.decode(content));
+    const parsed = JSON.parse(textDecoder4.decode(content));
     if (!isJsonRecord(parsed))
       return [];
     record = parsed;
@@ -17585,7 +17591,7 @@ var CI_WORKFLOW_PATH = ".github/workflows/skillset-ci.yml";
 function renderCiWorkflow() {
   return [
     "# Scaffolded by skillset init --include ci. Skillset does not manage this file; edit freely.",
-    "# Pin skillset to an exact version for reproducible CI runs.",
+    "# Consider pinning skillset to an exact version for reproducible CI runs.",
     "# Notes:",
     "# - Mechanical fixes pushed with GITHUB_TOKEN do not retrigger workflows; if your",
     "#   branch protection requires checks on the fixed commit, push with a PAT instead.",
@@ -17627,7 +17633,7 @@ function renderCiWorkflow() {
     "      - name: Run skillset ci",
     "        id: skillset",
     "        run: >-",
-    "          bunx skillset@beta ci",
+    "          bunx skillset ci",
     "          ${{ github.event_name == 'pull_request' && github.event.pull_request.head.repo.full_name == github.repository && '--fix' || '' }}",
     '          --report "$RUNNER_TEMP/skillset-ci-report.md"',
     "        continue-on-error: true",
@@ -19064,7 +19070,7 @@ async function exists12(path2) {
 
 // apps/skillset/src/authoring.ts
 import { resolve as resolve8, relative as relative15 } from "path";
-var textDecoder4 = new TextDecoder;
+var textDecoder5 = new TextDecoder;
 async function explainPath(rootPath, inputPath, options = {}) {
   const graph = await loadBuildGraph(rootPath, options);
   const allRendered = await renderBuildGraph(graph);
@@ -19077,33 +19083,39 @@ async function explainPath(rootPath, inputPath, options = {}) {
   const items = collectLockItems(rendered);
   const asSource = items.filter((item) => item.sourcePath === target);
   if (asSource.length > 0) {
+    const matchedLoweringOutcomes = explainLoweringOutcomes(target, asSource, loweringOutcomes);
     return {
       path: target,
       kind: explainSourceKind(graph, target),
       entries: asSource.map((item) => item.entry),
-      loweringOutcomes: explainLoweringOutcomes(target, asSource, loweringOutcomes),
+      features: featureCapabilitiesForPath(graph, target, asSource, matchedLoweringOutcomes),
+      loweringOutcomes: matchedLoweringOutcomes,
       notes: sourceNotes(graph, target)
     };
   }
   const asGenerated = items.filter((item) => item.outputPath === target || item.files.some((file) => joinOutputRoot2(item.outputRoot, file) === target));
   if (asGenerated.length > 0) {
+    const matchedLoweringOutcomes = explainLoweringOutcomes(target, asGenerated, loweringOutcomes, {
+      includeSourcePaths: false
+    });
     return {
       path: target,
       kind: "generated",
       entries: asGenerated.map((item) => item.entry),
-      loweringOutcomes: explainLoweringOutcomes(target, asGenerated, loweringOutcomes, {
-        includeSourcePaths: false
-      }),
+      features: featureCapabilitiesForPath(graph, target, asGenerated, matchedLoweringOutcomes),
+      loweringOutcomes: matchedLoweringOutcomes,
       notes: [`Generated output; rebuild with skillset build, verify with skillset check.`]
     };
   }
   const prefixMatch = items.filter((item) => item.sourcePath.startsWith(`${target}/`));
   if (prefixMatch.length > 0) {
+    const matchedLoweringOutcomes = explainLoweringOutcomes(target, prefixMatch, loweringOutcomes);
     return {
       path: target,
       kind: "source-plugin",
       entries: prefixMatch.map((item) => item.entry),
-      loweringOutcomes: explainLoweringOutcomes(target, prefixMatch, loweringOutcomes),
+      features: featureCapabilitiesForPath(graph, target, prefixMatch, matchedLoweringOutcomes),
+      loweringOutcomes: matchedLoweringOutcomes,
       notes: [`Matched ${prefixMatch.length} generated entries under this source path.`]
     };
   }
@@ -19113,6 +19125,7 @@ async function explainPath(rootPath, inputPath, options = {}) {
       path: target,
       kind: explainSourceKind(graph, target),
       entries: [],
+      features: featureCapabilitiesForPath(graph, target, [], sourceOnlyOutcomes),
       loweringOutcomes: sourceOnlyOutcomes,
       notes: [`Matched ${sourceOnlyOutcomes.length} lowering outcome(s) under this source path.`]
     };
@@ -19121,6 +19134,7 @@ async function explainPath(rootPath, inputPath, options = {}) {
     path: target,
     kind: "unknown",
     entries: [],
+    features: [],
     loweringOutcomes: [],
     notes: [
       `No lock entry references ${target}. Pass a source path under ${graph.sourceDir}/ or a generated output path.`
@@ -19132,6 +19146,21 @@ async function listGeneratedEntries(rootPath, options = {}) {
   const rendered = scopedRenderedFiles(graph, await renderBuildGraph(graph), options.scopes);
   return collectLockItems(rendered).map((item) => item.entry);
 }
+function listFeatureCapabilities(featureId) {
+  const features = featureId === undefined ? listSkillsetFeatures() : [getSkillsetFeature(featureId)].filter((feature2) => feature2 !== undefined);
+  return features.map(featureCapability);
+}
+function summarizeFeatureCapabilities(features = listFeatureCapabilities()) {
+  return {
+    byFeatureStatus: countBy(features.map((feature2) => feature2.status)),
+    byTargetSupport: {
+      claude: countBy(features.map((feature2) => feature2.targetSupport.claude.status)),
+      codex: countBy(features.map((feature2) => feature2.targetSupport.codex.status))
+    },
+    featureIds: features.map((feature2) => feature2.id).sort(compareStrings),
+    total: features.length
+  };
+}
 async function doctorSkillset(rootPath, options = {}) {
   let graph;
   try {
@@ -19143,6 +19172,7 @@ async function doctorSkillset(rootPath, options = {}) {
       buildError: errorMessage3(error),
       buildDiagnostics: buildDiagnostics2,
       drift: { added: [], changed: [], missing: [], removed: [] },
+      featureCapabilities: summarizeFeatureCapabilities(),
       lintIssues: [],
       loweringOutcomes: loweringOutcomes2,
       notableLoweringOutcomes: notableLoweringOutcomes(loweringOutcomes2),
@@ -19170,6 +19200,7 @@ async function doctorSkillset(rootPath, options = {}) {
     ...buildError === undefined ? {} : { buildError },
     buildDiagnostics,
     drift,
+    featureCapabilities: summarizeFeatureCapabilities(),
     lintIssues: lint.issues,
     loweringOutcomes,
     notableLoweringOutcomes: notable,
@@ -19230,7 +19261,7 @@ function collectLockItems(rendered) {
       continue;
     let parsed;
     try {
-      parsed = JSON.parse(textDecoder4.decode(file.content));
+      parsed = JSON.parse(textDecoder5.decode(file.content));
     } catch {
       continue;
     }
@@ -19331,6 +19362,82 @@ function sourceNotes(graph, target) {
   }
   return notes;
 }
+function featureCapabilitiesForPath(graph, target, items, outcomes) {
+  const featureIds = new Set;
+  for (const item of items) {
+    if (item.entry.feature !== undefined)
+      featureIds.add(item.entry.feature);
+  }
+  for (const outcome of outcomes) {
+    featureIds.add(outcome.featureId);
+  }
+  for (const featureId of inferredFeatureIdsForSourcePath(graph, target)) {
+    featureIds.add(featureId);
+  }
+  return [...featureIds].map((featureId) => getSkillsetFeature(featureId)).filter((feature2) => feature2 !== undefined).map(featureCapability).sort((left, right) => compareStrings(left.id, right.id));
+}
+function inferredFeatureIdsForSourcePath(graph, target) {
+  const featureIds = [];
+  if (graph.rules.some((rule) => relative15(graph.rootPath, rule.sourcePath) === target)) {
+    featureIds.push("project-instructions");
+  }
+  if (graph.projectAgents.some((agent) => relative15(graph.rootPath, agent.sourcePath) === target)) {
+    featureIds.push("project-agents");
+  }
+  if (graph.projectIslands.some((island) => pathMatchesSource(graph, target, island.sourcePath))) {
+    featureIds.push("target-native-islands");
+  }
+  for (const skill of graph.standaloneSkills) {
+    if (!pathMatchesSource(graph, target, skill.sourcePath))
+      continue;
+    featureIds.push("standalone-skills");
+    if (skill.resources.length > 0)
+      featureIds.push("resources");
+  }
+  for (const plugin of graph.plugins) {
+    if (pathMatchesSource(graph, target, plugin.configPath)) {
+      featureIds.push("plugin-manifests");
+    }
+    for (const skill of plugin.skills) {
+      if (!pathMatchesSource(graph, target, skill.sourcePath))
+        continue;
+      featureIds.push("plugin-skills");
+      if (skill.resources.length > 0)
+        featureIds.push("resources");
+    }
+  }
+  return featureIds;
+}
+function pathMatchesSource(graph, target, sourcePath) {
+  const relativePath2 = relative15(graph.rootPath, sourcePath).replaceAll("\\", "/");
+  return target === relativePath2 || target.startsWith(`${relativePath2}/`);
+}
+function featureCapability(feature2) {
+  return {
+    docs: feature2.docs,
+    id: feature2.id,
+    status: feature2.status,
+    targetSupport: {
+      claude: supportCapability(feature2.targetSupport.claude),
+      codex: supportCapability(feature2.targetSupport.codex)
+    },
+    title: feature2.title
+  };
+}
+function supportCapability(support) {
+  return {
+    ...support.note === undefined ? {} : { note: support.note },
+    ...support.reason === undefined ? {} : { reason: support.reason },
+    status: support.status
+  };
+}
+function countBy(values) {
+  const counts = {};
+  for (const value of [...values].sort(compareStrings)) {
+    counts[value] = (counts[value] ?? 0) + 1;
+  }
+  return counts;
+}
 function normalizeRepoPath(rootPath, inputPath) {
   const absolute = resolve8(rootPath, inputPath);
   return relative15(rootPath, absolute).replaceAll("\\", "/");
@@ -19372,14 +19479,14 @@ async function resolveSkillsetCommand(rootPath = process.cwd(), env = process.en
   if (await isLocalSkillsetCheckout(rootPath)) {
     return { argv: ["bun", "./apps/skillset/src/cli.ts"], kind: "argv" };
   }
-  if (await commandExists("skillset", rootPath))
+  if (await commandExists("skillset", rootPath, env))
     return { argv: ["skillset"], kind: "argv" };
-  if (await commandExists("bunx", rootPath))
-    return { argv: ["bunx", "skillset@beta"], kind: "argv" };
-  if (await commandExists("bun", rootPath))
-    return { argv: ["bun", "x", "skillset@beta"], kind: "argv" };
-  if (await commandExists("npx", rootPath))
-    return { argv: ["npx", "--yes", "skillset@beta"], kind: "argv" };
+  if (await commandExists("bunx", rootPath, env))
+    return { argv: ["bunx", "skillset"], kind: "argv" };
+  if (await commandExists("bun", rootPath, env))
+    return { argv: ["bun", "x", "skillset"], kind: "argv" };
+  if (await commandExists("npx", rootPath, env))
+    return { argv: ["npx", "--yes", "skillset"], kind: "argv" };
   throw new Error("skillset: could not find a Skillset CLI runner; install skillset or set SKILLSET_HOOK_COMMAND");
 }
 async function runSkillsetCommand(args, options) {
@@ -19410,8 +19517,11 @@ async function runShell(command, args, options) {
   });
   return proc.exited;
 }
-async function commandExists(command, cwd) {
-  const result = await capture(["sh", "-lc", `command -v ${shellQuote(command)} >/dev/null 2>&1`], { cwd });
+async function commandExists(command, cwd, env) {
+  const result = await capture(["/bin/sh", "-lc", `command -v ${shellQuote(command)} >/dev/null 2>&1`], {
+    cwd,
+    env
+  });
   return result.exitCode === 0;
 }
 async function isLocalSkillsetCheckout(rootPath) {
@@ -19430,7 +19540,7 @@ async function capture(argv, options) {
   const proc = Bun.spawn({
     cmd: [...argv],
     cwd: options.cwd,
-    env: gitSafeEnv(),
+    env: gitSafeEnv(options.env),
     stderr: "ignore",
     stdout: "ignore"
   });
@@ -20632,6 +20742,7 @@ var USAGE = [
   "       skillset release apply [--yes|--dry-run] [--root <path>] [--source <dir>] [--dist <dir>]",
   "       skillset restore <backup-id> [--yes|--dry-run] [--root <path>]",
   "       skillset distribute plan [name] [--root <path>] [--source <dir>] [--dist <dir>]",
+  "       skillset features [feature-id] [--json]",
   "       skillset test [name] [--root <path>] [--source <dir>]",
   "       skillset hooks print --runner <lefthook|husky|pre-commit|git> [--pre-commit] [--pre-push]",
   "       skillset hooks print --target <claude|codex> --agent-runtime",
@@ -20965,6 +21076,25 @@ async function runCli(rawArgs = process.argv.slice(2), invokedName = basename8(p
     console.log(`skillset: listed ${entries.length} generated entries`);
     return;
   }
+  if (command === "features") {
+    const features = listFeatureCapabilities(importPath);
+    if (jsonOutput) {
+      process.stdout.write(renderValidatedJson({ features }, "skillset features"));
+      if (importPath !== undefined && features.length === 0)
+        process.exitCode = 1;
+      return;
+    }
+    if (features.length === 0) {
+      console.log(`skillset: feature ${importPath ?? ""} not found`);
+      process.exitCode = 1;
+      return;
+    }
+    for (const feature2 of features) {
+      printFeatureCapability(feature2);
+    }
+    console.log(`skillset: listed ${features.length} feature${features.length === 1 ? "" : "s"}`);
+    return;
+  }
   if (command === "explain") {
     if (importPath === undefined) {
       throw new Error("skillset: expected a path to explain");
@@ -21007,6 +21137,11 @@ async function runCli(rawArgs = process.argv.slice(2), invokedName = basename8(p
       if (entry.outputHash !== undefined)
         console.log(`    output hash: ${entry.outputHash}`);
     }
+    for (const feature2 of result3.features) {
+      console.log(`  feature ${feature2.id}: ${feature2.title}`);
+      console.log(`    claude: ${feature2.targetSupport.claude.status}`);
+      console.log(`    codex: ${feature2.targetSupport.codex.status}`);
+    }
     for (const outcome of result3.loweringOutcomes) {
       printLoweringOutcome(outcome);
     }
@@ -21036,6 +21171,9 @@ async function runCli(rawArgs = process.argv.slice(2), invokedName = basename8(p
     if (driftCount > 0) {
       console.log(`  drift: ${added.length} added, ${changed.length} changed, ${missing.length} missing, ${removed.length} removed (run skillset build --yes)`);
     }
+    console.log(`  features: ${report.featureCapabilities.total} registry entries; status ${formatCountSummary(report.featureCapabilities.byFeatureStatus)}`);
+    console.log(`  feature support: claude ${formatCountSummary(report.featureCapabilities.byTargetSupport.claude)}`);
+    console.log(`  feature support: codex ${formatCountSummary(report.featureCapabilities.byTargetSupport.codex)}`);
     for (const outcome of report.notableLoweringOutcomes) {
       printLoweringOutcome(outcome);
     }
@@ -21395,6 +21533,22 @@ function printSkillsetTest(report) {
   if (report.activationPath !== undefined)
     console.log(`  activation: ${report.activationPath}`);
 }
+function printFeatureCapability(feature2) {
+  console.log(`feature ${feature2.id}: ${feature2.title}`);
+  console.log(`  status: ${feature2.status}`);
+  console.log(`  claude: ${formatFeatureSupport(feature2.targetSupport.claude)}`);
+  console.log(`  codex: ${formatFeatureSupport(feature2.targetSupport.codex)}`);
+  if (feature2.docs.length > 0)
+    console.log(`  docs: ${feature2.docs.join(", ")}`);
+}
+function formatFeatureSupport(support) {
+  const reason = support.reason === undefined ? "" : ` (${support.reason})`;
+  const note = support.note === undefined ? "" : ` note: ${support.note}`;
+  return `${support.status}${reason}${note}`;
+}
+function formatCountSummary(counts) {
+  return Object.entries(counts).sort(([left], [right]) => left.localeCompare(right)).map(([key, count]) => `${key} ${count}`).join(", ");
+}
 function printLoweringOutcome(outcome) {
   const target = outcome.target ?? "workspace";
   const policy = outcome.policy === undefined ? "" : ` policy: ${outcome.policy}`;
@@ -21409,8 +21563,8 @@ function printLoweringOutcome(outcome) {
 }
 function parseArgs(args) {
   const command = args[0];
-  if (command !== "adopt" && command !== "build" && command !== "change" && command !== "check" && command !== "ci" && command !== "create" && command !== "diff" && command !== "distribute" && command !== "doctor" && command !== "explain" && command !== "hooks" && command !== "import" && command !== "init" && command !== "lint" && command !== "list" && command !== "release" && command !== "restore" && command !== "test") {
-    throw new Error(`skillset: expected command adopt, build, change, check, ci, create, diff, distribute, doctor, explain, hooks, import, init, lint, list, release, restore, or test
+  if (command !== "adopt" && command !== "build" && command !== "change" && command !== "check" && command !== "ci" && command !== "create" && command !== "diff" && command !== "distribute" && command !== "doctor" && command !== "explain" && command !== "features" && command !== "hooks" && command !== "import" && command !== "init" && command !== "lint" && command !== "list" && command !== "release" && command !== "restore" && command !== "test") {
+    throw new Error(`skillset: expected command adopt, build, change, check, ci, create, diff, distribute, doctor, explain, features, hooks, import, init, lint, list, release, restore, or test
 ` + USAGE);
   }
   let changeSubcommand;
@@ -21534,6 +21688,13 @@ function parseArgs(args) {
     importPath = rawPath;
     index += 1;
   }
+  if (command === "features") {
+    const rawFeatureId = args[index];
+    if (rawFeatureId !== undefined && !rawFeatureId.startsWith("--")) {
+      importPath = rawFeatureId;
+      index += 1;
+    }
+  }
   if (command === "restore") {
     const rawBackupId = args[index];
     if (rawBackupId === undefined || rawBackupId.startsWith("--")) {
@@ -21989,9 +22150,9 @@ function validateAdoptFlags(command, adopt) {
 function validateJsonFlags(command, jsonOutput) {
   if (!jsonOutput)
     return;
-  if (command === "doctor" || command === "explain")
+  if (command === "doctor" || command === "explain" || command === "features")
     return;
-  throw new Error("skillset: --json is only supported with doctor or explain");
+  throw new Error("skillset: --json is only supported with doctor, explain, or features");
 }
 function isImportKind(value) {
   return value === "skill" || value === "skills" || value === "plugin" || value === "plugins";

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "skillset",
-  "version": "0.1.0-beta.9",
+  "version": "0.13.1",
   "description": "Source-first compiler for Claude and Codex agent loadouts.",
   "type": "module",
   "files": [
     "dist/*.js"
   ],
   "publishConfig": {
-    "access": "public",
-    "tag": "beta"
+    "access": "public"
   },
   "repository": {
     "type": "git",