ai-developer-skill-os 7.0.2 → 7.5.1

package/bin/install.js

@@ -15,8 +15,13 @@ function copyRecursiveSync(src, dest) {
   const exists = fs.existsSync(src);
   const stats = exists && fs.statSync(src);
   const isDirectory = exists && stats.isDirectory();
-  
+
   if (isDirectory) {
+    const dirName = path.basename(src);
+    if (dirName.startsWith('_')) {
+      return;
+    }
+
     if (!fs.existsSync(dest)) {
       fs.mkdirSync(dest, { recursive: true });
     }
@@ -69,7 +74,7 @@ function ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloComman
   }
 
   const skillPaths = [kiloSkillsDir];
-  if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {
+  if (!kiloConfig.skills || typeof kiloConfig.skills !== 'object' || !Array.isArray(kiloConfig.skills.paths)) {
     kiloConfig.skills = { paths: skillPaths };
   } else {
     const exists = kiloConfig.skills.paths.some(p => path.resolve(p) === path.resolve(kiloSkillsDir));
@@ -82,38 +87,53 @@ function ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloComman
   return kiloJsonPath;
 }
 
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-
-console.log('🚀 Đang chuẩn bị cài đặt AI Developer Skill OS...\n');
-
-const questionIde = `Vui lòng chọn IDE/AI Assistant bạn đang sử dụng:
-(1) Cursor
-(2) Windsurf
-(3) Cline / Roo Code
-(4) Antigravity / Gemini
-(5) Codex
-(6) Kilo Code
-(7) Tất cả các IDE (Multi-IDE)
-(0) Bỏ qua (Không tạo config tự động)
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const parsed = { ide: null, scope: null };
+  for (const arg of args) {
+    if (arg.startsWith('--ide=')) parsed.ide = arg.split('=')[1];
+    if (arg.startsWith('--scope=')) parsed.scope = arg.split('=')[1];
+  }
 
-Nhập số (0-7): `;
+  const aliasMap = {
+    'antigravity': '4',
+    'gemini': '4',
+    'cursor': '1',
+    'windsurf': '2',
+    'claude': '3',
+    'cliner': '3',
+    'roo': '3',
+    'codex': '5',
+    'kilo': '6',
+    'multi-ide': '7',
+    'all': '7'
+  };
+
+  if (parsed.ide && aliasMap[parsed.ide.toLowerCase()]) {
+    parsed.ide = aliasMap[parsed.ide.toLowerCase()];
+  }
 
-const questionScope = `
-Bạn muốn cài đặt bộ kỹ năng ở đâu?
-(1) Local  (Gắn vào dự án hiện tại - Phù hợp làm việc nhóm)
-(2) Global (Cài vào máy tính dùng chung cho mọi dự án - Dành cho cá nhân)
+  if (args.includes('--antigravity')) {
+    parsed.ide = '4';
+    if (!parsed.scope) parsed.scope = '2';
+  }
+  if (args.includes('--cursor')) {
+    parsed.ide = '1';
+    if (!parsed.scope) parsed.scope = '2';
+  }
+  if (args.includes('--kilo')) {
+    parsed.ide = '6';
+    if (!parsed.scope) parsed.scope = '2';
+  }
 
-Nhập số (1-2): `;
+  return parsed;
+}
 
-rl.question(questionIde, (answerIde) => {
+function runInstall(ideCode, answerScope) {
   let isGemini = false;
   let isKilo = false;
   let isMultiIde = false;
   let ruleFileName = null;
-  const ideCode = answerIde.trim();
 
   switch(ideCode) {
     case '1': ruleFileName = '.cursorrules'; break;
@@ -126,70 +146,69 @@ rl.question(questionIde, (answerIde) => {
     case '0': default: break;
   }
 
-  rl.question(questionScope, (answerScope) => {
-    const isGlobal = answerScope.trim() === '2';
-    
-    const homeDir = os.homedir();
-    const cwd = process.cwd();
-    let targetDir = '';
-    let ruleFilePath = null;
-    let baseFolderForPrompt = '';
-    let kiloJsonPath = null;
-    let kiloSkillsDir = null;
-    let kiloThemesDir = null;
-    let kiloCommandsDir = null;
-
-    if (isMultiIde) {
+  const isGlobal = answerScope.trim() === '2';
+
+  const homeDir = os.homedir();
+  const cwd = process.cwd();
+  let targetDir = '';
+  let ruleFilePath = null;
+  let baseFolderForPrompt = '';
+  let kiloJsonPath = null;
+  let kiloSkillsDir = null;
+  let kiloThemesDir = null;
+  let kiloCommandsDir = null;
+
+  if (isMultiIde) {
+    targetDir = path.join(cwd, '.qk-ai-skill-os');
+    baseFolderForPrompt = './.qk-ai-skill-os';
+    ruleFilePath = path.join(cwd, 'CLAUDE.md');
+    if (!isGlobal) {
+      kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
+      kiloThemesDir = path.join(cwd, '.kilo', 'themes');
+      kiloCommandsDir = path.join(cwd, '.kilo', 'command');
+      kiloJsonPath = path.join(cwd, 'kilo.json');
+    }
+  } else if (isGemini) {
+    if (isGlobal) {
+      targetDir = path.join(homeDir, '.gemini', 'config');
+      ruleFilePath = path.join(targetDir, 'AGENTS.md');
+      baseFolderForPrompt = path.join(targetDir, 'skills').replace(/\\/g, '/');
+    } else {
+      targetDir = path.join(cwd, '.agents');
+      ruleFilePath = path.join(cwd, '.agents', 'AGENTS.md');
+      baseFolderForPrompt = '.agents/skills';
+    }
+  } else if (isKilo) {
+    if (isGlobal) {
+      targetDir = path.join(homeDir, '.qk-ai-skill-os');
+      baseFolderForPrompt = targetDir.replace(/\\/g, '/');
+      kiloSkillsDir = path.join(homeDir, '.kilo', 'skills');
+      kiloThemesDir = path.join(homeDir, '.config', 'kilo', 'themes');
+      kiloCommandsDir = path.join(homeDir, '.config', 'kilo', 'command');
+      kiloJsonPath = path.join(homeDir, '.config', 'kilo', 'kilo.json');
+    } else {
       targetDir = path.join(cwd, '.qk-ai-skill-os');
       baseFolderForPrompt = './.qk-ai-skill-os';
-      ruleFilePath = path.join(cwd, 'CLAUDE.md');
-      if (!isGlobal) {
-        kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
-        kiloThemesDir = path.join(cwd, '.kilo', 'themes');
-        kiloCommandsDir = path.join(cwd, '.kilo', 'command');
-        kiloJsonPath = path.join(cwd, 'kilo.json');
-      }
-    } else if (isGemini) {
-      if (isGlobal) {
-        targetDir = path.join(homeDir, '.gemini', 'config');
-        ruleFilePath = path.join(targetDir, 'AGENTS.md');
-        baseFolderForPrompt = path.join(targetDir, 'skills').replace(/\\/g, '/');
-      } else {
-        targetDir = path.join(cwd, '.agents');
-        ruleFilePath = path.join(cwd, '.agents', 'AGENTS.md');
-        baseFolderForPrompt = '.agents/skills';
-      }
-    } else if (isKilo) {
-      if (isGlobal) {
-        targetDir = path.join(homeDir, '.qk-ai-skill-os');
-        baseFolderForPrompt = targetDir.replace(/\\/g, '/');
-        kiloSkillsDir = path.join(homeDir, '.kilo', 'skills');
-        kiloThemesDir = path.join(homeDir, '.config', 'kilo', 'themes');
-        kiloCommandsDir = path.join(homeDir, '.config', 'kilo', 'command');
-        kiloJsonPath = path.join(homeDir, '.config', 'kilo', 'kilo.json');
-      } else {
-        targetDir = path.join(cwd, '.qk-ai-skill-os');
-        baseFolderForPrompt = './.qk-ai-skill-os';
-        kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
-        kiloThemesDir = path.join(cwd, '.kilo', 'themes');
-        kiloCommandsDir = path.join(cwd, '.kilo', 'command');
-        kiloJsonPath = path.join(cwd, 'kilo.json');
-      }
-      ruleFilePath = path.join(cwd, 'CLAUDE.md');
+      kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
+      kiloThemesDir = path.join(cwd, '.kilo', 'themes');
+      kiloCommandsDir = path.join(cwd, '.kilo', 'command');
+      kiloJsonPath = path.join(cwd, 'kilo.json');
+    }
+    ruleFilePath = path.join(cwd, 'CLAUDE.md');
+  } else {
+    if (isGlobal) {
+      targetDir = path.join(homeDir, '.qk-ai-skill-os');
+      baseFolderForPrompt = targetDir.replace(/\\/g, '/');
     } else {
-      if (isGlobal) {
-        targetDir = path.join(homeDir, '.qk-ai-skill-os');
-        baseFolderForPrompt = targetDir.replace(/\\/g, '/');
-      } else {
-        targetDir = path.join(cwd, '.qk-ai-skill-os');
-        baseFolderForPrompt = './.qk-ai-skill-os';
-      }
-      if (ruleFileName) {
-        ruleFilePath = path.join(cwd, ruleFileName);
-      }
+      targetDir = path.join(cwd, '.qk-ai-skill-os');
+      baseFolderForPrompt = './.qk-ai-skill-os';
+    }
+    if (ruleFileName) {
+      ruleFilePath = path.join(cwd, ruleFileName);
     }
+  }
 
-    const systemPrompt = `[Role]
+  const systemPrompt = `[Role]
 You are an elite AI Software Engineer. You must strictly follow the rules in this project.
 Vui lòng tìm đọc danh sách kỹ năng tại file \`${baseFolderForPrompt}/skills.json\`.
 
@@ -202,7 +221,7 @@ Khi nhận được lệnh kỹ năng, bạn BẮT BUỘC phải:
 2. TỰ ĐỘNG THỰC THI (End-to-End): Dùng các tools của bạn (đọc file, sửa code, chạy lệnh) để tự động hoàn thành 100% mục tiêu được giao. KHÔNG ĐƯỢC dừng lại để hỏi ý kiến trừ khi gặp lỗi chí mạng hoặc requirement quá mập mờ.
 3. BÁO CÁO KẾT QUẢ: Sau khi hoàn tất sửa code, LUÔN trả về báo cáo theo đúng format markdown dưới đây:
 
-\\\`\\\`\\\`markdown
+\`\`\`markdown
 🔧 <Tên Kỹ Năng> Summary
 ─────────────────────────────────────────────────
 Scope:        [Tóm tắt ngắn gọn phạm vi công việc]
@@ -223,114 +242,150 @@ Changes applied:
 
 ⚠️ Notes:
   [Các lưu ý đặc biệt, rủi ro tiềm ẩn hoặc cách người dùng có thể test lại tính năng này]
-\\\`\\\`\\\`
+\`\`\`
 
 [Command Arguments]
-Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: \`./qk-ui-builder --fw=react --css=tailwind\`). 
+Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: \`./qk-ui-builder --fw=react --css=tailwind\`).
 Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải tuân thủ tuyệt đối các công nghệ/yêu cầu được chỉ định trong tham số đó thay vì dùng mặc định.`;
 
-    try {
-      if (!fs.existsSync(targetDir)) {
-        fs.mkdirSync(targetDir, { recursive: true });
-      }
+  try {
+    if (!fs.existsSync(targetDir)) {
+      fs.mkdirSync(targetDir, { recursive: true });
+    }
 
-      const targetSkillsDir = path.join(targetDir, 'skills');
-      cleanOldSkills(targetSkillsDir, isGemini && isGlobal);
+    const targetSkillsDir = path.join(targetDir, 'skills');
+    cleanOldSkills(targetSkillsDir, isGemini && isGlobal);
 
-      const filesAndFolders = [
-        'skills', '_template', 'docs', 'skills.json', 'README.md', 'CHANGELOG.md', 'LICENSE'
-      ];
+    const filesAndFolders = [
+      'skills', '_template', 'docs', 'skills.json', 'README.md', 'CHANGELOG.md', 'LICENSE'
+    ];
 
-      if (isGemini && isGlobal) {
-        if (fs.existsSync(path.join(sourceDir, 'skills'))) {
-          copyRecursiveSync(path.join(sourceDir, 'skills'), path.join(targetDir, 'skills'));
-        }
-        if (fs.existsSync(path.join(sourceDir, 'skills.json'))) {
-          fs.copyFileSync(path.join(sourceDir, 'skills.json'), path.join(targetDir, 'skills', 'skills.json'));
-        }
-      } else {
-        filesAndFolders.forEach(item => {
-          const src = path.join(sourceDir, item);
-          let dest = path.join(targetDir, item);
-          if (fs.existsSync(src)) {
-            copyRecursiveSync(src, dest);
-          }
-        });
+    if (isGemini && isGlobal) {
+      if (fs.existsSync(path.join(sourceDir, 'skills'))) {
+        copyRecursiveSync(path.join(sourceDir, 'skills'), path.join(targetDir, 'skills'));
       }
-
-      if (ruleFilePath) {
-        const ruleDir = path.dirname(ruleFilePath);
-        if (ruleDir !== cwd && !fs.existsSync(ruleDir)) {
-          fs.mkdirSync(ruleDir, { recursive: true });
+      if (fs.existsSync(path.join(sourceDir, 'skills.json'))) {
+        fs.copyFileSync(path.join(sourceDir, 'skills.json'), path.join(targetDir, 'skills', 'skills.json'));
+      }
+    } else {
+      filesAndFolders.forEach(item => {
+        const src = path.join(sourceDir, item);
+        let dest = path.join(targetDir, item);
+        if (fs.existsSync(src)) {
+          copyRecursiveSync(src, dest);
         }
+      });
+    }
 
-        let writeContent = systemPrompt;
-        if (isGemini) {
-          writeContent = `\n<RULE[ai_skill_os]>\n---\ntrigger: always_on\n---\n${systemPrompt}\n</RULE[ai_skill_os]>\n`;
-        }
+    if (ruleFilePath) {
+      const ruleDir = path.dirname(ruleFilePath);
+      if (ruleDir !== cwd && !fs.existsSync(ruleDir)) {
+        fs.mkdirSync(ruleDir, { recursive: true });
+      }
+
+      let writeContent = systemPrompt;
+      if (isGemini) {
+        writeContent = `\n<RULE[ai_skill_os]>\n---\ntrigger: always_on\n---\n${systemPrompt}\n</RULE[ai_skill_os]>\n`;
+      }
 
-        if (fs.existsSync(ruleFilePath)) {
-          const existingContent = fs.readFileSync(ruleFilePath, 'utf8');
-          const marker = isGemini ? '<RULE[ai_skill_os]>' : '[Role]\nYou are an elite AI Software Engineer.';
-          const markerIndex = existingContent.indexOf(marker);
-          if (markerIndex !== -1) {
-            const before = existingContent.substring(0, markerIndex);
-            const after = existingContent.substring(markerIndex).split('\n').slice(isGemini ? 2 : 1).join('\n');
-            const lastMarkerEnd = after.indexOf(isGemini ? '</RULE[ai_skill_os]>' : '[Trigger Mechanism]');
-            const actualAfter = lastMarkerEnd !== -1 ? after.substring(lastMarkerEnd + (isGemini ? 19 : 18)).trimStart() : after;
-            fs.writeFileSync(ruleFilePath, before + writeContent.trimStart() + (actualAfter ? '\n' + actualAfter : '') + '\n');
-            console.log(`✅ Đã CẬP NHẬT cấu hình tự động trong file: ${ruleFilePath}`);
-          } else {
-            fs.appendFileSync(ruleFilePath, "\n\n" + writeContent);
-            console.log(`✅ Đã GHI THÊM cấu hình tự động vào file: ${ruleFilePath}`);
-          }
+      if (fs.existsSync(ruleFilePath)) {
+        const existingContent = fs.readFileSync(ruleFilePath, 'utf8');
+        const marker = isGemini ? '<RULE[ai_skill_os]>' : '[Role]\nYou are an elite AI Software Engineer.';
+        const markerIndex = existingContent.indexOf(marker);
+        if (markerIndex !== -1) {
+          const before = existingContent.substring(0, markerIndex);
+          const after = existingContent.substring(markerIndex).split('\n').slice(isGemini ? 2 : 1).join('\n');
+          const lastMarkerEnd = after.indexOf(isGemini ? '</RULE[ai_skill_os]>' : '[Trigger Mechanism]');
+          const actualAfter = lastMarkerEnd !== -1 ? after.substring(lastMarkerEnd + (isGemini ? 19 : 18)).trimStart() : after;
+          fs.writeFileSync(ruleFilePath, before + writeContent.trimStart() + (actualAfter ? '\n' + actualAfter : '') + '\n');
+          console.log(`✅ Đã CẬP NHẬT cấu hình tự động trong file: ${ruleFilePath}`);
         } else {
-          fs.writeFileSync(ruleFilePath, writeContent);
-          console.log(`✅ Đã TẠO MỚI file cấu hình: ${ruleFilePath}`);
+          fs.appendFileSync(ruleFilePath, "\n\n" + writeContent);
+          console.log(`✅ Đã GHI THÊM cấu hình tự động vào file: ${ruleFilePath}`);
         }
+      } else {
+        fs.writeFileSync(ruleFilePath, writeContent);
+        console.log(`✅ Đã TẠO MỚI file cấu hình: ${ruleFilePath}`);
       }
+    }
 
-      if (isKilo) {
+    if (isKilo) {
+      ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
+      console.log(`✅ Đã cấu hình Kilo Code tại: ${kiloJsonPath}`);
+      console.log(`   → Skills: ${kiloSkillsDir}`);
+      console.log(`   → Themes: ${kiloThemesDir}`);
+      console.log(`   → Commands: ${kiloCommandsDir}`);
+    }
+
+    if (isMultiIde) {
+      if (kiloJsonPath && kiloSkillsDir) {
         ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
-        console.log(`✅ Đã cấu hình Kilo Code tại: ${kiloJsonPath}`);
+        console.log(`✅ Đã cấu hình Kilo Code (Multi-IDE) tại: ${kiloJsonPath}`);
         console.log(`   → Skills: ${kiloSkillsDir}`);
         console.log(`   → Themes: ${kiloThemesDir}`);
         console.log(`   → Commands: ${kiloCommandsDir}`);
+      } else if (ruleFilePath) {
+        console.log(`✅ Đã tạo file cấu hình Multi-IDE: ${ruleFilePath}`);
       }
+    }
 
-      if (isMultiIde) {
-        if (kiloJsonPath && kiloSkillsDir) {
-          ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
-          console.log(`✅ Đã cấu hình Kilo Code (Multi-IDE) tại: ${kiloJsonPath}`);
-          console.log(`   → Skills: ${kiloSkillsDir}`);
-          console.log(`   → Themes: ${kiloThemesDir}`);
-          console.log(`   → Commands: ${kiloCommandsDir}`);
-        } else if (ruleFilePath) {
-          console.log(`✅ Đã tạo file cấu hình Multi-IDE: ${ruleFilePath}`);
-        }
-      }
+    console.log(`\n🎉 HOÀN TẤT! Dữ liệu kỹ năng đã được lưu tại: ${targetDir}`);
+    if (isGlobal && !isGemini) {
+      const name = ruleFilePath ? path.basename(ruleFilePath) : 'CLAUDE.md';
+      console.log(`💡 Lưu ý: Kỹ năng đã được cài ở cấp độ máy tính (Global). File cấu hình cục bộ (${name}) ở dự án này đang trỏ thẳng về thư mục Global đó.`);
+    } else if (isGlobal && isGemini) {
+      console.log(`💡 Lưu ý: Antigravity đã được cài Global. Từ nay bạn mở BẤT KỲ DỰ ÁN NÀO trên máy tính này, Antigravity cũng sẽ tự động có đủ 22 kỹ năng mà không cần cài lại!`);
+    } else if (isKilo) {
+      console.log(`💡 Lưu ý: Kilo Code đã sẵn sàng. Dùng \`<leader>t\` hoặc \`/themes\` để xem, và \`/skills\` để xem danh sách skill đã cài.`);
+    }
 
-      console.log(`\n🎉 HOÀN TẤT! Dữ liệu kỹ năng đã được lưu tại: ${targetDir}`);
-      if (isGlobal && !isGemini) {
-        const name = ruleFilePath ? path.basename(ruleFilePath) : 'CLAUDE.md';
-        console.log(`💡 Lưu ý: Kỹ năng đã được cài ở cấp độ máy tính (Global). File cấu hình cục bộ (${name}) ở dự án này đang trỏ thẳng về thư mục Global đó.`);
-      } else if (isGlobal && isGemini) {
-        console.log(`💡 Lưu ý: Antigravity đã được cài Global. Từ nay bạn mở BẤT KỲ DỰ ÁN NÀO trên máy tính này, Antigravity cũng sẽ tự động có đủ 23 kỹ năng mà không cần cài lại!`);
-      } else if (isKilo) {
-        console.log(`💡 Lưu ý: Kilo Code đã sẵn sàng. Dùng \`<leader>t\` hoặc \`/themes\` để xem, và \`/skills\` để xem danh sách skill đã cài.`);
+    if (!isGemini && !isKilo && !isMultiIde) {
+      if (fs.existsSync(path.join(cwd, '.kilorules'))) {
+        fs.unlinkSync(path.join(cwd, '.kilorules'));
+        console.log(`🧹 Đã xoá file .kilorules cũ (không còn cần thiết).`);
       }
+    }
 
-      if (!isGemini && !isKilo && !isMultiIde) {
-        if (fs.existsSync(path.join(cwd, '.kilorules'))) {
-          fs.unlinkSync(path.join(cwd, '.kilorules'));
-          console.log(`🧹 Đã xoá file .kilorules cũ (không còn cần thiết).`);
-        }
-      }
+  } catch (error) {
+    console.error('❌ Có lỗi xảy ra trong quá trình cài đặt:', error.message);
+  }
+}
 
-    } catch (error) {
-      console.error('❌ Có lỗi xảy ra trong quá trình cài đặt:', error.message);
-    } finally {
+const args = parseArgs();
+
+if (args.ide !== null && args.scope !== null) {
+  runInstall(args.ide, args.scope);
+} else {
+  console.log('🚀 Đang chuẩn bị cài đặt AI Developer Skill OS...\n');
+
+  const questionIde = `Vui lòng chọn IDE/AI Assistant bạn đang sử dụng:
+(1) Cursor
+(2) Windsurf
+(3) Cline / Roo Code
+(4) Antigravity / Gemini
+(5) Codex
+(6) Kilo Code
+(7) Tất cả các IDE (Multi-IDE)
+(0) Bỏ qua (Không tạo config tự động)
+
+Nhập số (0-7): `;
+
+  const questionScope = `
+Bạn muốn cài đặt bộ kỹ năng ở đâu?
+(1) Local  (Gắn vào dự án hiện tại - Phù hợp làm việc nhóm)
+(2) Global (Cài vào máy tính dùng chung cho mọi dự án - Dành cho cá nhân)
+
+Nhập số (1-2): `;
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  rl.question(questionIde, (answerIde) => {
+    rl.question(questionScope, (answerScope) => {
       rl.close();
-    }
+      runInstall(answerIde.trim(), answerScope.trim());
+    });
   });
-});
+}

package/bin/lint.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import matter from 'gray-matter';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const skillsDir = path.join(__dirname, '..', 'skills');
+
+const REQUIRED_FOR_ALL = [
+  'Preconditions',
+  'Scope',
+  'Non-Goals',
+  'Exit Codes',
+  'Handoff Contract'
+];
+
+const REQUIRED_FOR_ACTION = [
+  'Workflow',
+  'Confidence Model',
+  'Evidence Format',
+  'Escalation Rules'
+];
+
+const REQUIRED_FOR_EXECUTION = [
+  'Priority Order',
+  'Severity',
+  'Retry Policy'
+];
+
+const ACTION_SKILLS = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-fe-api-integration', 'qk-api-lifecycle', 'qk-data-lifecycle', 'qk-db-optimizer', 'qk-ui-builder', 'qk-ui-system-builder', 'qk-access-policy', 'qk-ai-builder', 'qk-system-evolution', 'qk-production-release', 'qk-project-bootstrap'];
+const EXECUTION_SKILLS = ['qk-bug-resolution', 'qk-feature-delivery', 'qk-fe-api-integration', 'qk-api-lifecycle', 'qk-data-lifecycle', 'qk-db-optimizer', 'qk-ui-builder', 'qk-ui-system-builder', 'qk-access-policy', 'qk-ai-builder', 'qk-system-evolution', 'qk-production-release', 'qk-project-bootstrap', 'qk-engineering-standard', 'qk-validation-gate', 'qk-ui-audit', 'qk-project-health'];
+
+const SKIP_LINT = ['qk-help'];
+
+let hasErrors = false;
+
+function lintSkill(skillPath, skillName) {
+  if (SKIP_LINT.includes(skillName)) {
+    console.log(`⏭️  [${skillName}] Skipped (reference skill)`);
+    return;
+  }
+
+  const content = fs.readFileSync(skillPath, 'utf8');
+
+  let parsed;
+  try {
+    parsed = matter(content);
+  } catch (e) {
+    console.error(`❌ [${skillName}] Frontmatter parsing failed: ${e.message}`);
+    hasErrors = true;
+    return;
+  }
+
+  const frontmatter = parsed.data;
+
+  const requiredFrontmatter = ['name', 'category', 'version', 'description', 'platforms', 'execution_mode', 'cost', 'latency', 'risk', 'side_effects', 'produces', 'consumes', 'token_budget', 'exit_codes', 'schema_version', 'runtime_version', 'skill_version'];
+
+  for (const field of requiredFrontmatter) {
+    if (frontmatter[field] === undefined) {
+      console.error(`❌ [${skillName}] Missing frontmatter field: ${field}`);
+      hasErrors = true;
+    }
+  }
+
+  const validPlatforms = ['antigravity', 'claude-code', 'cursor', 'windsurf', 'kilo-code'];
+  if (Array.isArray(frontmatter.platforms)) {
+    for (const p of frontmatter.platforms) {
+      if (!validPlatforms.includes(p)) {
+        console.error(`❌ [${skillName}] Invalid platform: ${p}`);
+        hasErrors = true;
+      }
+    }
+  }
+
+  if (!content.includes('> **Language rule:**')) {
+    console.error(`❌ [${skillName}] Missing Language Rule declaration.`);
+    hasErrors = true;
+  }
+
+  const body = parsed.content;
+  const required = [...REQUIRED_FOR_ALL];
+  if (ACTION_SKILLS.includes(skillName)) {
+    required.push(...REQUIRED_FOR_ACTION);
+  }
+  if (EXECUTION_SKILLS.includes(skillName)) {
+    required.push(...REQUIRED_FOR_EXECUTION);
+  }
+
+  for (const section of required) {
+    const headingRegex = new RegExp(`^##\\s+${section}\\b`, 'm');
+    if (!headingRegex.test(body)) {
+      console.error(`❌ [${skillName}] Missing section: ## ${section}`);
+      hasErrors = true;
+    }
+  }
+}
+
+console.log('🔍 Running V7.5 Skill Schema Linting...');
+
+const items = fs.readdirSync(skillsDir);
+for (const item of items) {
+  if (item === '_template' || item === 'qk-policy-engine') continue;
+
+  const skillDir = path.join(skillsDir, item);
+  if (fs.statSync(skillDir).isDirectory() && item.startsWith('qk-')) {
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (fs.existsSync(skillMdPath)) {
+      lintSkill(skillMdPath, item);
+    }
+  }
+}
+
+if (hasErrors) {
+  console.error('\n💥 Linting failed. One or more skills do not comply with the V7.5 Runtime Standard.');
+  process.exit(1);
+} else {
+  console.log('\n✅ All skills comply with V7.5 Runtime Standard!');
+  process.exit(0);
+}
+