@joktec/skills 0.1.2 → 0.1.3

package/README.md

@@ -109,19 +109,28 @@ The result is less prompt repetition, better package boundary discipline, and mo
 
 `joktec-framework-skill` is the required entrypoint skill. Installers should always include it so agents can route from a generic JokTec request to the correct focused skill.
 
-`joktec-common-skill` is the default foundation skill. Focused package skills such as Mongo, MySQL, brokers, adapters, integrations, and tools depend on the entrypoint and recommend the common skill because most package usage flows rely on core config, lifecycle, or base abstractions.
+`joktec-common-skill` is the required foundation skill. It depends on `joktec-framework-skill`. Focused package skills such as Mongo, MySQL, brokers, adapters, integrations, and tools depend on both `joktec-framework-skill` and `joktec-common-skill` because most package usage flows rely on core config, lifecycle, or base abstractions.
 
 Dependency metadata lives in `skill-pack.json`:
 
 ```json
 {
   "id": "joktec-mongo-skill",
-  "dependencies": ["joktec-framework-skill"],
-  "recommended": ["joktec-common-skill"]
+  "dependencies": ["joktec-framework-skill", "joktec-common-skill"],
+  "recommended": []
 }
 ```
 
-The CLI resolves `dependencies` automatically. `recommended` skills are shown to the user and can be installed with `--yes` or explicit selection.
+The `@joktec/skills` CLI resolves `dependencies` automatically.
+
+The ecosystem `npx skills` CLI currently installs exactly the skills selected in its prompt. When using it, select dependencies manually or pass them explicitly:
+
+```bash
+npx skills add joktec/joktec-skills -a codex --project . \
+  --skill joktec-framework-skill joktec-common-skill joktec-mongo-skill
+```
+
+`npx skills` also writes a project-level `skills-lock.json`. Keep that file if the project wants reproducible skill updates or restore support through the ecosystem CLI.
 
 ---
 
@@ -197,6 +206,13 @@ Install focused skills. Required dependencies are included automatically:
 npx @joktec/skills add mongo,mysql --agent codex --project .
 ```
 
+Using the ecosystem `skills` CLI:
+
+```bash
+npx skills add joktec/joktec-skills -a codex --project . \
+  --skill joktec-framework-skill joktec-common-skill joktec-mongo-skill
+```
+
 Install for multiple agents:
 
 ```bash

package/bin/joktec-skills.mjs

@@ -5,7 +5,7 @@ import path from 'node:path';
 import readline from 'node:readline';
 import readlinePromises from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
-import { DIST_DIR, ROOT, ensureDir, loadSkills, readJson, writeFile } from '../scripts/lib.mjs';
+import { DIST_DIR, ROOT, ensureDir, loadSkills, readJson } from '../scripts/lib.mjs';
 
 const AGENTS = ['codex', 'claude', 'cursor', 'gemini', 'copilot', 'windsurf'];
 const DEFAULT_SOURCE = 'https://github.com/joktec/joktec-skills.git';
@@ -268,22 +268,6 @@ function executeOperations(operations, force, dryRun) {
   }
 }
 
-function writeManifest(project, pack, agents, skillIds, dryRun) {
-  const file = path.join(project, '.joktec-skills.json');
-  const existing = fs.existsSync(file) ? readJson(file) : {};
-  const manifest = {
-    package: '@joktec/skills',
-    version: pack.version,
-    installedAt: new Date().toISOString(),
-    agents: Array.from(new Set([...(existing.agents || []), ...agents])).sort(),
-    skills: Array.from(new Set([...(existing.skills || []), ...skillIds])).sort(),
-    frameworkBaseline: pack.frameworkBaseline,
-    packageBaseline: pack.packageBaseline,
-  };
-  if (!dryRun) writeFile(file, JSON.stringify(manifest, null, 2));
-  return manifest;
-}
-
 function logo() {
   console.log(color.dim(`     ██╗ ██████╗ ██╗  ██╗████████╗███████╗ ██████╗
      ██║██╔═══██╗██║ ██╔╝╚══██╔══╝██╔════╝██╔════╝
@@ -346,15 +330,26 @@ function buildInstalledLines(project, operations, skillIds, dryRun) {
   ]);
 }
 
+function stripAnsi(value) {
+  return String(value).replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, '');
+}
+
+function fitLine(value) {
+  const width = Math.max(40, (output.columns || 100) - 4);
+  const plain = stripAnsi(value);
+  if (plain.length <= width) return value;
+  return `${plain.slice(0, width - 1)}…`;
+}
+
 function renderMultiSelect(items, cursor, selected, message) {
-  readline.cursorTo(output, 0);
-  readline.clearScreenDown(output);
-  console.log(`${color.green('◇')}  ${message} ${color.dim('(space to toggle, enter to confirm)')}`);
+  const lines = [`${color.green('◇')}  ${message} ${color.dim('(space to toggle, enter to confirm)')}`];
   for (let i = 0; i < items.length; i += 1) {
     const marker = selected.has(items[i].value) ? color.green('●') : '○';
     const pointer = i === cursor ? color.cyan('›') : ' ';
-    console.log(`│ ${pointer} ${marker} ${items[i].label}`);
+    lines.push(`│ ${pointer} ${marker} ${fitLine(items[i].label)}`);
   }
+  output.write(`${lines.join('\n')}\n`);
+  return lines.length;
 }
 
 async function multiSelect(items, defaults, message) {
@@ -362,12 +357,22 @@ async function multiSelect(items, defaults, message) {
 
   const selected = new Set(defaults);
   let cursor = 0;
+  let renderedLines = 0;
   output.write('\n');
   readline.emitKeypressEvents(input);
   input.setRawMode(true);
 
   try {
     return await new Promise(resolve => {
+      const redraw = () => {
+        if (renderedLines) {
+          readline.moveCursor(output, 0, -renderedLines);
+          readline.cursorTo(output, 0);
+          readline.clearScreenDown(output);
+        }
+        renderedLines = renderMultiSelect(items, cursor, selected, message);
+      };
+
       const onKey = (str, key) => {
         if (key.name === 'c' && key.ctrl) {
           input.setRawMode(false);
@@ -383,15 +388,16 @@ async function multiSelect(items, defaults, message) {
         if (key.name === 'return') {
           input.off('keypress', onKey);
           input.setRawMode(false);
+          if (renderedLines) readline.moveCursor(output, 0, -renderedLines);
           readline.cursorTo(output, 0);
           readline.clearScreenDown(output);
           resolve(Array.from(selected));
           return;
         }
-        renderMultiSelect(items, cursor, selected, message);
+        redraw();
       };
 
-      renderMultiSelect(items, cursor, selected, message);
+      redraw();
       input.on('keypress', onKey);
     });
   } finally {
@@ -410,6 +416,7 @@ async function confirm(message, yes) {
 
 async function addCommand(args) {
   const { pack } = loadSkills();
+  const pkg = readJson(path.join(ROOT, 'package.json'));
   const project = path.resolve(args.project || '.');
   const source = consumeSourceToken(args);
   const agents = parseAgents(args.agent);
@@ -427,11 +434,12 @@ async function addCommand(args) {
     selected = await multiSelect(
       pack.skills.map(skill => ({
         value: skill.id,
-        label: `${skill.id} ${color.dim(`(${skill.packages.join(', ')})`)}`,
+        label: `${skill.id} (${skill.packages.join(', ')})`,
       })),
       pack.skills.filter(skill => skill.requiredByDefault).map(skill => skill.id),
       'Select skills to install',
     );
+    step('Select skills to install', selected.join(', '));
   } else {
     selected = resolveSkillIds(pack, requested, Boolean(args.all));
     step('Select skills to install', selected.join(', '));
@@ -457,15 +465,13 @@ async function addCommand(args) {
   }
 
   executeOperations(operations, Boolean(args.force), Boolean(args['dry-run']));
-  const manifest = writeManifest(project, pack, agents, resolution.selected, Boolean(args['dry-run']));
 
   step(args['dry-run'] ? 'Dry run complete' : 'Installation complete');
   box(
     `${args['dry-run'] ? 'Planned' : 'Installed'} ${resolution.selected.length} skills`,
     buildInstalledLines(project, operations, resolution.selected, Boolean(args['dry-run'])),
   );
-  console.log(`│  ${color.dim(`Manifest: ${displayPath(path.join(project, '.joktec-skills.json'))}`)}`);
-  console.log(`│  ${color.dim(`@joktec/skills ${manifest.version}`)}`);
+  console.log(`│  ${color.dim(`@joktec/skills ${pkg.version}`)}`);
   console.log('│');
   done('Review skills before use; they run with full agent permissions.');
 }

package/dist/claude/skills/joktec-adapter-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-adapter-skill
 description: Use when wiring or using JokTec adapter packages @joktec/cacher, @joktec/mailer, @joktec/notifier, or @joktec/storage for cache, mail delivery, push notifications, object storage, config-driven clients, and app-neutral adapter services.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Adapter Skill

package/dist/claude/skills/joktec-broker-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-broker-skill
 description: Use when wiring or using JokTec broker packages @joktec/kafka, @joktec/rabbit, @joktec/sqs, or @joktec/redcast, including client config, producer decorators, consumer loaders, message handlers, auto-binding, and app-level broker flows.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Broker Skill

package/dist/claude/skills/joktec-common-skill/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: joktec-common-skill
 description: Use when implementing or wiring @joktec/core, @joktec/utils, or @joktec/cron in a consumer app, especially BaseController, BaseService, pagination, config, client lifecycle, bootstrap, cron decorators, or utility helpers.
+metadata:
+  dependencies:
+    - joktec-framework-skill
 ---
 
 # JokTec Common Skill

package/dist/claude/skills/joktec-database-extended-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-database-extended-skill
 description: Use when working with extended JokTec database packages @joktec/elastic, @joktec/arango, or @joktec/bigquery in a consumer app, including app-neutral client setup, config-driven lifecycle, and package-specific query/service usage.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Extended Database Skill

package/dist/claude/skills/joktec-integration-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-integration-skill
 description: Use when wiring or using JokTec integration packages @joktec/firebase or @joktec/gpt, including validated config, SDK client lifecycle, app-neutral integration services, credentials handling, and consumer app composition.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Integration Skill

package/dist/claude/skills/joktec-mongo-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-mongo-skill
 description: Use when working with @joktec/mongo in a consumer app, including MongoModule setup, Typegoose schema decorators, MongoRepo, MongoService, MongoHelper, plugins, ObjectId/query safety, soft delete, strict references, and cursor pagination.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Mongo Skill

package/dist/claude/skills/joktec-mysql-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-mysql-skill
 description: Use when working with @joktec/mysql in a consumer app, including MysqlModule setup, TypeORM entities, schema-first @Column/@PrimaryColumn decorators, MysqlRepo, MysqlService, transactions, dialect support, uuidv7 ids, query safety, and cursor pagination.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec MySQL Skill

package/dist/claude/skills/joktec-tool-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-tool-skill
 description: Use when wiring or using JokTec tool packages @joktec/http, @joktec/file, or @joktec/alert, including Axios-backed HTTP clients, file classification helpers, Slack-compatible alert webhooks, config-driven lifecycle, and app-neutral utility services.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Tool Skill

package/dist/codex/skills/joktec-adapter-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-adapter-skill
 description: Use when wiring or using JokTec adapter packages @joktec/cacher, @joktec/mailer, @joktec/notifier, or @joktec/storage for cache, mail delivery, push notifications, object storage, config-driven clients, and app-neutral adapter services.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Adapter Skill

package/dist/codex/skills/joktec-broker-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-broker-skill
 description: Use when wiring or using JokTec broker packages @joktec/kafka, @joktec/rabbit, @joktec/sqs, or @joktec/redcast, including client config, producer decorators, consumer loaders, message handlers, auto-binding, and app-level broker flows.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Broker Skill

package/dist/codex/skills/joktec-common-skill/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: joktec-common-skill
 description: Use when implementing or wiring @joktec/core, @joktec/utils, or @joktec/cron in a consumer app, especially BaseController, BaseService, pagination, config, client lifecycle, bootstrap, cron decorators, or utility helpers.
+metadata:
+  dependencies:
+    - joktec-framework-skill
 ---
 
 # JokTec Common Skill

package/dist/codex/skills/joktec-database-extended-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-database-extended-skill
 description: Use when working with extended JokTec database packages @joktec/elastic, @joktec/arango, or @joktec/bigquery in a consumer app, including app-neutral client setup, config-driven lifecycle, and package-specific query/service usage.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Extended Database Skill

package/dist/codex/skills/joktec-integration-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-integration-skill
 description: Use when wiring or using JokTec integration packages @joktec/firebase or @joktec/gpt, including validated config, SDK client lifecycle, app-neutral integration services, credentials handling, and consumer app composition.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Integration Skill

package/dist/codex/skills/joktec-mongo-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-mongo-skill
 description: Use when working with @joktec/mongo in a consumer app, including MongoModule setup, Typegoose schema decorators, MongoRepo, MongoService, MongoHelper, plugins, ObjectId/query safety, soft delete, strict references, and cursor pagination.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Mongo Skill

package/dist/codex/skills/joktec-mysql-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-mysql-skill
 description: Use when working with @joktec/mysql in a consumer app, including MysqlModule setup, TypeORM entities, schema-first @Column/@PrimaryColumn decorators, MysqlRepo, MysqlService, transactions, dialect support, uuidv7 ids, query safety, and cursor pagination.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec MySQL Skill

package/dist/codex/skills/joktec-tool-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-tool-skill
 description: Use when wiring or using JokTec tool packages @joktec/http, @joktec/file, or @joktec/alert, including Axios-backed HTTP clients, file classification helpers, Slack-compatible alert webhooks, config-driven lifecycle, and app-neutral utility services.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Tool Skill

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joktec/skills",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "private": false,
   "description": "Hybrid agent skill pack for using @joktec/* libraries in consumer projects.",
   "license": "MIT",

package/scripts/validate-skills.mjs

@@ -7,6 +7,32 @@ const pack = readJson(PACK_PATH);
 const { skills } = loadSkills();
 
 const skillIds = new Set(skills.map(skill => skill.id));
+function readFrontmatterDependencies(raw) {
+  const match = raw.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return [];
+  const lines = match[1].split('\n');
+  const deps = [];
+  let inMetadata = false;
+  let inDependencies = false;
+  for (const line of lines) {
+    if (/^\S/.test(line)) {
+      inMetadata = line.trim() === 'metadata:';
+      inDependencies = false;
+      continue;
+    }
+    if (inMetadata && /^  dependencies:\s*$/.test(line)) {
+      inDependencies = true;
+      continue;
+    }
+    if (inDependencies) {
+      const item = line.match(/^    -\s+(.+?)\s*$/);
+      if (item) deps.push(item[1].trim());
+      else if (/^  \S/.test(line)) inDependencies = false;
+    }
+  }
+  return deps;
+}
+
 for (const meta of pack.skills) {
   if (!skillIds.has(meta.id)) errors.push(`Missing skill directory for metadata id: ${meta.id}`);
   for (const dependency of meta.dependencies || []) {
@@ -38,6 +64,12 @@ for (const skill of skills) {
   if (!skill.frontmatter.description || skill.frontmatter.description.length < 80) {
     errors.push(`${skill.id}: description is missing or too short for reliable triggering`);
   }
+  const meta = pack.skills.find(item => item.id === skill.id);
+  const declaredDeps = readFrontmatterDependencies(skill.raw);
+  const packDeps = meta?.dependencies || [];
+  if (declaredDeps.join('|') !== packDeps.join('|')) {
+    errors.push(`${skill.id}: frontmatter metadata.dependencies must match skill-pack dependencies`);
+  }
 
   const refs = readReferences(skill);
   const linkedRefs = Array.from(skill.raw.matchAll(/references\/[A-Za-z0-9_.-]+\.md/g)).map(match => match[0]);

package/skill-pack.json

@@ -1,6 +1,6 @@
 {
   "name": "@joktec/skills",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "sourceOfTruth": "../joktec-framework",
   "frameworkBaseline": {
     "repo": "https://github.com/joktec/joktec-framework",
@@ -41,106 +41,315 @@
       "requiredByDefault": true,
       "dependencies": [],
       "recommended": [],
-      "packages": ["@joktec/*"],
-      "scope": { "paths": ["**/*"] },
-      "triggers": ["joktec", "@joktec", "framework", "package selection"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "packages": [
+        "@joktec/*"
+      ],
+      "scope": {
+        "paths": [
+          "**/*"
+        ]
+      },
+      "triggers": [
+        "joktec",
+        "@joktec",
+        "framework",
+        "package selection"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     },
     {
       "id": "joktec-common-skill",
       "title": "JokTec Common Skill",
       "role": "foundation",
       "requiredByDefault": true,
-      "dependencies": ["joktec-framework-skill"],
+      "dependencies": [
+        "joktec-framework-skill"
+      ],
       "recommended": [],
-      "packages": ["@joktec/core", "@joktec/utils", "@joktec/cron", "@joktec/types"],
-      "scope": { "paths": ["packages/common/**"] },
-      "triggers": ["BaseController", "BaseService", "pagination", "config", "cron", "utils"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "packages": [
+        "@joktec/core",
+        "@joktec/utils",
+        "@joktec/cron",
+        "@joktec/types"
+      ],
+      "scope": {
+        "paths": [
+          "packages/common/**"
+        ]
+      },
+      "triggers": [
+        "BaseController",
+        "BaseService",
+        "pagination",
+        "config",
+        "cron",
+        "utils"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     },
     {
       "id": "joktec-mongo-skill",
       "title": "JokTec Mongo Skill",
       "role": "focused",
       "requiredByDefault": false,
-      "dependencies": ["joktec-framework-skill"],
-      "recommended": ["joktec-common-skill"],
-      "packages": ["@joktec/mongo"],
-      "scope": { "paths": ["packages/databases/mongo/**"] },
-      "triggers": ["mongo", "mongoose", "typegoose", "MongoRepo", "cursor pagination"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "dependencies": [
+        "joktec-framework-skill",
+        "joktec-common-skill"
+      ],
+      "recommended": [],
+      "packages": [
+        "@joktec/mongo"
+      ],
+      "scope": {
+        "paths": [
+          "packages/databases/mongo/**"
+        ]
+      },
+      "triggers": [
+        "mongo",
+        "mongoose",
+        "typegoose",
+        "MongoRepo",
+        "cursor pagination"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     },
     {
       "id": "joktec-mysql-skill",
       "title": "JokTec MySQL Skill",
       "role": "focused",
       "requiredByDefault": false,
-      "dependencies": ["joktec-framework-skill"],
-      "recommended": ["joktec-common-skill"],
-      "packages": ["@joktec/mysql"],
-      "scope": { "paths": ["packages/databases/mysql/**"] },
-      "triggers": ["mysql", "typeorm", "MysqlRepo", "schema-first decorators", "uuidv7"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "dependencies": [
+        "joktec-framework-skill",
+        "joktec-common-skill"
+      ],
+      "recommended": [],
+      "packages": [
+        "@joktec/mysql"
+      ],
+      "scope": {
+        "paths": [
+          "packages/databases/mysql/**"
+        ]
+      },
+      "triggers": [
+        "mysql",
+        "typeorm",
+        "MysqlRepo",
+        "schema-first decorators",
+        "uuidv7"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     },
     {
       "id": "joktec-broker-skill",
       "title": "JokTec Broker Skill",
       "role": "grouped",
       "requiredByDefault": false,
-      "dependencies": ["joktec-framework-skill"],
-      "recommended": ["joktec-common-skill"],
-      "packages": ["@joktec/kafka", "@joktec/rabbit", "@joktec/sqs", "@joktec/redcast"],
-      "scope": { "paths": ["packages/brokers/**"] },
-      "triggers": ["kafka", "rabbit", "sqs", "redcast", "broker", "message pattern"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "dependencies": [
+        "joktec-framework-skill",
+        "joktec-common-skill"
+      ],
+      "recommended": [],
+      "packages": [
+        "@joktec/kafka",
+        "@joktec/rabbit",
+        "@joktec/sqs",
+        "@joktec/redcast"
+      ],
+      "scope": {
+        "paths": [
+          "packages/brokers/**"
+        ]
+      },
+      "triggers": [
+        "kafka",
+        "rabbit",
+        "sqs",
+        "redcast",
+        "broker",
+        "message pattern"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     },
     {
       "id": "joktec-adapter-skill",
       "title": "JokTec Adapter Skill",
       "role": "grouped",
       "requiredByDefault": false,
-      "dependencies": ["joktec-framework-skill"],
-      "recommended": ["joktec-common-skill"],
-      "packages": ["@joktec/cacher", "@joktec/mailer", "@joktec/notifier", "@joktec/storage"],
-      "scope": { "paths": ["packages/adapters/**"] },
-      "triggers": ["cache", "mail", "notification", "storage", "adapter"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "dependencies": [
+        "joktec-framework-skill",
+        "joktec-common-skill"
+      ],
+      "recommended": [],
+      "packages": [
+        "@joktec/cacher",
+        "@joktec/mailer",
+        "@joktec/notifier",
+        "@joktec/storage"
+      ],
+      "scope": {
+        "paths": [
+          "packages/adapters/**"
+        ]
+      },
+      "triggers": [
+        "cache",
+        "mail",
+        "notification",
+        "storage",
+        "adapter"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     },
     {
       "id": "joktec-database-extended-skill",
       "title": "JokTec Extended Database Skill",
       "role": "grouped",
       "requiredByDefault": false,
-      "dependencies": ["joktec-framework-skill"],
-      "recommended": ["joktec-common-skill"],
-      "packages": ["@joktec/elastic", "@joktec/arango", "@joktec/bigquery"],
-      "scope": { "paths": ["packages/databases/elastic/**", "packages/databases/arango/**", "packages/databases/bigquery/**"] },
-      "triggers": ["elastic", "arango", "bigquery", "extended database"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "dependencies": [
+        "joktec-framework-skill",
+        "joktec-common-skill"
+      ],
+      "recommended": [],
+      "packages": [
+        "@joktec/elastic",
+        "@joktec/arango",
+        "@joktec/bigquery"
+      ],
+      "scope": {
+        "paths": [
+          "packages/databases/elastic/**",
+          "packages/databases/arango/**",
+          "packages/databases/bigquery/**"
+        ]
+      },
+      "triggers": [
+        "elastic",
+        "arango",
+        "bigquery",
+        "extended database"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     },
     {
       "id": "joktec-integration-skill",
       "title": "JokTec Integration Skill",
       "role": "grouped",
       "requiredByDefault": false,
-      "dependencies": ["joktec-framework-skill"],
-      "recommended": ["joktec-common-skill"],
-      "packages": ["@joktec/firebase", "@joktec/gpt"],
-      "scope": { "paths": ["packages/integrations/**"] },
-      "triggers": ["firebase", "gpt", "openai", "integration"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "dependencies": [
+        "joktec-framework-skill",
+        "joktec-common-skill"
+      ],
+      "recommended": [],
+      "packages": [
+        "@joktec/firebase",
+        "@joktec/gpt"
+      ],
+      "scope": {
+        "paths": [
+          "packages/integrations/**"
+        ]
+      },
+      "triggers": [
+        "firebase",
+        "gpt",
+        "openai",
+        "integration"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     },
     {
       "id": "joktec-tool-skill",
       "title": "JokTec Tool Skill",
       "role": "grouped",
       "requiredByDefault": false,
-      "dependencies": ["joktec-framework-skill"],
-      "recommended": ["joktec-common-skill"],
-      "packages": ["@joktec/http", "@joktec/file", "@joktec/alert"],
-      "scope": { "paths": ["packages/tools/**"] },
-      "triggers": ["http", "axios", "file", "alert", "tool"],
-      "outputs": { "codex": true, "claude": true, "cursor": true, "gemini": true, "copilot": true, "windsurf": true }
+      "dependencies": [
+        "joktec-framework-skill",
+        "joktec-common-skill"
+      ],
+      "recommended": [],
+      "packages": [
+        "@joktec/http",
+        "@joktec/file",
+        "@joktec/alert"
+      ],
+      "scope": {
+        "paths": [
+          "packages/tools/**"
+        ]
+      },
+      "triggers": [
+        "http",
+        "axios",
+        "file",
+        "alert",
+        "tool"
+      ],
+      "outputs": {
+        "codex": true,
+        "claude": true,
+        "cursor": true,
+        "gemini": true,
+        "copilot": true,
+        "windsurf": true
+      }
     }
   ]
 }

package/skills/joktec-adapter-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-adapter-skill
 description: Use when wiring or using JokTec adapter packages @joktec/cacher, @joktec/mailer, @joktec/notifier, or @joktec/storage for cache, mail delivery, push notifications, object storage, config-driven clients, and app-neutral adapter services.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Adapter Skill

package/skills/joktec-broker-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-broker-skill
 description: Use when wiring or using JokTec broker packages @joktec/kafka, @joktec/rabbit, @joktec/sqs, or @joktec/redcast, including client config, producer decorators, consumer loaders, message handlers, auto-binding, and app-level broker flows.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Broker Skill

package/skills/joktec-common-skill/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: joktec-common-skill
 description: Use when implementing or wiring @joktec/core, @joktec/utils, or @joktec/cron in a consumer app, especially BaseController, BaseService, pagination, config, client lifecycle, bootstrap, cron decorators, or utility helpers.
+metadata:
+  dependencies:
+    - joktec-framework-skill
 ---
 
 # JokTec Common Skill

package/skills/joktec-database-extended-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-database-extended-skill
 description: Use when working with extended JokTec database packages @joktec/elastic, @joktec/arango, or @joktec/bigquery in a consumer app, including app-neutral client setup, config-driven lifecycle, and package-specific query/service usage.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Extended Database Skill

package/skills/joktec-integration-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-integration-skill
 description: Use when wiring or using JokTec integration packages @joktec/firebase or @joktec/gpt, including validated config, SDK client lifecycle, app-neutral integration services, credentials handling, and consumer app composition.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Integration Skill

package/skills/joktec-mongo-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-mongo-skill
 description: Use when working with @joktec/mongo in a consumer app, including MongoModule setup, Typegoose schema decorators, MongoRepo, MongoService, MongoHelper, plugins, ObjectId/query safety, soft delete, strict references, and cursor pagination.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Mongo Skill

package/skills/joktec-mysql-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-mysql-skill
 description: Use when working with @joktec/mysql in a consumer app, including MysqlModule setup, TypeORM entities, schema-first @Column/@PrimaryColumn decorators, MysqlRepo, MysqlService, transactions, dialect support, uuidv7 ids, query safety, and cursor pagination.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec MySQL Skill

package/skills/joktec-tool-skill/SKILL.md

@@ -1,6 +1,10 @@
 ---
 name: joktec-tool-skill
 description: Use when wiring or using JokTec tool packages @joktec/http, @joktec/file, or @joktec/alert, including Axios-backed HTTP clients, file classification helpers, Slack-compatible alert webhooks, config-driven lifecycle, and app-neutral utility services.
+metadata:
+  dependencies:
+    - joktec-framework-skill
+    - joktec-common-skill
 ---
 
 # JokTec Tool Skill