@vibe-agent-toolkit/cli 0.1.9 → 0.1.11

package/dist/commands/skills/validate.js

@@ -0,0 +1,264 @@
+/**
+ * Skills validate command - unified validation for SKILL.md files
+ *
+ * Combines resource validation (markdown, links, frontmatter) with
+ * skill-specific validation (reserved words, XML tags, console compatibility).
+ *
+ * Supports three modes:
+ * 1. Project context (default): Validate project skills with strict filename validation
+ * 2. User context (--user flag): Validate ~/.claude skills with permissive validation
+ * 3. Path context (explicit path): Validate skills at specific path
+ */
+import * as path from 'node:path';
+import { validateSkill } from '@vibe-agent-toolkit/agent-skills';
+import { scan } from '@vibe-agent-toolkit/discovery';
+import { ResourceRegistry } from '@vibe-agent-toolkit/resources';
+import { GitTracker } from '@vibe-agent-toolkit/utils';
+import * as yaml from 'js-yaml';
+import { loadConfig } from '../../utils/config-loader.js';
+import { formatDurationSecs } from '../../utils/duration.js';
+import { createLogger } from '../../utils/logger.js';
+import { discoverSkills, validateSkillFilename } from '../../utils/skill-discovery.js';
+import { scanUserContext } from '../../utils/user-context-scanner.js';
+import { handleCommandError } from './command-helpers.js';
+/**
+ * Validate a SKILL.md file using resource validation (links, frontmatter)
+ */
+async function validateSkillAsResource(skillPath, rootDir, gitTracker) {
+    const registry = new ResourceRegistry({
+        rootDir,
+        ...(gitTracker !== undefined && { gitTracker })
+    });
+    // Add the entire resources directory to ensure all linked files are available for validation
+    // This is necessary because SKILL.md links to agent markdown files in ../agents/
+    const resourcesDir = path.resolve(path.dirname(skillPath), '..');
+    await registry.crawl({ baseDir: resourcesDir, include: ['**/*.md'] });
+    // Validate (no frontmatter schema by default)
+    const result = await registry.validate();
+    return result;
+}
+/**
+ * Build issues array from validation results
+ */
+function buildIssuesArray(skillPath, filenameValidation, strictMode, resourceErrors, skillErrors, skillWarnings) {
+    const issues = [];
+    // Add filename validation issues
+    if (!filenameValidation.valid && filenameValidation.message) {
+        issues.push({
+            source: 'filename',
+            severity: strictMode ? 'error' : 'warning',
+            code: 'non-standard-filename',
+            message: filenameValidation.message,
+            location: skillPath,
+        });
+    }
+    // Add resource issues
+    for (const issue of resourceErrors) {
+        const location = issue.line === undefined ? skillPath : `${skillPath}:${issue.line}`;
+        issues.push({
+            source: 'resource',
+            severity: 'error',
+            code: issue.type,
+            message: issue.message,
+            location,
+        });
+    }
+    // Add skill issues
+    for (const issue of [...skillErrors, ...skillWarnings]) {
+        issues.push({
+            source: 'skill',
+            severity: issue.severity,
+            code: issue.code,
+            message: issue.message,
+            location: issue.location,
+        });
+    }
+    return issues;
+}
+/**
+ * Merge resource, skill, and filename validation results
+ */
+function mergeValidationResults(skillPath, resourceResult, skillResult, filenameValidation, strictMode) {
+    const skillName = skillResult.metadata?.name ?? path.basename(path.dirname(skillPath));
+    // Extract resource errors (exclude external_url which are informational)
+    const resourceErrors = resourceResult.issues.filter(i => i.type !== 'external_url');
+    const resourceErrorCount = resourceErrors.length;
+    // Extract skill errors and warnings
+    const skillErrors = skillResult.issues.filter(i => i.severity === 'error');
+    const skillWarnings = skillResult.issues.filter(i => i.severity === 'warning');
+    const skillErrorCount = skillErrors.length;
+    const skillWarningCount = skillWarnings.length;
+    // Count filename issues
+    const filenameErrorCount = !filenameValidation.valid && strictMode ? 1 : 0;
+    const filenameWarningCount = !filenameValidation.valid && !strictMode ? 1 : 0;
+    const totalErrors = resourceErrorCount + skillErrorCount + filenameErrorCount;
+    const totalWarnings = skillWarningCount + filenameWarningCount;
+    // Build unified issues array
+    const issues = buildIssuesArray(skillPath, filenameValidation, strictMode, resourceErrors, skillErrors, skillWarnings);
+    const baseResult = {
+        skill: skillName,
+        path: skillPath,
+        status: totalErrors > 0 ? 'error' : 'success',
+        resourceValidation: {
+            status: resourceErrorCount > 0 ? 'error' : 'success',
+            linksChecked: resourceResult.linksByType ? Object.values(resourceResult.linksByType).reduce((sum, count) => sum + count, 0) : 0,
+            errors: resourceErrorCount,
+        },
+        skillValidation: {
+            status: (skillErrorCount + filenameErrorCount) > 0 ? 'error' : 'success',
+            errors: skillErrorCount + filenameErrorCount,
+            warnings: skillWarningCount + filenameWarningCount,
+        },
+        totalErrors,
+        totalWarnings,
+    };
+    // Only add issues property if there are issues
+    if (issues.length > 0) {
+        return { ...baseResult, issues };
+    }
+    return baseResult;
+}
+/**
+ * Format skill status for console output
+ */
+function formatSkillStatus(result) {
+    if (result.status === 'error') {
+        const errorText = `${result.totalErrors} error${result.totalErrors === 1 ? '' : 's'}`;
+        const warningPlural = result.totalWarnings === 1 ? '' : 's';
+        const warningText = result.totalWarnings > 0
+            ? `, ${result.totalWarnings} warning${warningPlural}`
+            : '';
+        return `   ❌ ${result.skill} (${errorText}${warningText})`;
+    }
+    if (result.totalWarnings > 0) {
+        const warningPlural = result.totalWarnings === 1 ? '' : 's';
+        return `   ⚠️  ${result.skill} (${result.totalWarnings} warning${warningPlural})`;
+    }
+    return `   ✅ ${result.skill}`;
+}
+/**
+ * Output detailed error for a single issue
+ */
+function outputDetailedIssue(issue) {
+    console.error(`      [${issue.source}] ${issue.severity}: ${issue.message} (${issue.code})`);
+    if (issue.location !== undefined) {
+        console.error(`      Location: ${issue.location}`);
+    }
+}
+/**
+ * Output unified validation report
+ */
+function outputUnifiedReport(results, duration) {
+    const output = {
+        status: results.some(r => r.status === 'error') ? 'error' : 'success',
+        skillsValidated: results.length,
+        results,
+        durationSecs: formatDurationSecs(duration),
+    };
+    // Output YAML to stdout (for programmatic parsing)
+    // js-yaml has truncation issues with very large objects (>80 results)
+    // Use JSON for large outputs to avoid truncation
+    if (results.length > 80) {
+        console.log(JSON.stringify(output, null, 2));
+    }
+    else {
+        console.log(yaml.dump(output, { indent: 2, lineWidth: -1, noRefs: true }));
+    }
+    // If there are errors, also write detailed errors to stderr
+    const failedSkills = results.filter(r => r.status === 'error');
+    if (failedSkills.length === 0) {
+        return;
+    }
+    console.error('\n❌ Validation errors:\n');
+    for (const result of failedSkills) {
+        console.error(`   ${result.path}:`);
+        if (result.issues) {
+            for (const issue of result.issues) {
+                outputDetailedIssue(issue);
+            }
+        }
+        console.error('');
+    }
+}
+/**
+ * Skills validate command implementation
+ */
+export async function validateCommand(pathArg, options) {
+    const logger = createLogger(options.debug ? { debug: true } : {});
+    const startTime = Date.now();
+    try {
+        // Step 1: Determine context and discover skills
+        let skillPaths;
+        let strictMode;
+        let rootDir;
+        if (options.user) {
+            // User context: scan ~/.claude
+            logger.info('🔍 Validating user-installed skills in ~/.claude');
+            const { plugins, skills } = await scanUserContext();
+            const allResources = [...plugins, ...skills];
+            const discoveredSkills = discoverSkills(allResources);
+            skillPaths = discoveredSkills.map(s => s.path);
+            strictMode = false; // Permissive with warnings
+            rootDir = process.cwd(); // Use cwd for resource validation context
+        }
+        else {
+            // Project context: use resources config
+            rootDir = pathArg ?? process.cwd();
+            logger.info(`🔍 Validating skills in: ${rootDir}`);
+            // Load project config
+            const config = loadConfig(rootDir);
+            // Use discovery package with config boundaries
+            const scanResult = await scan({
+                path: rootDir,
+                recursive: true,
+                include: config.resources?.include ?? ['**/*.md'],
+                exclude: config.resources?.exclude ?? [],
+            });
+            // Filter for skills (case-insensitive discovery)
+            const discoveredSkills = discoverSkills(scanResult.results);
+            skillPaths = discoveredSkills.map(s => s.path);
+            strictMode = true; // Strict errors
+        }
+        if (skillPaths.length === 0) {
+            logger.info('   No SKILL.md files found');
+            console.log(yaml.dump({
+                status: 'success',
+                skillsValidated: 0,
+                results: [],
+                durationSecs: formatDurationSecs(Date.now() - startTime),
+            }, { indent: 2, lineWidth: -1 }));
+            process.exit(0);
+        }
+        logger.info(`   Found ${skillPaths.length} skill${skillPaths.length === 1 ? '' : 's'}\n`);
+        // Create GitTracker for efficient git-ignore checking across all skills
+        // This caches git operations and avoids spawning hundreds of git subprocesses
+        const gitTracker = new GitTracker(rootDir);
+        await gitTracker.initialize();
+        const results = [];
+        // Step 2: Validate each skill
+        for (const skillPath of skillPaths) {
+            // 2a: Validate filename
+            const filenameCheck = validateSkillFilename(skillPath);
+            // 2b: Resource validation (markdown, links)
+            const resourceResult = await validateSkillAsResource(skillPath, rootDir, gitTracker);
+            // 2c: Skill-specific validation (reserved words, etc.)
+            const skillResult = await validateSkill({ skillPath, rootDir });
+            // 2d: Merge results
+            const unified = mergeValidationResults(skillPath, resourceResult, skillResult, filenameCheck, strictMode);
+            results.push(unified);
+            // Show progress
+            logger.info(formatSkillStatus(unified));
+        }
+        // Step 3: Output unified report
+        const duration = Date.now() - startTime;
+        logger.info('');
+        outputUnifiedReport(results, duration);
+        // Step 4: Exit with appropriate code
+        const hasErrors = results.some(r => r.totalErrors > 0);
+        process.exit(hasErrors ? 1 : 0);
+    }
+    catch (error) {
+        handleCommandError(error, logger, startTime, 'SkillsValidate');
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/skills/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/commands/skills/validate.ts"],"names":[],"mappings":"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"}

package/dist/utils/claude-paths.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Claude user directory paths
+ *
+ * Cross-platform utilities for accessing Claude's user-level directories.
+ */
+/**
+ * Get user-level Claude directories
+ *
+ * Returns absolute paths to Claude user directories.
+ * Paths are constructed but not checked for existence (caller's responsibility).
+ *
+ * @returns Object containing absolute paths to Claude directories
+ *
+ * @example
+ * ```typescript
+ * const { claudeDir, pluginsDir, skillsDir } = getClaudeUserPaths();
+ * // claudeDir: /Users/username/.claude
+ * // pluginsDir: /Users/username/.claude/plugins
+ * // skillsDir: /Users/username/.claude/skills
+ * ```
+ */
+export declare function getClaudeUserPaths(): {
+    /** ~/.claude directory */
+    claudeDir: string;
+    /** ~/.claude/plugins directory */
+    pluginsDir: string;
+    /** ~/.claude/skills directory */
+    skillsDir: string;
+    /** ~/.claude/marketplaces directory */
+    marketplacesDir: string;
+};
+//# sourceMappingURL=claude-paths.d.ts.map

package/dist/utils/claude-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-paths.d.ts","sourceRoot":"","sources":["../../src/utils/claude-paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;CACzB,CAUA"}

package/dist/utils/claude-paths.js

@@ -0,0 +1,34 @@
+/**
+ * Claude user directory paths
+ *
+ * Cross-platform utilities for accessing Claude's user-level directories.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Get user-level Claude directories
+ *
+ * Returns absolute paths to Claude user directories.
+ * Paths are constructed but not checked for existence (caller's responsibility).
+ *
+ * @returns Object containing absolute paths to Claude directories
+ *
+ * @example
+ * ```typescript
+ * const { claudeDir, pluginsDir, skillsDir } = getClaudeUserPaths();
+ * // claudeDir: /Users/username/.claude
+ * // pluginsDir: /Users/username/.claude/plugins
+ * // skillsDir: /Users/username/.claude/skills
+ * ```
+ */
+export function getClaudeUserPaths() {
+    const home = homedir();
+    const claudeDir = join(home, '.claude');
+    return {
+        claudeDir,
+        pluginsDir: join(claudeDir, 'plugins'),
+        skillsDir: join(claudeDir, 'skills'),
+        marketplacesDir: join(claudeDir, 'marketplaces'),
+    };
+}
+//# sourceMappingURL=claude-paths.js.map

package/dist/utils/claude-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-paths.js","sourceRoot":"","sources":["../../src/utils/claude-paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB;IAUhC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAExC,OAAO;QACL,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC;QACtC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;QACpC,eAAe,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/dist/utils/skill-discovery.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Skill discovery utilities
+ *
+ * Find and validate SKILL.md files within a bounded set of resources.
+ * Uses case-insensitive matching for discovery but validates proper casing.
+ */
+import type { ScanResult } from '@vibe-agent-toolkit/discovery';
+/**
+ * Discover SKILL.md files from a set of scanned resources
+ *
+ * Uses case-insensitive matching to find all SKILL.md variants.
+ * Does NOT validate that the filename is exactly "SKILL.md" - use
+ * validateSkillFilename() for that.
+ *
+ * @param resources - Array of scan results from discovery package
+ * @returns Filtered array containing only SKILL.md files
+ *
+ * @example
+ * ```typescript
+ * const allResources = await scan({ path: '~/.claude/plugins', recursive: true });
+ * const skills = discoverSkills(allResources.results);
+ * // Returns only resources with SKILL.md basename (any case)
+ * ```
+ */
+export declare function discoverSkills(resources: ScanResult[]): ScanResult[];
+/**
+ * Validate that a skill file has the exact correct filename
+ *
+ * SKILL.md must be uppercase. Lowercase (skill.md) or mixed case (Skill.md)
+ * may work on case-insensitive filesystems (macOS, Windows) but will fail
+ * on Linux.
+ *
+ * @param skillPath - Absolute path to skill file
+ * @returns Validation result with helpful error message if invalid
+ *
+ * @example
+ * ```typescript
+ * const validation = validateSkillFilename('/path/to/skill.md');
+ * if (!validation.valid) {
+ *   console.error(validation.message); // "Filename must be exactly SKILL.md..."
+ * }
+ * ```
+ */
+export declare function validateSkillFilename(skillPath: string): {
+    valid: boolean;
+    basename: string;
+    message?: string;
+};
+//# sourceMappingURL=skill-discovery.d.ts.map

package/dist/utils/skill-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-discovery.d.ts","sourceRoot":"","sources":["../../src/utils/skill-discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAchE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAEpE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG;IACxD,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAiBA"}

package/dist/utils/skill-discovery.js

@@ -0,0 +1,73 @@
+/**
+ * Skill discovery utilities
+ *
+ * Find and validate SKILL.md files within a bounded set of resources.
+ * Uses case-insensitive matching for discovery but validates proper casing.
+ */
+import { basename } from 'node:path';
+import picomatch from 'picomatch';
+/**
+ * Case-insensitive matcher for SKILL.md files
+ *
+ * Matches SKILL.md anywhere in the path, regardless of case.
+ * Examples: SKILL.md, skill.md, Skill.md, path/to/SKILL.md
+ */
+const isSkillFile = picomatch('**/SKILL.md', {
+    nocase: true, // Case-insensitive matching
+    matchBase: true, // Match basename anywhere in path
+});
+/**
+ * Discover SKILL.md files from a set of scanned resources
+ *
+ * Uses case-insensitive matching to find all SKILL.md variants.
+ * Does NOT validate that the filename is exactly "SKILL.md" - use
+ * validateSkillFilename() for that.
+ *
+ * @param resources - Array of scan results from discovery package
+ * @returns Filtered array containing only SKILL.md files
+ *
+ * @example
+ * ```typescript
+ * const allResources = await scan({ path: '~/.claude/plugins', recursive: true });
+ * const skills = discoverSkills(allResources.results);
+ * // Returns only resources with SKILL.md basename (any case)
+ * ```
+ */
+export function discoverSkills(resources) {
+    return resources.filter(resource => isSkillFile(resource.path));
+}
+/**
+ * Validate that a skill file has the exact correct filename
+ *
+ * SKILL.md must be uppercase. Lowercase (skill.md) or mixed case (Skill.md)
+ * may work on case-insensitive filesystems (macOS, Windows) but will fail
+ * on Linux.
+ *
+ * @param skillPath - Absolute path to skill file
+ * @returns Validation result with helpful error message if invalid
+ *
+ * @example
+ * ```typescript
+ * const validation = validateSkillFilename('/path/to/skill.md');
+ * if (!validation.valid) {
+ *   console.error(validation.message); // "Filename must be exactly SKILL.md..."
+ * }
+ * ```
+ */
+export function validateSkillFilename(skillPath) {
+    // Normalize path separators for cross-platform support
+    const normalizedPath = skillPath.replaceAll('\\', '/');
+    const filename = basename(normalizedPath);
+    if (filename === 'SKILL.md') {
+        return {
+            valid: true,
+            basename: filename,
+        };
+    }
+    return {
+        valid: false,
+        basename: filename,
+        message: `Filename must be exactly "SKILL.md" (case-sensitive). Found "${filename}". This may work on case-insensitive filesystems (macOS, Windows) but will fail on Linux.`,
+    };
+}
+//# sourceMappingURL=skill-discovery.js.map

package/dist/utils/skill-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-discovery.js","sourceRoot":"","sources":["../../src/utils/skill-discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC;;;;;GAKG;AACH,MAAM,WAAW,GAAG,SAAS,CAAC,aAAa,EAAE;IAC3C,MAAM,EAAE,IAAI,EAAO,4BAA4B;IAC/C,SAAS,EAAE,IAAI,EAAI,kCAAkC;CACtD,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAAC,SAAuB;IACpD,OAAO,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IAKrD,uDAAuD;IACvD,MAAM,cAAc,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;IAE1C,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,QAAQ;SACnB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,gEAAgE,QAAQ,2FAA2F;KAC7K,CAAC;AACJ,CAAC"}

package/dist/utils/user-context-scanner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * User context scanner
+ *
+ * Scan user-level Claude directories for plugins, skills, and marketplaces.
+ */
+import { type ScanResult } from '@vibe-agent-toolkit/discovery';
+/**
+ * Scan user-level Claude directories for skills and plugins
+ *
+ * Scans:
+ * - ~/.claude/plugins for SKILL.md and .claude-plugin directories
+ * - ~/.claude/skills for SKILL.md files
+ * - ~/.claude/marketplaces (reserved for future use)
+ *
+ * Returns empty arrays if directories don't exist (not an error).
+ *
+ * @returns Object containing separate arrays for plugins, skills, marketplaces
+ *
+ * @example
+ * ```typescript
+ * const context = await scanUserContext();
+ * console.log(`Found ${context.plugins.length} plugins`);
+ * console.log(`Found ${context.skills.length} skills`);
+ * ```
+ */
+export declare function scanUserContext(): Promise<{
+    plugins: ScanResult[];
+    skills: ScanResult[];
+    marketplaces: ScanResult[];
+}>;
+//# sourceMappingURL=user-context-scanner.d.ts.map

package/dist/utils/user-context-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-context-scanner.d.ts","sourceRoot":"","sources":["../../src/utils/user-context-scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAItE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B,CAAC,CAmCD"}

package/dist/utils/user-context-scanner.js

@@ -0,0 +1,60 @@
+/**
+ * User context scanner
+ *
+ * Scan user-level Claude directories for plugins, skills, and marketplaces.
+ */
+import { existsSync } from 'node:fs';
+import { scan } from '@vibe-agent-toolkit/discovery';
+import { getClaudeUserPaths } from './claude-paths.js';
+/**
+ * Scan user-level Claude directories for skills and plugins
+ *
+ * Scans:
+ * - ~/.claude/plugins for SKILL.md and .claude-plugin directories
+ * - ~/.claude/skills for SKILL.md files
+ * - ~/.claude/marketplaces (reserved for future use)
+ *
+ * Returns empty arrays if directories don't exist (not an error).
+ *
+ * @returns Object containing separate arrays for plugins, skills, marketplaces
+ *
+ * @example
+ * ```typescript
+ * const context = await scanUserContext();
+ * console.log(`Found ${context.plugins.length} plugins`);
+ * console.log(`Found ${context.skills.length} skills`);
+ * ```
+ */
+export async function scanUserContext() {
+    const { pluginsDir, skillsDir } = getClaudeUserPaths();
+    // Scan plugins directory (SKILL.md and .claude-plugin directories)
+    let plugins = [];
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- User's home directory is safe
+    if (existsSync(pluginsDir)) {
+        const pluginsScan = await scan({
+            path: pluginsDir,
+            recursive: true,
+            include: ['**/SKILL.md', '**/.claude-plugin/**'],
+        });
+        plugins = pluginsScan.results;
+    }
+    // Scan skills directory (SKILL.md files)
+    let skills = [];
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- User's home directory is safe
+    if (existsSync(skillsDir)) {
+        const skillsScan = await scan({
+            path: skillsDir,
+            recursive: true,
+            include: ['**/SKILL.md'],
+        });
+        skills = skillsScan.results;
+    }
+    // Marketplaces reserved for future use
+    const marketplaces = [];
+    return {
+        plugins,
+        skills,
+        marketplaces,
+    };
+}
+//# sourceMappingURL=user-context-scanner.js.map

package/dist/utils/user-context-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-context-scanner.js","sourceRoot":"","sources":["../../src/utils/user-context-scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,IAAI,EAAmB,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IAKnC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAEvD,mEAAmE;IACnE,IAAI,OAAO,GAAiB,EAAE,CAAC;IAC/B,oGAAoG;IACpG,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;YAC7B,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,CAAC,aAAa,EAAE,sBAAsB,CAAC;SACjD,CAAC,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,yCAAyC;IACzC,IAAI,MAAM,GAAiB,EAAE,CAAC;IAC9B,oGAAoG;IACpG,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC;YAC5B,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,CAAC,aAAa,CAAC;SACzB,CAAC,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,uCAAuC;IACvC,MAAM,YAAY,GAAiB,EAAE,CAAC;IAEtC,OAAO;QACL,OAAO;QACP,MAAM;QACN,YAAY;KACb,CAAC;AACJ,CAAC"}

package/docs/audit.md

@@ -224,6 +224,7 @@ Warnings indicate potential issues but don't prevent usage:
 | `SKILL_NAME_XML_TAGS` | error | Name contains XML-like tags | Remove XML tags from name |
 | `SKILL_DESCRIPTION_XML_TAGS` | error | Description contains XML-like tags | Remove XML tags from description |
 | `SKILL_DESCRIPTION_EMPTY` | error | Description is empty or whitespace | Provide meaningful description |
+| `SKILL_MISCONFIGURED_LOCATION` | error | Standalone skill in `~/.claude/plugins/` won't be recognized | Move to `~/.claude/skills/` for standalone skills, or add `.claude-plugin/plugin.json` for a proper plugin |
 | `PATH_STYLE_WINDOWS` | error | Windows-style backslashes in paths | Use forward slashes (/) instead |
 | `LINK_INTEGRITY_BROKEN` | error | Link to non-existent file | Fix or remove broken link |