universal-dev-standards 3.2.2-beta.2 → 3.2.2

package/README.md

@@ -119,6 +119,39 @@ uds update --yes
 **Options | 選項:**
 - `-y, --yes` - Skip confirmation prompts | 跳過確認提示
 
+### `uds skills`
+
+List installed Claude Code skills. | 列出已安裝的 Claude Code Skills。
+
+```bash
+uds skills
+```
+
+**Output includes | 輸出內容:**
+- Installation location (Plugin Marketplace, User Level, Project Level) | 安裝位置
+- Installed version | 已安裝版本
+- List of installed skills | 已安裝的 Skills 清單
+- Migration recommendations for deprecated installations | 棄用安裝的遷移建議
+
+**Example Output | 範例輸出:**
+```
+Universal Dev Standards - Installed Skills
+──────────────────────────────────────────────────
+
+✓ Plugin Marketplace (recommended)
+  Version: 3.2.2
+  Path: /Users/.../.claude/plugins/universal-dev-standards@...
+
+  Skills (14):
+    ✓ ai-collaboration-standards
+    ✓ changelog-guide
+    ✓ code-review-assistant
+    ...
+
+──────────────────────────────────────────────────
+Total unique skills: 14 / 14
+```
+
 ## Adoption Levels | 採用等級
 
 | Level | Name | Description | 說明 |
@@ -273,6 +306,7 @@ Git 鉤子透過 Git Bash 運作，它包含在 Git for Windows 中。不需要
 
 | Version | Date | Changes |
 |---------|------|---------|
+| 3.2.2 | 2026-01-06 | Added: `uds skills` command to list installed Claude Code skills; Deprecated: manual installation scripts |
 | 3.2.0 | 2026-01-02 | Added: Marketplace installation support; Fixed: wildcard paths, process hanging |
 | 3.0.0 | 2025-12-30 | Published to npm, enhanced init with AI tools selection |
 | 1.0.1 | 2025-12-24 | Added: Bilingual support (English + Chinese) |

package/bin/uds.js

@@ -7,6 +7,7 @@ import { initCommand } from '../src/commands/init.js';
 import { checkCommand } from '../src/commands/check.js';
 import { updateCommand } from '../src/commands/update.js';
 import { configureCommand } from '../src/commands/configure.js';
+import { skillsCommand } from '../src/commands/skills.js';
 
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
@@ -57,4 +58,9 @@ program
   .option('-y, --yes', 'Skip confirmation prompts')
   .action(updateCommand);
 
+program
+  .command('skills')
+  .description('List installed Claude Code skills')
+  .action(skillsCommand);
+
 program.parse();

package/package.json

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

package/src/commands/skills.js

@@ -0,0 +1,233 @@
+import chalk from 'chalk';
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { getAllSkillNames } from '../utils/registry.js';
+
+// Known skill directories (non-skill items to exclude)
+const NON_SKILL_ITEMS = [
+  'README.md',
+  'CONTRIBUTING.template.md',
+  'install.sh',
+  'install.ps1',
+  'universal-dev-standards',
+  '.manifest.json',
+  '.DS_Store'
+];
+
+/**
+ * Get installed plugins info from Claude Code
+ * @returns {Object|null} Plugins info or null
+ */
+function getInstalledPlugins() {
+  const pluginsPath = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
+
+  if (!existsSync(pluginsPath)) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(readFileSync(pluginsPath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Find universal-dev-standards plugin in installed plugins
+ * @param {Object} pluginsInfo - Installed plugins info
+ * @returns {Object|null} Plugin info or null
+ */
+function findUdsPlugin(pluginsInfo) {
+  if (!pluginsInfo?.plugins) {
+    return null;
+  }
+
+  // Look for universal-dev-standards plugin
+  for (const [key, installations] of Object.entries(pluginsInfo.plugins)) {
+    if (key.includes('universal-dev-standards')) {
+      // Return the first (usually only) installation
+      if (installations.length > 0) {
+        return {
+          key,
+          ...installations[0]
+        };
+      }
+    }
+  }
+
+  return null;
+}
+
+/**
+ * List skill directories in a path
+ * @param {string} dirPath - Directory path to scan
+ * @returns {string[]} Array of skill names
+ */
+function listSkillsInDir(dirPath) {
+  if (!existsSync(dirPath)) {
+    return [];
+  }
+
+  try {
+    const items = readdirSync(dirPath, { withFileTypes: true });
+    return items
+      .filter(item => item.isDirectory() && !NON_SKILL_ITEMS.includes(item.name))
+      .map(item => item.name)
+      .sort();
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Skills command - list installed skills
+ */
+export function skillsCommand() {
+  const projectPath = process.cwd();
+
+  console.log();
+  console.log(chalk.bold('Universal Dev Standards - Installed Skills'));
+  console.log(chalk.gray('─'.repeat(50)));
+  console.log();
+
+  // Get all known skills from registry
+  const knownSkills = getAllSkillNames();
+
+  // Check different installation locations
+  const installations = [];
+
+  // 1. Check Plugin Marketplace installation
+  const pluginsInfo = getInstalledPlugins();
+  const udsPlugin = findUdsPlugin(pluginsInfo);
+
+  if (udsPlugin && udsPlugin.installPath && existsSync(udsPlugin.installPath)) {
+    const skills = listSkillsInDir(udsPlugin.installPath);
+    if (skills.length > 0) {
+      installations.push({
+        location: 'Plugin Marketplace',
+        path: udsPlugin.installPath,
+        version: udsPlugin.version || 'unknown',
+        skills,
+        recommended: true
+      });
+    }
+  }
+
+  // 2. Check user-level installation (~/.claude/skills/)
+  const userSkillsDir = join(homedir(), '.claude', 'skills');
+  if (existsSync(userSkillsDir)) {
+    const skills = listSkillsInDir(userSkillsDir);
+    // Filter to only known UDS skills
+    const udsSkills = skills.filter(s => knownSkills.includes(s));
+    if (udsSkills.length > 0) {
+      // Check for manifest
+      const manifestPath = join(userSkillsDir, '.manifest.json');
+      let version = 'unknown';
+      if (existsSync(manifestPath)) {
+        try {
+          const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+          version = manifest.version || 'unknown';
+        } catch {
+          // ignore
+        }
+      }
+
+      installations.push({
+        location: 'User Level (deprecated)',
+        path: userSkillsDir,
+        version,
+        skills: udsSkills,
+        deprecated: true
+      });
+    }
+  }
+
+  // 3. Check project-level installation (.claude/skills/)
+  const projectSkillsDir = join(projectPath, '.claude', 'skills');
+  if (existsSync(projectSkillsDir)) {
+    const skills = listSkillsInDir(projectSkillsDir);
+    // Filter to only known UDS skills
+    const udsSkills = skills.filter(s => knownSkills.includes(s));
+    if (udsSkills.length > 0) {
+      // Check for manifest
+      const manifestPath = join(projectSkillsDir, '.manifest.json');
+      let version = 'unknown';
+      if (existsSync(manifestPath)) {
+        try {
+          const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+          version = manifest.version || 'unknown';
+        } catch {
+          // ignore
+        }
+      }
+
+      installations.push({
+        location: 'Project Level (deprecated)',
+        path: projectSkillsDir,
+        version,
+        skills: udsSkills,
+        deprecated: true
+      });
+    }
+  }
+
+  // Display results
+  if (installations.length === 0) {
+    console.log(chalk.yellow('No Universal Dev Standards skills installed.'));
+    console.log();
+    console.log(chalk.gray('Install via Plugin Marketplace:'));
+    console.log(chalk.cyan('  /plugin marketplace add AsiaOstrich/universal-dev-standards'));
+    console.log(chalk.cyan('  /plugin install universal-dev-standards@universal-dev-standards'));
+    console.log();
+    return;
+  }
+
+  // Show each installation
+  for (const install of installations) {
+    // Header
+    if (install.recommended) {
+      console.log(chalk.green(`✓ ${install.location}`) + chalk.gray(' (recommended)'));
+    } else if (install.deprecated) {
+      console.log(chalk.yellow(`⚠ ${install.location}`));
+    } else {
+      console.log(chalk.blue(`● ${install.location}`));
+    }
+
+    console.log(chalk.gray(`  Version: ${install.version}`));
+    console.log(chalk.gray(`  Path: ${install.path}`));
+    console.log();
+
+    // Skills list
+    console.log(chalk.gray(`  Skills (${install.skills.length}):`));
+    for (const skill of install.skills) {
+      const icon = install.deprecated ? chalk.yellow('○') : chalk.green('✓');
+      console.log(`    ${icon} ${skill}`);
+    }
+    console.log();
+
+    // Deprecation warning
+    if (install.deprecated) {
+      console.log(chalk.yellow('  ⚠ Manual installation is deprecated.'));
+      console.log(chalk.gray('  Migrate to Plugin Marketplace for automatic updates:'));
+      console.log(chalk.cyan('    /plugin marketplace add AsiaOstrich/universal-dev-standards'));
+      console.log(chalk.cyan('    /plugin install universal-dev-standards@universal-dev-standards'));
+      console.log();
+    }
+  }
+
+  // Summary
+  const totalSkills = new Set(installations.flatMap(i => i.skills)).size;
+  const hasMarketplace = installations.some(i => i.recommended);
+
+  console.log(chalk.gray('─'.repeat(50)));
+  console.log(chalk.gray(`Total unique skills: ${totalSkills} / ${knownSkills.length}`));
+
+  if (!hasMarketplace && installations.length > 0) {
+    console.log();
+    console.log(chalk.yellow('Recommendation: Migrate to Plugin Marketplace'));
+    console.log(chalk.gray('  Benefits: Automatic updates, better integration'));
+  }
+
+  console.log();
+}

package/src/commands/update.js

@@ -177,8 +177,33 @@ export async function updateCommand(options) {
       console.log(chalk.cyan('Skills update available:'));
       console.log(chalk.gray(`  Current: ${manifest.skills.version || 'unknown'}`));
       console.log(chalk.gray(`  Latest:  ${skillsVersion}`));
-      console.log(chalk.gray('  Run the following to update:'));
-      console.log(chalk.gray('    cd path/to/universal-dev-skills && git pull && ./install.sh'));
+      console.log();
+
+      // Check installation location to provide appropriate update instructions
+      const location = manifest.skills.location || 'unknown';
+
+      if (location === 'marketplace') {
+        console.log(chalk.gray('  Update via Plugin Marketplace:'));
+        console.log(chalk.gray('    • Auto-update: Restart Claude Code (updates on startup)'));
+        console.log(chalk.gray('    • Manual: Run /plugin marketplace update anthropic-agent-skills'));
+      } else if (location === 'user') {
+        console.log(chalk.yellow('  ⚠️  Manual installation is deprecated'));
+        console.log(chalk.gray('  Recommended: Migrate to Plugin Marketplace'));
+        console.log(chalk.gray('    /plugin add https://github.com/anthropics/claude-code-plugins/blob/main/skills/universal-dev-standards.md'));
+        console.log(chalk.gray('  Or update manually:'));
+        console.log(chalk.gray('    cd ~/.claude/skills/universal-dev-standards && git pull'));
+      } else if (location === 'project') {
+        console.log(chalk.yellow('  ⚠️  Manual installation is deprecated'));
+        console.log(chalk.gray('  Recommended: Migrate to Plugin Marketplace'));
+        console.log(chalk.gray('    /plugin add https://github.com/anthropics/claude-code-plugins/blob/main/skills/universal-dev-standards.md'));
+        console.log(chalk.gray('  Or update manually:'));
+        console.log(chalk.gray('    cd .claude/skills/universal-dev-standards && git pull'));
+      } else {
+        // Legacy or unknown installation
+        console.log(chalk.yellow('  ⚠️  Manual installation is deprecated'));
+        console.log(chalk.gray('  Recommended: Migrate to Plugin Marketplace'));
+        console.log(chalk.gray('    /plugin add https://github.com/anthropics/claude-code-plugins/blob/main/skills/universal-dev-standards.md'));
+      }
     }
   }
 

package/src/index.js

@@ -5,3 +5,4 @@ export { listCommand } from './commands/list.js';
 export { initCommand } from './commands/init.js';
 export { checkCommand } from './commands/check.js';
 export { updateCommand } from './commands/update.js';
+export { skillsCommand } from './commands/skills.js';

package/standards-registry.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "version": "3.2.2",
-  "lastUpdated": "2026-01-05",
+  "lastUpdated": "2026-01-06",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
     "ai": {