agent-skills-standard 1.3.0 → 1.3.1

package/README.md

@@ -39,7 +39,7 @@ You can run the tool instantly without installing, or install it globally for co
 
 ```bash
 # Use instantly (Recommended)
-npx agent-skills-standard sync
+npx agent-skills-standard@latest sync
 
 # Or install globally
 npm install -g agent-skills-standard
@@ -57,7 +57,7 @@ ags sync
 Run this once to detect your project type and choose which "skills" you want your AI to have.
 
 ```bash
-npx agent-skills-standard init
+npx agent-skills-standard@latest init
 ```
 
 ### 2. Boost Your AI
@@ -65,7 +65,7 @@ npx agent-skills-standard init
 Run this to fetch the latest high-density instructions and install them into your hidden agent folders (like `.cursor/skills/` or `.github/skills/`).
 
 ```bash
-npx agent-skills-standard sync
+npx agent-skills-standard@latest sync
 
 ```
 
@@ -101,6 +101,7 @@ skills:
 - **🚀 High-Density Instructions**: Optimized syntax that is **40% more compact** than standard English.
 - **🛡️ Universal Support**: Works out-of-the-box with Cursor, Claude, GitHub Copilot, and more.
 - **🔒 Secure Protection**: Mark specific files as "Locked" (overrides) so the CLI never changes your custom tweaks.
+- **🧪 Production-Grade Reliability**: Guarded by a 100% statement coverage test suite and strict CI enforcement.
 
 ---
 

package/dist/commands/init.js

@@ -25,8 +25,7 @@ class InitCommand {
         const agentDetection = await this.detectionService.detectAgents();
         const anyAgentDetected = Object.values(agentDetection).some((d) => d);
         const shouldCheck = (id) => anyAgentDetected ? agentDetection[id] : true;
-        const defaultRegistry = 'https://github.com/HoangNguyen0403/agent-skills-standard';
-        const { categories: supportedCategories, metadata } = await this.registryService.discoverRegistry(defaultRegistry);
+        const { categories: supportedCategories, metadata } = await this.registryService.discoverRegistry(constants_1.DEFAULT_REGISTER);
         const choices = constants_1.SUPPORTED_FRAMEWORKS.map((f) => ({
             name: supportedCategories.includes(f.id)
                 ? f.name
@@ -70,17 +69,14 @@ class InitCommand {
                 type: 'input',
                 name: 'registry',
                 message: 'Skills Registry URL:',
-                default: defaultRegistry,
+                default: constants_1.DEFAULT_REGISTER,
             },
         ]);
-        const framework = answers.framework;
-        if (!supportedCategories.includes(framework)) {
-            console.log(picocolors_1.default.yellow(`\nNotice: Skills for ${framework} are not yet strictly defined and will be added soon.`));
-            console.log(picocolors_1.default.gray('The CLI will still generate rule files with global standards.\n'));
-        }
-        const config = this.configService.buildInitialConfig(framework, answers.agents, answers.registry, metadata);
+        const frameworkId = answers.framework;
+        const frameworkDef = constants_1.SUPPORTED_FRAMEWORKS.find((f) => f.id === frameworkId);
+        const config = this.configService.buildInitialConfig(frameworkId, answers.agents, answers.registry, metadata, frameworkDef?.languages || []);
         const projectDeps = await this.detectionService.getProjectDeps();
-        this.configService.applyDependencyExclusions(config, framework, projectDeps);
+        this.configService.applyDependencyExclusions(config, frameworkId, projectDeps);
         const commentHeader = `# Auto-detected configuration generated by agent-skills-standard init
 #
 # Presence in 'skills' list = Active. To disable a skill, remove it from the list.
@@ -92,7 +88,7 @@ class InitCommand {
 `;
         await fs_extra_1.default.writeFile(configPath, commentHeader + js_yaml_1.default.dump(config));
         console.log(picocolors_1.default.green('\n✅ Initialized .skillsrc with your preferences!'));
-        console.log(picocolors_1.default.gray(`   Selected framework: ${framework}`));
+        console.log(picocolors_1.default.gray(`   Selected framework: ${frameworkId}`));
         console.log(picocolors_1.default.cyan('\nNext step: Run `agent-skills-standard sync` to generate rule files.'));
     }
 }

package/dist/constants/enums.d.ts

@@ -0,0 +1,21 @@
+export declare enum Agent {
+    Cursor = "cursor",
+    Trae = "trae",
+    Claude = "claude",
+    Copilot = "copilot",
+    Antigravity = "antigravity",
+    OpenAI = "openai",
+    OpenCode = "opencode",
+    Gemini = "gemini",
+    Roo = "roo",
+    Windsurf = "windsurf"
+}
+export declare enum Framework {
+    Flutter = "flutter",
+    NestJS = "nestjs",
+    Golang = "golang",
+    NextJS = "nextjs",
+    React = "react",
+    ReactNative = "react-native",
+    Angular = "angular"
+}

package/dist/constants/enums.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Framework = exports.Agent = void 0;
+var Agent;
+(function (Agent) {
+    Agent["Cursor"] = "cursor";
+    Agent["Trae"] = "trae";
+    Agent["Claude"] = "claude";
+    Agent["Copilot"] = "copilot";
+    Agent["Antigravity"] = "antigravity";
+    Agent["OpenAI"] = "openai";
+    Agent["OpenCode"] = "opencode";
+    Agent["Gemini"] = "gemini";
+    Agent["Roo"] = "roo";
+    Agent["Windsurf"] = "windsurf";
+})(Agent || (exports.Agent = Agent = {}));
+var Framework;
+(function (Framework) {
+    Framework["Flutter"] = "flutter";
+    Framework["NestJS"] = "nestjs";
+    Framework["Golang"] = "golang";
+    Framework["NextJS"] = "nextjs";
+    Framework["React"] = "react";
+    Framework["ReactNative"] = "react-native";
+    Framework["Angular"] = "angular";
+})(Framework || (exports.Framework = Framework = {}));

package/dist/constants/index.d.ts

@@ -1,25 +1,7 @@
-export declare enum Agent {
-    Cursor = "cursor",
-    Trae = "trae",
-    Claude = "claude",
-    Copilot = "copilot",
-    Antigravity = "antigravity",
-    OpenAI = "openai",
-    OpenCode = "opencode",
-    Gemini = "gemini",
-    Roo = "roo",
-    Windsurf = "windsurf"
-}
-export declare enum Framework {
-    Flutter = "flutter",
-    NestJS = "nestjs",
-    Golang = "golang",
-    NextJS = "nextjs",
-    React = "react",
-    ReactNative = "react-native",
-    Angular = "angular"
-}
+import { Agent, Framework } from './enums';
+export { Agent, Framework };
 export declare const UNIVERSAL_SKILLS: string[];
+export declare const DEFAULT_REGISTER = "https://github.com/HoangNguyen0403/agent-skills-standard";
 export interface AgentDefinition {
     id: Agent;
     name: string;

package/dist/constants/index.js

@@ -1,96 +1,77 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKILL_DETECTION_REGISTRY = exports.SUPPORTED_FRAMEWORKS = exports.SUPPORTED_AGENTS = exports.getFrameworkDefinition = exports.getAgentDefinition = exports.UNIVERSAL_SKILLS = exports.Framework = exports.Agent = void 0;
-var Agent;
-(function (Agent) {
-    Agent["Cursor"] = "cursor";
-    Agent["Trae"] = "trae";
-    Agent["Claude"] = "claude";
-    Agent["Copilot"] = "copilot";
-    Agent["Antigravity"] = "antigravity";
-    Agent["OpenAI"] = "openai";
-    Agent["OpenCode"] = "opencode";
-    Agent["Gemini"] = "gemini";
-    Agent["Roo"] = "roo";
-    Agent["Windsurf"] = "windsurf";
-})(Agent || (exports.Agent = Agent = {}));
-var Framework;
-(function (Framework) {
-    Framework["Flutter"] = "flutter";
-    Framework["NestJS"] = "nestjs";
-    Framework["Golang"] = "golang";
-    Framework["NextJS"] = "nextjs";
-    Framework["React"] = "react";
-    Framework["ReactNative"] = "react-native";
-    Framework["Angular"] = "angular";
-})(Framework || (exports.Framework = Framework = {}));
+exports.SKILL_DETECTION_REGISTRY = exports.SUPPORTED_FRAMEWORKS = exports.SUPPORTED_AGENTS = exports.getFrameworkDefinition = exports.getAgentDefinition = exports.DEFAULT_REGISTER = exports.UNIVERSAL_SKILLS = exports.Framework = exports.Agent = void 0;
+const enums_1 = require("./enums");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return enums_1.Agent; } });
+Object.defineProperty(exports, "Framework", { enumerable: true, get: function () { return enums_1.Framework; } });
 exports.UNIVERSAL_SKILLS = ['common'];
+exports.DEFAULT_REGISTER = 'https://github.com/HoangNguyen0403/agent-skills-standard';
 const getAgentDefinition = (id) => {
     switch (id) {
-        case Agent.Cursor:
+        case enums_1.Agent.Cursor:
             return {
                 id,
                 name: 'Cursor',
                 path: '.cursor/skills',
                 detectionFiles: ['.cursor', '.cursorrules'],
             };
-        case Agent.Trae:
+        case enums_1.Agent.Trae:
             return {
                 id,
                 name: 'Trae',
                 path: '.trae/skills',
                 detectionFiles: ['.trae'],
             };
-        case Agent.Claude:
+        case enums_1.Agent.Claude:
             return {
                 id,
                 name: 'Claude Code',
                 path: '.claude/skills',
                 detectionFiles: ['.claude', 'CLAUDE.md'],
             };
-        case Agent.Copilot:
+        case enums_1.Agent.Copilot:
             return {
                 id,
                 name: 'GitHub Copilot',
                 path: '.github/skills',
                 detectionFiles: ['.github'],
             };
-        case Agent.Antigravity:
+        case enums_1.Agent.Antigravity:
             return {
                 id,
                 name: 'Antigravity',
                 path: '.agent/skills',
                 detectionFiles: ['.agent'],
             };
-        case Agent.OpenAI:
+        case enums_1.Agent.OpenAI:
             return {
                 id,
                 name: 'OpenAI',
                 path: '.codex/skills',
                 detectionFiles: ['.codex'],
             };
-        case Agent.OpenCode:
+        case enums_1.Agent.OpenCode:
             return {
                 id,
                 name: 'OpenCode',
                 path: '.opencode/skills',
                 detectionFiles: ['.opencode'],
             };
-        case Agent.Gemini:
+        case enums_1.Agent.Gemini:
             return {
                 id,
                 name: 'Gemini',
                 path: '.gemini/skills',
                 detectionFiles: ['.gemini'],
             };
-        case Agent.Roo:
+        case enums_1.Agent.Roo:
             return {
                 id,
                 name: 'Roo Code',
                 path: '.roo/skills',
                 detectionFiles: ['.roo'],
             };
-        case Agent.Windsurf:
+        case enums_1.Agent.Windsurf:
             return {
                 id,
                 name: 'Windsurf',
@@ -102,14 +83,14 @@ const getAgentDefinition = (id) => {
 exports.getAgentDefinition = getAgentDefinition;
 const getFrameworkDefinition = (id) => {
     switch (id) {
-        case Framework.Flutter:
+        case enums_1.Framework.Flutter:
             return {
                 id,
                 name: 'Flutter',
                 languages: ['dart'],
                 detectionFiles: ['pubspec.yaml'],
             };
-        case Framework.NestJS:
+        case enums_1.Framework.NestJS:
             return {
                 id,
                 name: 'NestJS',
@@ -117,14 +98,14 @@ const getFrameworkDefinition = (id) => {
                 detectionFiles: ['nest-cli.json'],
                 detectionDependencies: ['@nestjs/core'],
             };
-        case Framework.Golang:
+        case enums_1.Framework.Golang:
             return {
                 id,
                 name: 'Go (Golang)',
                 languages: ['go'],
                 detectionFiles: ['go.mod'],
             };
-        case Framework.NextJS:
+        case enums_1.Framework.NextJS:
             return {
                 id,
                 name: 'Next.js',
@@ -132,7 +113,7 @@ const getFrameworkDefinition = (id) => {
                 detectionFiles: ['next.config.js', 'next.config.mjs'],
                 detectionDependencies: ['next'],
             };
-        case Framework.React:
+        case enums_1.Framework.React:
             return {
                 id,
                 name: 'React',
@@ -140,7 +121,7 @@ const getFrameworkDefinition = (id) => {
                 detectionFiles: [],
                 detectionDependencies: ['react', 'react-dom'],
             };
-        case Framework.ReactNative:
+        case enums_1.Framework.ReactNative:
             return {
                 id,
                 name: 'React Native',
@@ -148,7 +129,7 @@ const getFrameworkDefinition = (id) => {
                 detectionFiles: ['metro.config.js'],
                 detectionDependencies: ['react-native'],
             };
-        case Framework.Angular:
+        case enums_1.Framework.Angular:
             return {
                 id,
                 name: 'Angular',
@@ -158,7 +139,7 @@ const getFrameworkDefinition = (id) => {
     }
 };
 exports.getFrameworkDefinition = getFrameworkDefinition;
-exports.SUPPORTED_AGENTS = Object.values(Agent).map(exports.getAgentDefinition);
-exports.SUPPORTED_FRAMEWORKS = Object.values(Framework).map(exports.getFrameworkDefinition);
+exports.SUPPORTED_AGENTS = Object.values(enums_1.Agent).map(exports.getAgentDefinition);
+exports.SUPPORTED_FRAMEWORKS = Object.values(enums_1.Framework).map(exports.getFrameworkDefinition);
 var skills_1 = require("./skills");
 Object.defineProperty(exports, "SKILL_DETECTION_REGISTRY", { enumerable: true, get: function () { return skills_1.SKILL_DETECTION_REGISTRY; } });

package/dist/constants/skills.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SKILL_DETECTION_REGISTRY = void 0;
-const index_1 = require("./index");
+const enums_1 = require("./enums");
 /**
  * Registry of automatic skill detection rules grouped by framework.
  */
 exports.SKILL_DETECTION_REGISTRY = {
-    [index_1.Framework.Flutter]: [
+    [enums_1.Framework.Flutter]: [
         {
             id: 'riverpod-state-management',
             packages: ['flutter_riverpod', 'riverpod'],
@@ -40,7 +40,7 @@ exports.SKILL_DETECTION_REGISTRY = {
             packages: ['retrofit'],
         },
     ],
-    [index_1.Framework.NestJS]: [
+    [enums_1.Framework.NestJS]: [
         {
             id: 'caching',
             packages: ['@nestjs/cache-manager', 'cache-manager'],

package/dist/index.js

@@ -10,7 +10,7 @@ const program = new commander_1.Command();
 program
     .name('agent-skills-standard')
     .description('A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.')
-    .version('1.3.0');
+    .version('1.3.1');
 program
     .command('init')
     .description('Initialize a .skillsrc configuration file interactively')

package/dist/scripts/calculate-tokens.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Token Metrics Calculator
+ * Calculates token costs for each skill category based on SKILL.md files.
+ * Uses character-based approximation: ~4 characters = 1 token (cl100k_base average)
+ */
+export {};

package/dist/scripts/calculate-tokens.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Token Metrics Calculator
+ * Calculates token costs for each skill category based on SKILL.md files.
+ * Uses character-based approximation: ~4 characters = 1 token (cl100k_base average)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path = __importStar(require("path"));
+const SKILLS_DIR = path.join(__dirname, '../../../skills');
+const METADATA_PATH = path.join(SKILLS_DIR, 'metadata.json');
+const CHARS_PER_TOKEN = 4; // Approximate ratio for cl100k_base tokenizer
+function calculateFileTokens(filePath) {
+    const content = fs_extra_1.default.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n').length;
+    const characters = content.length;
+    const tokens = Math.ceil(characters / CHARS_PER_TOKEN);
+    return { lines, characters, tokens };
+}
+function getSkillsInCategory(categoryPath) {
+    const skills = [];
+    if (!fs_extra_1.default.existsSync(categoryPath)) {
+        return skills;
+    }
+    const entries = fs_extra_1.default.readdirSync(categoryPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const skillMdPath = path.join(categoryPath, entry.name, 'SKILL.md');
+            if (fs_extra_1.default.existsSync(skillMdPath)) {
+                const metrics = calculateFileTokens(skillMdPath);
+                skills.push({
+                    skillName: entry.name,
+                    ...metrics,
+                });
+            }
+        }
+    }
+    return skills;
+}
+function calculateCategoryMetrics(skills) {
+    if (skills.length === 0) {
+        return {
+            totalSkills: 0,
+            totalLines: 0,
+            totalCharacters: 0,
+            totalTokens: 0,
+            avgTokensPerSkill: 0,
+            largestSkill: 'N/A',
+            largestSkillTokens: 0,
+        };
+    }
+    const totalSkills = skills.length;
+    const totalLines = skills.reduce((sum, s) => sum + s.lines, 0);
+    const totalCharacters = skills.reduce((sum, s) => sum + s.characters, 0);
+    const totalTokens = skills.reduce((sum, s) => sum + s.tokens, 0);
+    const avgTokensPerSkill = Math.round(totalTokens / totalSkills);
+    const largest = skills.reduce((max, s) => (s.tokens > max.tokens ? s : max), skills[0]);
+    return {
+        totalSkills,
+        totalLines,
+        totalCharacters,
+        totalTokens,
+        avgTokensPerSkill,
+        largestSkill: largest.skillName,
+        largestSkillTokens: largest.tokens,
+    };
+}
+async function main() {
+    console.log('📊 Calculating token metrics for skills...\n');
+    // Read existing metadata
+    const metadata = JSON.parse(fs_extra_1.default.readFileSync(METADATA_PATH, 'utf-8'));
+    // Get all categories
+    const categories = Object.keys(metadata.categories);
+    const results = {};
+    for (const category of categories) {
+        const categoryPath = path.join(SKILLS_DIR, category);
+        const skills = getSkillsInCategory(categoryPath);
+        const metrics = calculateCategoryMetrics(skills);
+        results[category] = metrics;
+        // Update metadata with token_metrics
+        metadata.categories[category].token_metrics = {
+            total_skills: metrics.totalSkills,
+            total_tokens: metrics.totalTokens,
+            avg_tokens_per_skill: metrics.avgTokensPerSkill,
+            largest_skill: `${metrics.largestSkill} (${metrics.largestSkillTokens} tokens)`,
+        };
+        console.log(`📦 ${category}:`);
+        console.log(`   Skills: ${metrics.totalSkills}`);
+        console.log(`   Total Tokens: ${metrics.totalTokens}`);
+        console.log(`   Avg/Skill: ${metrics.avgTokensPerSkill}`);
+        console.log(`   Largest: ${metrics.largestSkill} (${metrics.largestSkillTokens} tokens)`);
+        console.log('');
+    }
+    // Calculate grand total
+    const grandTotal = Object.values(results).reduce((sum, m) => sum + m.totalTokens, 0);
+    const totalSkills = Object.values(results).reduce((sum, m) => sum + m.totalSkills, 0);
+    console.log('═══════════════════════════════════════');
+    console.log(`📈 GRAND TOTAL: ${grandTotal} tokens across ${totalSkills} skills`);
+    console.log('═══════════════════════════════════════\n');
+    // Write updated metadata
+    fs_extra_1.default.writeFileSync(METADATA_PATH, JSON.stringify(metadata, null, 2) + '\n');
+    console.log('✅ Updated metadata.json with token_metrics');
+    // Update README.md table
+    const readmePath = path.join(__dirname, '../../../README.md');
+    if (fs_extra_1.default.existsSync(readmePath)) {
+        let readmeContent = fs_extra_1.default.readFileSync(readmePath, 'utf-8');
+        for (const category of categories) {
+            const metrics = results[category];
+            const version = metadata.categories[category].version;
+            // Find the row for this category (case-insensitive for emojis)
+            // Standardizes on the format: | **ICON Category** | Key Modules | Version | Skills | Avg. Footprint |
+            const regex = new RegExp(`(\\|\\s*\\*\\*.*${category}.*\\*\\*\\s*\\|.*\\|\\s*\`v?${version}\`\\s*\\|)\\s*\\d+\\s*\\|\\s*~?\\d+\\s*tokens\\s*\\|`, 'i');
+            const replacement = `$1 ${metrics.totalSkills}      | ~${metrics.avgTokensPerSkill} tokens    |`;
+            if (readmeContent.match(regex)) {
+                readmeContent = readmeContent.replace(regex, replacement);
+            }
+        }
+        fs_extra_1.default.writeFileSync(readmePath, readmeContent);
+        console.log('✅ Updated README.md support table');
+    }
+}
+main().catch(console.error);

package/dist/services/ConfigService.d.ts

@@ -3,6 +3,6 @@ import { RegistryMetadata } from '../models/types';
 export declare class ConfigService {
     loadConfig(cwd?: string): Promise<SkillConfig | null>;
     saveConfig(config: SkillConfig, cwd?: string): Promise<void>;
-    buildInitialConfig(framework: string, agents: string[], registry: string, metadata: Partial<RegistryMetadata>): SkillConfig;
+    buildInitialConfig(framework: string, agents: string[], registry: string, metadata: Partial<RegistryMetadata>, languages?: string[]): SkillConfig;
     applyDependencyExclusions(config: SkillConfig, framework: string, projectDeps: Set<string>): void;
 }

package/dist/services/ConfigService.js

@@ -44,7 +44,7 @@ class ConfigService {
         const configPath = path_1.default.join(cwd, '.skillsrc');
         await fs_extra_1.default.writeFile(configPath, js_yaml_1.default.dump(config));
     }
-    buildInitialConfig(framework, agents, registry, metadata) {
+    buildInitialConfig(framework, agents, registry, metadata, languages = []) {
         const skills = {};
         // Add main framework
         skills[framework] = {
@@ -52,6 +52,14 @@ class ConfigService {
                 ? `${metadata.categories[framework].tag_prefix || ''}${metadata.categories[framework].version}`
                 : 'main',
         };
+        // Add associated languages (e.g., typescript, javascript)
+        for (const lang of languages) {
+            if (metadata.categories?.[lang]) {
+                skills[lang] = {
+                    ref: `${metadata.categories[lang].tag_prefix || ''}${metadata.categories[lang].version}`,
+                };
+            }
+        }
         // Add common category if available
         if (metadata.categories?.['common']) {
             skills['common'] = {