@delorenj/skillex 0.1.3 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delorenj/skillex",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Canonical skill catalog and activation management for agentic CLIs.",
   "type": "module",
   "license": "MIT",
@@ -39,6 +39,7 @@
     "typecheck": "tsc --noEmit",
     "test": "npm run build && node --test tests/node/*.test.mjs",
     "check": "npm run lint && npm run typecheck && npm test",
+    "prepare": "npm run build",
     "prepack": "npm run build",
     "prepublishOnly": "npm run check"
   },

package/skills.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://raw.githubusercontent.com/delorenj/skillex/main/skills.schema.json",
   "title": "Agent Skills Manifest",
-  "description": "Canonical skill selections for one global or project activation root. Resolution is offline; all definitions belong to all-skills/ and sets and packs contain references only.",
+  "description": "Selection schema for the corrected product contract, confirmed 2026-10-10: a set exclusively replaces the canonical .agents/skills/ root with a symlink to the set's skill root (at most one set per scope); packs compose by adding per-skill member links to an existing canonical root. Definitions belong to all-skills/; sets and packs contain references only.",
   "type": "object",
   "additionalProperties": false,
   "definitions": {
@@ -42,7 +42,7 @@
     "inherit_global": {
       "type": "boolean",
       "default": true,
-      "description": "Include global selections in a composed project selection. This does not choose which roots a command writes. Ignored for global scope or an active exclusive pack."
+      "description": "Include global selections in a composed project selection; ignored globally and while a set exclusively replaces the project root. This does not choose write scopes and cannot suppress client-level discovery of the global root."
     },
     "registry": {
       "type": "string",
@@ -51,7 +51,7 @@
     },
     "skills": {
       "type": "array",
-      "description": "Explicit canonical all-skills/ references, applied after inherited names and ordered sets. Repeated references collapse; conflicting canonical targets fail.",
+      "description": "Explicit canonical all-skills/ references applied after inheritance in a composed selection; rejected while a set exclusively replaces the root (enable derives a scope-owned set instead).",
       "items": {
         "anyOf": [
           {
@@ -72,7 +72,8 @@
     },
     "sets": {
       "type": "array",
-      "description": "Composable references to sets/<name>, processed in declaration order. Every selected member resolves to its canonical all-skills/ definition.",
+      "maxItems": 1,
+      "description": "Sets are mutually exclusive root replacements: selecting one replaces .agents/skills/ with a symlink to the set's skill root and replaces inherited global selection. At most one set per scope.",
       "items": {
         "anyOf": [
           {
@@ -86,14 +87,6 @@
               "name": {
                 "$ref": "#/definitions/compositionName"
               },
-              "include": {
-                "$ref": "#/definitions/skillNames",
-                "description": "Limit this set to these canonical members. Omission includes all members; an empty list includes none."
-              },
-              "exclude": {
-                "$ref": "#/definitions/skillNames",
-                "description": "Remove these members from this set contribution only."
-              },
               "optional": {
                 "type": "boolean",
                 "default": false,
@@ -106,8 +99,7 @@
     },
     "packs": {
       "type": "array",
-      "maxItems": 1,
-      "description": "At most one exclusive loadout from packs/. An active pack replaces the entire effective selection while ordinary declarations remain dormant for restoration. Pack member filters are unsupported.",
+      "description": "Packs are composable: each adds its member per-skill links to the existing canonical root, alongside any selected skills.",
       "items": {
         "anyOf": [
           {
@@ -129,7 +121,7 @@
               "optional": {
                 "type": "boolean",
                 "default": false,
-                "description": "Report an unavailable pack as an optional skip. Ordinary selections remain dormant while the pack is selected."
+                "description": "Report an unavailable pack as an optional skip; its members are simply not contributed."
               }
             }
           }
@@ -138,7 +130,7 @@
     },
     "exclude": {
       "$ref": "#/definitions/skillNames",
-      "description": "Mask canonical names after inheritance, sets, and explicit skills have been composed. Ignored while an exclusive pack is active."
+      "description": "Mask names after inheritance, packs, and explicit skills in a composed selection; unsupported while a set exclusively replaces the root."
     }
   }
 }