@vibe-agent-toolkit/cli 0.1.9 → 0.1.12

package/dist/commands/skills/validate.js

@@ -0,0 +1,180 @@
+/**
+ * Skills validate command - validate skills for packaging
+ *
+ * Validates skills declared in package.json vat.skills using validateSkillForPackaging.
+ * Supports validation overrides and expiration checking.
+ */
+import { validateSkillForPackaging, } from '@vibe-agent-toolkit/agent-skills';
+import * as yaml from 'js-yaml';
+import { formatDurationSecs } from '../../utils/duration.js';
+import { filterSkillsByName, handleCommandError, setupCommandContext, } from './command-helpers.js';
+import { readPackageJson, validateSkillSource } from './shared.js';
+/**
+ * Strip excludedReferences from results metadata for non-verbose YAML output.
+ * Keeps excludedReferenceCount for summary info, but removes the full path list
+ * which can be noisy. Operates on a deep copy to avoid mutating original results.
+ */
+function stripExcludedReferencePaths(results) {
+    return results.map((result) => {
+        const { skillLines, totalLines, fileCount, directFileCount, maxLinkDepth, excludedReferenceCount } = result.metadata;
+        return {
+            ...result,
+            metadata: { skillLines, totalLines, fileCount, directFileCount, maxLinkDepth, excludedReferenceCount },
+        };
+    });
+}
+/**
+ * Output YAML summary to stdout
+ */
+function outputYamlSummary(results, duration, verbose) {
+    const outputResults = verbose ? results : stripExcludedReferencePaths(results);
+    const output = {
+        status: results.some((r) => r.status === 'error') ? 'error' : 'success',
+        skillsValidated: results.length,
+        results: outputResults,
+        durationSecs: formatDurationSecs(duration),
+    };
+    console.log(yaml.dump(output, { indent: 2, lineWidth: -1, noRefs: true }));
+}
+/**
+ * Output a single validation error
+ */
+function outputSingleError(error) {
+    console.error(`    [${String(error.code)}] ${String(error.message)}`);
+    if (error.location) {
+        console.error(`      Location: ${String(error.location)}`);
+    }
+    if (error.fix) {
+        console.error(`      Fix: ${String(error.fix)}`);
+    }
+}
+/**
+ * Output detailed errors for a skill
+ */
+function outputSkillErrors(result) {
+    console.error(`Skill: ${result.skillName}`);
+    // Show active errors
+    if (result.activeErrors.length > 0) {
+        console.error(`  Active errors (${result.activeErrors.length}):`);
+        for (const error of result.activeErrors) {
+            outputSingleError(error);
+        }
+    }
+    // Show ignored errors (with reasons)
+    if (result.ignoredErrors.length > 0) {
+        console.error(`  Ignored errors (${result.ignoredErrors.length}):`);
+        for (const { error, reason } of result.ignoredErrors) {
+            console.error(`    [${String(error.code)}] ${String(error.message)} (ignored: ${reason})`);
+        }
+    }
+    // Show expired overrides as errors
+    if (result.expiredOverrides.length > 0) {
+        console.error(`  Expired overrides (${result.expiredOverrides.length}):`);
+        for (const { error, reason, expiredDate } of result.expiredOverrides) {
+            console.error(`    [${String(error.code)}] ${String(error.message)}`);
+            console.error(`      Override expired: ${expiredDate} (reason: ${reason})`);
+        }
+    }
+    console.error('');
+}
+/**
+ * Output validation report to stdout (YAML) and stderr (human-readable)
+ */
+function outputValidationReport(results, duration, logger, verbose) {
+    // Output YAML to stdout (for programmatic parsing)
+    outputYamlSummary(results, duration, verbose);
+    // Output human-readable summary to stderr
+    const failedSkills = results.filter((r) => r.status === 'error');
+    if (failedSkills.length === 0) {
+        logger.info('\n✅ All validations passed');
+        return;
+    }
+    console.error('\n❌ Validation errors:\n');
+    for (const result of failedSkills) {
+        outputSkillErrors(result);
+    }
+}
+/**
+ * Log error status progress
+ */
+function logErrorProgress(skill, result, logger) {
+    const activeCount = result.activeErrors.length;
+    const ignoredCount = result.ignoredErrors.length;
+    const expiredCount = result.expiredOverrides.length;
+    if (activeCount > 0) {
+        logger.error(`   ❌ ${skill.name}: ${activeCount} error${activeCount === 1 ? '' : 's'}`);
+    }
+    if (ignoredCount > 0) {
+        logger.info(`      (${ignoredCount} ignored by overrides)`);
+    }
+    if (expiredCount > 0) {
+        logger.error(`      (${expiredCount} expired override${expiredCount === 1 ? '' : 's'})`);
+    }
+}
+/**
+ * Log success status progress
+ */
+function logSuccessProgress(skill, ignoredCount, logger) {
+    if (ignoredCount > 0) {
+        logger.info(`   ✅ ${skill.name} (${ignoredCount} ignored by overrides)`);
+    }
+    else {
+        logger.info(`   ✅ ${skill.name}`);
+    }
+}
+/**
+ * Log validation progress for a single skill
+ */
+function logSkillProgress(skill, result, logger) {
+    if (result.status === 'error') {
+        logErrorProgress(skill, result, logger);
+    }
+    else {
+        logSuccessProgress(skill, result.ignoredErrors.length, logger);
+    }
+}
+/**
+ * Validate a single skill
+ */
+async function validateSingleSkill(skill, cwd, logger) {
+    const sourcePath = validateSkillSource(skill, cwd, logger);
+    logger.info(`   Validating: ${skill.name}`);
+    logger.debug(`   Source: ${skill.source}`);
+    const result = await validateSkillForPackaging(sourcePath, skill);
+    logSkillProgress(skill, result, logger);
+    return result;
+}
+/**
+ * Skills validate command implementation
+ */
+export async function validateCommand(pathArg, options) {
+    const { logger, cwd, startTime } = setupCommandContext(pathArg, options.debug);
+    try {
+        // Read package.json and filter skills
+        const packageJson = await readPackageJson(cwd);
+        const skills = packageJson.vat?.skills ?? [];
+        if (skills.length === 0) {
+            logger.info('ℹ️  No skills found in package.json vat.skills');
+            logger.info('   To add skills, define them in package.json under the vat.skills field');
+            process.exit(0);
+        }
+        const skillsToValidate = filterSkillsByName(skills, options.skill);
+        logger.info(`🔍 Found ${skillsToValidate.length} skill(s) to validate\n`);
+        // Validate each skill
+        const results = [];
+        for (const skill of skillsToValidate) {
+            const result = await validateSingleSkill(skill, cwd, logger);
+            results.push(result);
+        }
+        // Output report and exit
+        const duration = Date.now() - startTime;
+        const verbose = options.verbose === true;
+        outputValidationReport(results, duration, logger, verbose);
+        const hasErrors = results.some((r) => r.activeErrors.length > 0 || r.expiredOverrides.length > 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 |