krisnye · Nov 2, 2026 · Nov 2, 2026 · Nov 2, 2026
diff --git a/.agents/skills/adobe-data-ai/meta-build/SKILL.md b/.agents/skills/adobe-data-ai/meta-build/SKILL.md
@@ -3,8 +3,8 @@ name: meta-build
 description: Iteratively build an application or game phase-by-phase in clean subagents, reviewing each phase and refining the build-* skills / rules until each is optimal, then summarizing.
 input: a prompt describing the application or game to build
 options:
-    target = build-application   # build command to exercise: build-application | build-game | build-feature | a single build-<phase>
-    maxIterations = 4            # attempts per phase before moving on
+    target: build-application   # build command to exercise: build-application | build-game | build-feature | a single build-<phase>
+    maxIterations: 4            # attempts per phase before moving on
 ---
 
 Purpose: exercise and **polish the build-* skills and the rules they reference**, using

diff --git a/.agents/skills/adobe-data-ai/x-alpha/SKILL.md b/.agents/skills/adobe-data-ai/x-alpha/SKILL.md
@@ -1,5 +1,6 @@
 ---
 name: x-alpha
+description: returns the string "alpha"
 input: void
 output: string
 ---

diff --git a/.agents/skills/adobe-data-ai/x-beta/SKILL.md b/.agents/skills/adobe-data-ai/x-beta/SKILL.md
@@ -1,5 +1,6 @@
 ---
 name: x-beta
+description: returns the string "beta"
 input: void
 output: string
 ---

diff --git a/.agents/skills/adobe-data-ai/x-double/SKILL.md b/.agents/skills/adobe-data-ai/x-double/SKILL.md
@@ -1,5 +1,6 @@
 ---
 name: x-double
+description: returns its number input doubled
 input: number
 output: number
 ---

diff --git a/.agents/skills/adobe-data-ai/x-pow/SKILL.md b/.agents/skills/adobe-data-ai/x-pow/SKILL.md
@@ -1,5 +1,6 @@
 ---
 name: x-pow
+description: returns base raised to exponent
 input:
     base: number
     exponent: number

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "data-monorepo",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "private": true,
   "engines": {
     "node": ">=24"

diff --git a/packages/data-ai/.claude-plugin/plugin.json b/packages/data-ai/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "adobe-data-ai",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Architecture skills for @adobe/data — data-oriented modelling, archetype iteration, hot-path performance, and related conventions.",
   "author": {
     "name": "Adobe"

diff --git a/packages/data-ai/package.json b/packages/data-ai/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-ai",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Cross-agent architecture skills for @adobe/data — installable as a Claude Code plugin or copied into any Agent-Skills-compatible agent (Cursor, Codex).",
   "type": "module",
   "private": false,
@@ -39,7 +39,8 @@
   "devDependencies": {
     "@adobe/data": "workspace:*",
     "typescript": "^5.8.3",
-    "vitest": "^5.0.5"
+    "vitest": "^5.0.5",
+    "yaml": "^2.9.1"
   },
   "license": "MIT"
 }
diff --git a/packages/data-ai/skills/meta-build/SKILL.md b/packages/data-ai/skills/meta-build/SKILL.md
@@ -4,8 +4,8 @@ disable-model-invocation: true
 description: Iteratively build an application or game phase-by-phase in clean subagents, reviewing each phase and refining the build-* skills / rules until each is optimal, then summarizing.
 input: a prompt describing the application or game to build
 options:
-    target = build-application   # build command to exercise: build-application | build-game | build-feature | a single build-<phase>
-    maxIterations = 4            # attempts per phase before moving on
+    target: build-application   # build command to exercise: build-application | build-game | build-feature | a single build-<phase>
+    maxIterations: 4            # attempts per phase before moving on
 ---
 
 Purpose: exercise and **polish the build-* skills and the rules they reference**, using

diff --git a/packages/data-ai/skills/x-alpha/SKILL.md b/packages/data-ai/skills/x-alpha/SKILL.md
@@ -1,5 +1,6 @@
 ---
 name: x-alpha
+description: returns the string "alpha"
 input: void
 output: string
 ---

diff --git a/packages/data-ai/skills/x-beta/SKILL.md b/packages/data-ai/skills/x-beta/SKILL.md
@@ -1,5 +1,6 @@
 ---
 name: x-beta
+description: returns the string "beta"
 input: void
 output: string
 ---

diff --git a/packages/data-ai/skills/x-double/SKILL.md b/packages/data-ai/skills/x-double/SKILL.md
@@ -1,5 +1,6 @@
 ---
 name: x-double
+description: returns its number input doubled
 input: number
 output: number
 ---

diff --git a/packages/data-ai/skills/x-pow/SKILL.md b/packages/data-ai/skills/x-pow/SKILL.md
@@ -1,5 +1,6 @@
 ---
 name: x-pow
+description: returns base raised to exponent
 input:
     base: number
     exponent: number

diff --git a/packages/data-ai/test/skills.test.mjs b/packages/data-ai/test/skills.test.mjs
@@ -0,0 +1,56 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+//
+// Every SKILL.md in the monorepo must have frontmatter that a strict YAML parser
+// accepts, because agent hosts reject a skill whose frontmatter does not parse.
+
+import { describe, expect, it } from "vitest";
+import { readdirSync, readFileSync } from "node:fs";
+import { basename, dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseDocument } from "yaml";
+
+const repositoryRoot = join(dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
+const skippedDirectories = new Set(["node_modules", ".git"]);
+
+function findSkillFiles(directory) {
+  return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+    const path = join(directory, entry.name);
+    if (entry.isDirectory()) {
+      return skippedDirectories.has(entry.name) ? [] : findSkillFiles(path);
+    }
+    return entry.name === "SKILL.md" ? [path] : [];
+  });
+}
+
+function parseFrontmatter(text) {
+  const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/.exec(text);
+  return match ? parseDocument(match[1]) : undefined;
+}
+
+const skillFiles = findSkillFiles(repositoryRoot);
+
+describe("SKILL.md frontmatter", () => {
+  it("finds the monorepo's skills", () => {
+    expect(skillFiles.length).toBeGreaterThan(0);
+  });
+
+  describe.each(skillFiles.map((file) => [relative(repositoryRoot, file), file]))("%s", (_, file) => {
+    const document = parseFrontmatter(readFileSync(file, "utf8"));
+
+    it("has frontmatter delimited by ---", () => {
+      expect(document).toBeDefined();
+    });
+
+    it("is valid YAML", () => {
+      expect(document?.errors.map((error) => error.message)).toEqual([]);
+      expect(document?.warnings.map((warning) => warning.message)).toEqual([]);
+    });
+
+    it("names the skill after its directory and describes it", () => {
+      const frontmatter = document?.toJS();
+      expect(frontmatter?.name).toBe(basename(dirname(file)));
+      expect(typeof frontmatter?.description).toBe("string");
+      expect(frontmatter?.description.trim()).not.toBe("");
+    });
+  });
+});
diff --git a/packages/data-gpu/package.json b/packages/data-gpu/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-gpu",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Adobe data WebGPU plugins and types for graphics and compute",
   "type": "module",
   "private": false,

diff --git a/packages/data-lit/package.json b/packages/data-lit/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-lit",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Adobe data Lit bindings - hooks, elements, decorators",
   "type": "module",
   "private": false,

diff --git a/packages/data-persistence/package.json b/packages/data-persistence/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@adobe/data-persistence",
-    "version": "0.10.30",
+    "version": "0.10.31",
     "description": "Worker-based incremental persistence layer for @adobe/data ECS over OPFS (browser) and node:fs (server).",
     "type": "module",
     "sideEffects": false,

diff --git a/packages/data-react/package.json b/packages/data-react/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-react",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Adobe data React bindings — hooks and context for ECS database",
   "type": "module",
   "private": false,

diff --git a/packages/data-rpc/package.json b/packages/data-rpc/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@adobe/data-rpc",
-    "version": "0.10.30",
+    "version": "0.10.31",
     "description": "Schema-driven, bidirectional projection of @adobe/data async data services across a boundary (iframe / MessagePort / Worker). Only Data crosses the wire.",
     "type": "module",
     "sideEffects": false,

diff --git a/packages/data-solid/package.json b/packages/data-solid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-solid",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Adobe data SolidJS bindings — context and provider for ECS database",
   "type": "module",
   "private": false,

diff --git a/packages/data-sync/package.json b/packages/data-sync/package.json
@@ -1,6 +1,6 @@
 {
     "name": "@adobe/data-sync",
-    "version": "0.10.30",
+    "version": "0.10.31",
     "description": "Multi-user real-time synchronisation for @adobe/data ECS — server, client, and in-process loopback.",
     "type": "module",
     "sideEffects": false,

diff --git a/packages/data-testing/package.json b/packages/data-testing/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-testing",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Conformance-testing utilities (Match + Conformance runners) for @adobe/data ECS features",
   "type": "module",
   "sideEffects": false,

diff --git a/packages/data/package.json b/packages/data/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data",
-  "version": "0.10.30",
+  "version": "0.10.31",
   "description": "Adobe data oriented programming library",
   "type": "module",
   "sideEffects": false,