universal-dev-standards 3.5.1-beta.7 → 3.5.1-beta.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "3.5.1-beta.7",
+  "version": "3.5.1-beta.9",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",

package/src/commands/check.js

@@ -17,7 +17,9 @@ import {
 import { downloadFromGitHub, getMarketplaceSkillsInfo } from '../utils/github.js';
 import {
   getInstalledSkillsInfoForAgent,
-  getInstalledCommandsForAgent
+  getInstalledCommandsForAgent,
+  installSkillsToMultipleAgents,
+  installCommandsToMultipleAgents
 } from '../utils/skills-installer.js';
 import {
   getAgentConfig,
@@ -245,7 +247,7 @@ export async function checkCommand(options = {}) {
   checkIntegrationFiles(manifest, projectPath, msg);
 
   // Skills status
-  displaySkillsStatus(manifest, projectPath, msg);
+  const { missingSkills, missingCommands } = displaySkillsStatus(manifest, projectPath, msg);
 
   // Coverage report
   displayCoverageReport(manifest, msg, common);
@@ -258,6 +260,12 @@ export async function checkCommand(options = {}) {
   } else {
     console.log(chalk.yellow(msg.issuesDetected));
   }
+
+  // Offer to install missing Skills/Commands if not in noInteractive mode
+  if ((missingSkills.length > 0 || missingCommands.length > 0) && !options.noInteractive) {
+    await promptSkillsCommandsInstallation(manifest, projectPath, missingSkills, missingCommands, msg);
+  }
+
   console.log();
 }
 
@@ -648,18 +656,21 @@ async function migrateToHashBasedTracking(projectPath, manifest) {
 }
 
 /**
- * Display skills status
+ * Display skills status and return missing Skills/Commands info
+ * @returns {{missingSkills: Array, missingCommands: Array}}
  */
 function displaySkillsStatus(manifest, projectPath, msg) {
   console.log(chalk.cyan(msg.skillsStatus));
 
   const aiTools = manifest.aiTools || [];
+  const missingSkills = [];
+  const missingCommands = [];
 
   // If no AI tools configured, show basic info
   if (aiTools.length === 0) {
     console.log(chalk.gray(`  ${msg.noAiToolsConfigured || 'No AI tools configured'}`));
     console.log();
-    return;
+    return { missingSkills, missingCommands };
   }
 
   // Check for Marketplace installation (Claude Code specific)
@@ -701,7 +712,10 @@ function displaySkillsStatus(manifest, projectPath, msg) {
     const projectSkillsInfo = getInstalledSkillsInfoForAgent(tool, 'project', projectPath);
     const userSkillsInfo = getInstalledSkillsInfoForAgent(tool, 'user', projectPath);
 
-    if (projectSkillsInfo?.installed || userSkillsInfo?.installed) {
+    // Check if using marketplace for Claude Code
+    const usingMarketplace = isMarketplace && tool === 'claude-code';
+
+    if (projectSkillsInfo?.installed || userSkillsInfo?.installed || usingMarketplace) {
       console.log(chalk.green(`    ✓ Skills ${msg.installed || 'installed'}:`));
       if (userSkillsInfo?.installed) {
         console.log(chalk.gray(`      - ${msg.skillsGlobal || 'User level'}: ${userSkillsInfo.path}`));
@@ -724,6 +738,12 @@ function displaySkillsStatus(manifest, projectPath, msg) {
           console.log(chalk.gray(`      ${msg.canUseFallback || 'Can use fallback'}: ${config.fallbackSkillsPath}`));
         }
       }
+      // Track missing Skills
+      missingSkills.push({
+        agent: tool,
+        displayName,
+        paths: config.skills
+      });
     }
 
     // Check Commands installation for this agent
@@ -737,6 +757,12 @@ function displaySkillsStatus(manifest, projectPath, msg) {
         }
       } else {
         console.log(chalk.gray(`    ○ Commands: ${msg.notInstalled || 'Not installed'}`));
+        // Track missing Commands
+        missingCommands.push({
+          agent: tool,
+          displayName,
+          path: config.commands.project
+        });
       }
     }
   }
@@ -758,6 +784,173 @@ function displaySkillsStatus(manifest, projectPath, msg) {
   }
 
   console.log();
+
+  return { missingSkills, missingCommands };
+}
+
+/**
+ * Prompt user to install missing Skills/Commands discovered during check
+ * @param {Object} manifest - The manifest object
+ * @param {string} projectPath - Project path
+ * @param {Array} missingSkills - Array of {agent, displayName, paths}
+ * @param {Array} missingCommands - Array of {agent, displayName, path}
+ * @param {Object} msg - i18n messages
+ * @returns {Promise<boolean>} - Whether anything was installed
+ */
+async function promptSkillsCommandsInstallation(manifest, projectPath, missingSkills, missingCommands, msg) {
+  const repoInfo = getRepositoryInfo();
+  let installedAnything = false;
+
+  // Handle missing Skills with checkbox selection
+  if (missingSkills.length > 0) {
+    console.log();
+    console.log(chalk.cyan('━'.repeat(50)));
+    console.log(chalk.cyan.bold(msg.offerSkillsInstallation || 'Skills Installation'));
+    console.log(chalk.cyan('━'.repeat(50)));
+    console.log();
+
+    // Build checkbox choices
+    const skillChoices = missingSkills.map(skill => ({
+      name: skill.displayName,
+      value: skill.agent,
+      checked: true  // Default checked for opt-out behavior
+    }));
+
+    // Add skip option
+    skillChoices.push(new inquirer.Separator());
+    skillChoices.push({
+      name: chalk.gray(msg.skipInstallation || 'Skip'),
+      value: '__skip__'
+    });
+
+    const { selectedSkillAgents } = await inquirer.prompt([{
+      type: 'checkbox',
+      name: 'selectedSkillAgents',
+      message: msg.selectSkillsToInstall || 'Select AI tools to install Skills for:',
+      choices: skillChoices,
+      validate: (answer) => {
+        if (answer.includes('__skip__') && answer.length > 1) {
+          return t().commands.update.skipValidationError || 'Cannot select Skip with other options';
+        }
+        return true;
+      }
+    }]);
+
+    const filteredSkillAgents = selectedSkillAgents.filter(a => a !== '__skip__');
+
+    if (filteredSkillAgents.length > 0) {
+      // Prompt for installation level
+      const { skillsLevel } = await inquirer.prompt([{
+        type: 'list',
+        name: 'skillsLevel',
+        message: t().commands.update.skillsLevelQuestion || 'Where should Skills be installed?',
+        choices: [
+          { name: `${t().commands.update.projectLevel || 'Project level'} (.claude/skills/, etc.)`, value: 'project' },
+          { name: `${t().commands.update.userLevel || 'User level'} (~/.claude/skills/, etc.)`, value: 'user' }
+        ],
+        default: 'project'
+      }]);
+
+      // Install Skills
+      const spinner = ora(t().commands.update.installingNewSkills || 'Installing Skills...').start();
+      const skillResult = await installSkillsToMultipleAgents(
+        filteredSkillAgents.map(agent => ({ agent, level: skillsLevel })),
+        null,
+        projectPath
+      );
+
+      // Update manifest
+      if (!manifest.skills) manifest.skills = {};
+      manifest.skills.installed = true;
+      manifest.skills.version = repoInfo.skills.version;
+      manifest.skills.installations = [
+        ...(manifest.skills.installations || []),
+        ...filteredSkillAgents.map(agent => ({ agent, level: skillsLevel }))
+      ];
+
+      if (skillResult.totalErrors === 0) {
+        spinner.succeed((msg.skillsInstalledSuccess || 'Installed Skills for {count} AI tools')
+          .replace('{count}', filteredSkillAgents.length));
+      } else {
+        spinner.warn((t().commands.update.newSkillsInstalledWithErrors || 'Installed Skills with {errors} errors')
+          .replace('{errors}', skillResult.totalErrors));
+      }
+
+      installedAnything = true;
+    }
+  }
+
+  // Handle missing Commands with checkbox selection
+  if (missingCommands.length > 0) {
+    console.log();
+    console.log(chalk.cyan('━'.repeat(50)));
+    console.log(chalk.cyan.bold(msg.offerCommandsInstallation || 'Commands Installation'));
+    console.log(chalk.cyan('━'.repeat(50)));
+    console.log();
+
+    // Build checkbox choices
+    const commandChoices = missingCommands.map(cmd => ({
+      name: `${cmd.displayName} ${chalk.gray(`(${cmd.path})`)}`,
+      value: cmd.agent,
+      checked: true  // Default checked for opt-out behavior
+    }));
+
+    // Add skip option
+    commandChoices.push(new inquirer.Separator());
+    commandChoices.push({
+      name: chalk.gray(msg.skipInstallation || 'Skip'),
+      value: '__skip__'
+    });
+
+    const { selectedCommandAgents } = await inquirer.prompt([{
+      type: 'checkbox',
+      name: 'selectedCommandAgents',
+      message: msg.selectCommandsToInstall || 'Select AI tools to install Commands for:',
+      choices: commandChoices,
+      validate: (answer) => {
+        if (answer.includes('__skip__') && answer.length > 1) {
+          return t().commands.update.skipValidationError || 'Cannot select Skip with other options';
+        }
+        return true;
+      }
+    }]);
+
+    const filteredCommandAgents = selectedCommandAgents.filter(a => a !== '__skip__');
+
+    if (filteredCommandAgents.length > 0) {
+      const spinner = ora(t().commands.update.installingNewCommands || 'Installing commands...').start();
+      const cmdResult = await installCommandsToMultipleAgents(
+        filteredCommandAgents,
+        null,
+        projectPath
+      );
+
+      // Update manifest
+      if (!manifest.commands) manifest.commands = {};
+      manifest.commands.installed = true;
+      manifest.commands.installations = [
+        ...(manifest.commands.installations || []),
+        ...filteredCommandAgents
+      ];
+
+      if (cmdResult.totalErrors === 0) {
+        spinner.succeed((msg.commandsInstalledSuccess || 'Installed commands for {count} AI tools')
+          .replace('{count}', filteredCommandAgents.length));
+      } else {
+        spinner.warn((t().commands.update.newCommandsInstalledWithErrors || 'Installed commands with {errors} errors')
+          .replace('{errors}', cmdResult.totalErrors));
+      }
+
+      installedAnything = true;
+    }
+  }
+
+  // Save manifest if anything was installed
+  if (installedAnything) {
+    writeManifest(manifest, projectPath);
+  }
+
+  return installedAnything;
 }
 
 /**

package/src/commands/update.js

@@ -1005,7 +1005,7 @@ async function promptNewFeatureInstallation(missingSkills, missingCommands) {
 
   const result = { installSkills: [], installCommands: [] };
 
-  // Handle missing Skills
+  // Handle missing Skills with checkbox selection
   if (missingSkills.length > 0) {
     console.log(chalk.yellow(msg.skillsNotInstalledFor || 'Skills not yet installed for these AI tools:'));
     for (const skill of missingSkills) {
@@ -1013,14 +1013,38 @@ async function promptNewFeatureInstallation(missingSkills, missingCommands) {
     }
     console.log();
 
-    const { shouldInstallSkills } = await inquirer.prompt([{
-      type: 'confirm',
-      name: 'shouldInstallSkills',
-      message: msg.installSkillsNow || 'Would you like to install Skills for these AI tools?',
-      default: true
+    // Build checkbox choices
+    const skillChoices = missingSkills.map(skill => ({
+      name: skill.displayName,
+      value: skill.agent,
+      checked: true  // Default checked for opt-out behavior
+    }));
+
+    // Add skip option
+    skillChoices.push(new inquirer.Separator());
+    skillChoices.push({
+      name: chalk.gray(msg.skipSkillsInstallation || 'Skip Skills installation'),
+      value: '__skip__'
+    });
+
+    const { selectedSkillAgents } = await inquirer.prompt([{
+      type: 'checkbox',
+      name: 'selectedSkillAgents',
+      message: msg.selectSkillsToInstall || 'Select AI tools to install Skills for:',
+      choices: skillChoices,
+      validate: (answer) => {
+        // If skip is selected, ensure it's the only selection
+        if (answer.includes('__skip__') && answer.length > 1) {
+          return msg.skipValidationError || 'Cannot select Skip with other options';
+        }
+        return true;
+      }
     }]);
 
-    if (shouldInstallSkills) {
+    // Filter out skip and handle selection
+    const filteredSkillAgents = selectedSkillAgents.filter(a => a !== '__skip__');
+
+    if (filteredSkillAgents.length > 0) {
       // Prompt for installation level
       const { skillsLevel } = await inquirer.prompt([{
         type: 'list',
@@ -1033,15 +1057,15 @@ async function promptNewFeatureInstallation(missingSkills, missingCommands) {
         default: 'project'
       }]);
 
-      result.installSkills = missingSkills.map(s => ({
-        agent: s.agent,
+      result.installSkills = filteredSkillAgents.map(agent => ({
+        agent,
         level: skillsLevel
       }));
     }
     console.log();
   }
 
-  // Handle missing Commands
+  // Handle missing Commands with checkbox selection
   if (missingCommands.length > 0) {
     console.log(chalk.yellow(msg.commandsNotInstalledFor || 'Slash commands not yet installed for these AI tools:'));
     for (const cmd of missingCommands) {
@@ -1049,16 +1073,35 @@ async function promptNewFeatureInstallation(missingSkills, missingCommands) {
     }
     console.log();
 
-    const { shouldInstallCommands } = await inquirer.prompt([{
-      type: 'confirm',
-      name: 'shouldInstallCommands',
-      message: msg.installCommandsNow || 'Would you like to install slash commands for these AI tools?',
-      default: true
+    // Build checkbox choices
+    const commandChoices = missingCommands.map(cmd => ({
+      name: `${cmd.displayName} ${chalk.gray(`(${cmd.path})`)}`,
+      value: cmd.agent,
+      checked: true  // Default checked for opt-out behavior
+    }));
+
+    // Add skip option
+    commandChoices.push(new inquirer.Separator());
+    commandChoices.push({
+      name: chalk.gray(msg.skipCommandsInstallation || 'Skip Commands installation'),
+      value: '__skip__'
+    });
+
+    const { selectedCommandAgents } = await inquirer.prompt([{
+      type: 'checkbox',
+      name: 'selectedCommandAgents',
+      message: msg.selectCommandsToInstall || 'Select AI tools to install Commands for:',
+      choices: commandChoices,
+      validate: (answer) => {
+        if (answer.includes('__skip__') && answer.length > 1) {
+          return msg.skipValidationError || 'Cannot select Skip with other options';
+        }
+        return true;
+      }
     }]);
 
-    if (shouldInstallCommands) {
-      result.installCommands = missingCommands.map(c => c.agent);
-    }
+    // Filter out skip
+    result.installCommands = selectedCommandAgents.filter(a => a !== '__skip__');
   }
 
   return result;

package/src/i18n/messages.js

@@ -594,7 +594,15 @@ export const messages = {
         runNpmUpdate: 'Run: npm update -g universal-dev-standards',
         // Final status
         projectCompliant: '✓ Project is compliant with standards',
-        issuesDetected: '⚠ Some issues detected. Review above for details.'
+        issuesDetected: '⚠ Some issues detected. Review above for details.',
+        // Installation prompts
+        offerSkillsInstallation: 'Skills Installation',
+        offerCommandsInstallation: 'Commands Installation',
+        selectSkillsToInstall: 'Select AI tools to install Skills for:',
+        selectCommandsToInstall: 'Select AI tools to install Commands for:',
+        skipInstallation: 'Skip',
+        skillsInstalledSuccess: 'Installed Skills for {count} AI tools',
+        commandsInstalledSuccess: 'Installed commands for {count} AI tools'
       },
 
       // init command (commands/init.js)
@@ -752,6 +760,11 @@ export const messages = {
         commandsNotInstalledFor: 'Slash commands not yet installed for these AI tools:',
         installSkillsNow: 'Would you like to install Skills for these AI tools?',
         installCommandsNow: 'Would you like to install slash commands for these AI tools?',
+        selectSkillsToInstall: 'Select AI tools to install Skills for:',
+        selectCommandsToInstall: 'Select AI tools to install Commands for:',
+        skipSkillsInstallation: 'Skip Skills installation',
+        skipCommandsInstallation: 'Skip Commands installation',
+        skipValidationError: 'Cannot select Skip with other options',
         skillsLevelQuestion: 'Where should Skills be installed?',
         projectLevel: 'Project level',
         userLevel: 'User level',
@@ -1419,7 +1432,15 @@ export const messages = {
         runNpmUpdate: '執行：npm update -g universal-dev-standards',
         // Final status
         projectCompliant: '✓ 專案符合標準',
-        issuesDetected: '⚠ 偵測到一些問題。請檢視上方詳情。'
+        issuesDetected: '⚠ 偵測到一些問題。請檢視上方詳情。',
+        // Installation prompts
+        offerSkillsInstallation: 'Skills 安裝',
+        offerCommandsInstallation: '斜線命令安裝',
+        selectSkillsToInstall: '選擇要安裝 Skills 的 AI 工具：',
+        selectCommandsToInstall: '選擇要安裝斜線命令的 AI 工具：',
+        skipInstallation: '跳過',
+        skillsInstalledSuccess: '已為 {count} 個 AI 工具安裝 Skills',
+        commandsInstalledSuccess: '已為 {count} 個 AI 工具安裝斜線命令'
       },
 
       // init command (commands/init.js)
@@ -1577,6 +1598,11 @@ export const messages = {
         commandsNotInstalledFor: '以下 AI 工具尚未安裝斜線命令：',
         installSkillsNow: '是否要為這些 AI 工具安裝 Skills？',
         installCommandsNow: '是否要為這些 AI 工具安裝斜線命令？',
+        selectSkillsToInstall: '選擇要安裝 Skills 的 AI 工具：',
+        selectCommandsToInstall: '選擇要安裝斜線命令的 AI 工具：',
+        skipSkillsInstallation: '跳過 Skills 安裝',
+        skipCommandsInstallation: '跳過斜線命令安裝',
+        skipValidationError: '選擇「跳過」時不能同時選擇其他選項',
         skillsLevelQuestion: 'Skills 要安裝到哪裡？',
         projectLevel: '專案層級',
         userLevel: '使用者層級',
@@ -2147,7 +2173,15 @@ export const messages = {
         runNpmUpdate: '执行：npm update -g universal-dev-standards',
         // Final status
         projectCompliant: '✓ 项目符合标准',
-        issuesDetected: '⚠ 检测到一些问题。详情请查看上文。'
+        issuesDetected: '⚠ 检测到一些问题。详情请查看上文。',
+        // Installation prompts
+        offerSkillsInstallation: 'Skills 安装',
+        offerCommandsInstallation: '斜线命令安装',
+        selectSkillsToInstall: '选择要安装 Skills 的 AI 工具：',
+        selectCommandsToInstall: '选择要安装斜线命令的 AI 工具：',
+        skipInstallation: '跳过',
+        skillsInstalledSuccess: '已为 {count} 个 AI 工具安装 Skills',
+        commandsInstalledSuccess: '已为 {count} 个 AI 工具安装斜线命令'
       },
 
       // update command
@@ -2234,6 +2268,11 @@ export const messages = {
         commandsNotInstalledFor: '以下 AI 工具尚未安装斜线命令：',
         installSkillsNow: '是否要为这些 AI 工具安装 Skills？',
         installCommandsNow: '是否要为这些 AI 工具安装斜线命令？',
+        selectSkillsToInstall: '选择要安装 Skills 的 AI 工具：',
+        selectCommandsToInstall: '选择要安装斜线命令的 AI 工具：',
+        skipSkillsInstallation: '跳过 Skills 安装',
+        skipCommandsInstallation: '跳过斜线命令安装',
+        skipValidationError: '选择「跳过」时不能同时选择其他选项',
         skillsLevelQuestion: 'Skills 要安装到哪里？',
         projectLevel: '项目级别',
         userLevel: '用户级别',

package/src/utils/skills-installer.js

@@ -473,16 +473,37 @@ export function getInstalledSkillsInfoForAgent(agent, level, projectPath = null)
 
   const manifestPath = join(targetDir, '.manifest.json');
 
+  // Check if manifest exists
   if (!existsSync(manifestPath)) {
-    // Skills exist but no manifest
-    return {
-      installed: true,
-      version: null,
-      source: 'unknown',
-      agent,
-      level,
-      path: targetDir
-    };
+    // No manifest - check if there are actual skill files (SKILL.md in subdirectories)
+    try {
+      const entries = readdirSync(targetDir, { withFileTypes: true });
+      const skillDirs = entries.filter(e => e.isDirectory() && !e.name.startsWith('.'));
+
+      // Check if any subdirectory contains a SKILL.md file
+      const hasSkillFiles = skillDirs.some(dir => {
+        const skillFile = join(targetDir, dir.name, 'SKILL.md');
+        return existsSync(skillFile);
+      });
+
+      if (!hasSkillFiles) {
+        // Empty directory or no valid skills - not installed
+        return null;
+      }
+
+      // Has skill files but no manifest
+      return {
+        installed: true,
+        version: null,
+        source: 'unknown',
+        agent,
+        level,
+        path: targetDir
+      };
+    } catch {
+      // Error reading directory - assume not installed
+      return null;
+    }
   }
 
   try {

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "3.5.1-beta.7",
+  "version": "3.5.1-beta.9",
   "lastUpdated": "2026-01-15",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -48,14 +48,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "3.5.1-beta.7"
+      "version": "3.5.1-beta.9"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills/claude-code",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills/claude-code",
-      "version": "3.5.1-beta.7",
+      "version": "3.5.1-beta.9",
       "note": "Skills are now included in the main repository under skills/"
     }
   },