@delorenj/skillex 0.1.1

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@delorenj/skillex",
+  "version": "0.1.1",
+  "description": "Canonical skill catalog and activation management for agentic CLIs.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Jarad DeLorenzo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/delorenj/skillex.git"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "bin": {
+    "skillex": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
+    "./schemas/result.schema.json": "./schemas/result.schema.json",
+    "./schemas/skills.schema.json": "./skills.schema.json"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "schemas/result.schema.json",
+    "skills.schema.json"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "lint": "biome check src scripts tests/node schemas skills.schema.json package.json tsconfig.json tsconfig.build.json biome.json",
+    "format": "biome check --write src scripts tests/node schemas skills.schema.json package.json tsconfig.json tsconfig.build.json biome.json",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test tests/node/*.test.mjs",
+    "check": "npm run lint && npm run typecheck && npm test",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run check"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "commander": "^15.0.0",
+    "semver": "^7.8.5",
+    "smol-toml": "^1.8.0",
+    "yaml": "^2.9.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.12",
+    "@types/node": "^24.13.3",
+    "@types/semver": "^7.8.0",
+    "esbuild": "^0.28.2",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/schemas/result.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/delorenj/skillex/main/schemas/result.schema.json",
+  "title": "Skillex command result, version 2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "command", "ok", "exit", "data", "findings"],
+  "properties": {
+    "schema": { "const": 2 },
+    "command": { "type": "string", "minLength": 1 },
+    "ok": { "type": "boolean" },
+    "exit": { "enum": [0, 1, 2, 3, 4, 5, 6, 130] },
+    "data": {},
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["code", "severity", "message"],
+        "properties": {
+          "code": { "type": "string", "pattern": "^[EWI]_.+$" },
+          "severity": { "enum": ["error", "warning", "info"] },
+          "message": { "type": "string" },
+          "path": { "type": "string" },
+          "fix": { "type": "string" },
+          "scope": { "type": "string" },
+          "name": { "type": "string" },
+          "detail": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "exit": { "const": 0 } } },
+      "then": {
+        "properties": {
+          "ok": { "const": true },
+          "findings": {
+            "items": { "properties": { "severity": { "not": { "const": "error" } } } }
+          }
+        }
+      },
+      "else": { "properties": { "ok": { "const": false } } }
+    }
+  ]
+}

package/skills.schema.json

@@ -0,0 +1,144 @@
+{
+  "$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.",
+  "type": "object",
+  "additionalProperties": false,
+  "definitions": {
+    "skillName": {
+      "type": "string",
+      "pattern": "^[a-z0-9]([a-z0-9._-]*[a-z0-9])?(?![\\s\\S])",
+      "description": "One canonical all-skills/ name: lowercase letters, digits, dot, dash, or underscore, beginning and ending with a letter or digit."
+    },
+    "compositionName": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9._-]*[a-zA-Z0-9])?(?![\\s\\S])",
+      "description": "One safe set or pack directory name, preserving the case of existing compositions."
+    },
+    "versionComponent": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9._+-]*[a-zA-Z0-9])?(?![\\s\\S])",
+      "description": "One safe pack version directory name, including semantic-version prerelease and build suffixes."
+    },
+    "skillNames": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/skillName"
+      }
+    }
+  },
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Editor schema reference. Validation always uses the schema shipped with the installed Skillex package."
+    },
+    "scope": {
+      "type": "string",
+      "enum": ["global", "project"],
+      "description": "Advisory label. Manifest placement determines scope; a mismatch is reported without changing that placement."
+    },
+    "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."
+    },
+    "registry": {
+      "type": "string",
+      "pattern": "\\S",
+      "description": "Repository identity used to locate an existing local registry cache. It never triggers cloning, fetching, or network access."
+    },
+    "skills": {
+      "type": "array",
+      "description": "Explicit canonical all-skills/ references, applied after inherited names and ordered sets. Repeated references collapse; conflicting canonical targets fail.",
+      "items": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/skillName"
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name"],
+            "properties": {
+              "name": {
+                "$ref": "#/definitions/skillName"
+              }
+            }
+          }
+        ]
+      }
+    },
+    "sets": {
+      "type": "array",
+      "description": "Composable references to sets/<name>, processed in declaration order. Every selected member resolves to its canonical all-skills/ definition.",
+      "items": {
+        "anyOf": [
+          {
+            "$ref": "#/definitions/compositionName"
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name"],
+            "properties": {
+              "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,
+                "description": "Report an unavailable set as an optional skip instead of a required-reference failure."
+              }
+            }
+          }
+        ]
+      }
+    },
+    "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.",
+      "items": {
+        "anyOf": [
+          {
+            "type": "string",
+            "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9._-]*[a-zA-Z0-9])?(@[a-zA-Z0-9]([a-zA-Z0-9._+-]*[a-zA-Z0-9])?)?(?![\\s\\S])",
+            "description": "Pack name, optionally followed by @VERSION. An omitted version selects the latest available local version."
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name"],
+            "properties": {
+              "name": {
+                "$ref": "#/definitions/compositionName"
+              },
+              "version": {
+                "$ref": "#/definitions/versionComponent"
+              },
+              "optional": {
+                "type": "boolean",
+                "default": false,
+                "description": "Report an unavailable pack as an optional skip. Ordinary selections remain dormant while the pack is selected."
+              }
+            }
+          }
+        ]
+      }
+    },
+    "exclude": {
+      "$ref": "#/definitions/skillNames",
+      "description": "Mask canonical names after inheritance, sets, and explicit skills have been composed. Ignored while an exclusive pack is active."
+    }
+  }
+}