@agents-inc/cli 0.46.0 → 0.48.0

package/dist/commands/search.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/commands/search.tsx","../../src/cli/components/skill-search/index.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport { printTable } from \"@oclif/table\";\nimport { render } from \"ink\";\nimport path from \"path\";\nimport { sortBy } from \"remeda\";\n\nimport { BaseCommand } from \"../base-command.js\";\nimport { SkillSearch, type SkillSearchResult } from \"../components/skill-search/index.js\";\nimport type { SourcedSkill } from \"../components/skill-search/skill-search.js\";\nimport { DEFAULT_SKILLS_SUBDIR, LOCAL_SKILLS_PATH, STANDARD_FILES } from \"../consts.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\nimport { resolveAllSources, type SourceEntry } from \"../lib/configuration/index.js\";\nimport { loadSkillsMatrixFromSource, fetchFromSource } from \"../lib/loading/index.js\";\nimport type { CategoryPath, ResolvedSkill, SkillId } from \"../types/index.js\";\nimport { listDirectories, fileExists, copy, ensureDir } from \"../utils/fs.js\";\nimport { SUCCESS_MESSAGES, STATUS_MESSAGES, INFO_MESSAGES } from \"../utils/messages.js\";\n\nconst MAX_DESCRIPTION_WIDTH = 50;\n\nfunction truncate(str: string, maxLength: number): string {\n  if (str.length <= maxLength) return str;\n  return `${str.slice(0, maxLength - 3)}...`;\n}\n\nfunction matchesQuery(skill: ResolvedSkill, query: string): boolean {\n  const lowerQuery = query.toLowerCase();\n\n  if (skill.id.toLowerCase().includes(lowerQuery)) return true;\n  if (skill.displayName?.toLowerCase().includes(lowerQuery)) return true;\n  if (skill.description.toLowerCase().includes(lowerQuery)) return true;\n  if (skill.category.toLowerCase().includes(lowerQuery)) return true;\n\n  return skill.tags.some((tag) => tag.toLowerCase().includes(lowerQuery));\n}\n\nfunction matchesCategory(skill: ResolvedSkill, category: CategoryPath): boolean {\n  const lowerCategory = category.toLowerCase();\n  return skill.category.toLowerCase().includes(lowerCategory);\n}\n\nfunction toSourcedSkill(\n  skill: ResolvedSkill,\n  sourceName: string,\n  sourceUrl?: string,\n): SourcedSkill {\n  return {\n    ...skill,\n    sourceName,\n    sourceUrl,\n  };\n}\n\nasync function fetchSkillsFromSource(\n  source: SourceEntry,\n  forceRefresh: boolean,\n): Promise<SourcedSkill[]> {\n  try {\n    const result = await fetchFromSource(source.url, { forceRefresh });\n    const skillsDir = path.join(result.path, DEFAULT_SKILLS_SUBDIR);\n\n    if (!(await fileExists(skillsDir))) {\n      return [];\n    }\n\n    const skillDirs = await listDirectories(skillsDir);\n    const skills: SourcedSkill[] = [];\n\n    for (const skillDir of skillDirs) {\n      const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);\n      if (await fileExists(skillMdPath)) {\n        skills.push({\n          // Directory name is an untyped string — cast at data boundary\n          id: skillDir as SkillId,\n          description: `Skill from ${source.name}`,\n          // Synthetic category for third-party sources — not in CategoryPath union\n          category: \"imported\" as CategoryPath,\n          categoryExclusive: false,\n          tags: [],\n          author: `@${source.name}`,\n          conflictsWith: [],\n          recommends: [],\n          requires: [],\n          alternatives: [],\n          discourages: [],\n          compatibleWith: [],\n          requiresSetup: [],\n          providesSetupFor: [],\n          sourceName: source.name,\n          sourceUrl: source.url,\n          path: path.join(skillsDir, skillDir),\n        });\n      }\n    }\n\n    return skills;\n  } catch {\n    // Source unavailable, return empty\n    return [];\n  }\n}\n\nexport default class Search extends BaseCommand {\n  static summary = \"Search available skills\";\n  static description =\n    \"Search skills by ID, alias, description, category, or tags. \" +\n    \"Run without arguments or with -i for interactive mode with multi-select.\";\n\n  static examples = [\n    {\n      description: \"Search for React skills\",\n      command: \"<%= config.bin %> search react\",\n    },\n    {\n      description: \"Interactive search mode\",\n      command: \"<%= config.bin %> search\",\n    },\n    {\n      description: \"Interactive with pre-filled query\",\n      command: \"<%= config.bin %> search -i react\",\n    },\n    {\n      description: \"Search with category filter\",\n      command: \"<%= config.bin %> search state -c frontend\",\n    },\n  ];\n\n  static args = {\n    query: Args.string({\n      description: \"Search query (matches name, description, category, tags)\",\n      required: false,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    interactive: Flags.boolean({\n      char: \"i\",\n      description: \"Launch interactive search with multi-select\",\n      default: false,\n    }),\n    category: Flags.string({\n      char: \"c\",\n      description: \"Filter by category\",\n      required: false,\n    }),\n    refresh: Flags.boolean({\n      description: \"Force refresh from remote sources\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(Search);\n    const projectDir = process.cwd();\n\n    const isInteractive = flags.interactive || !args.query;\n\n    if (isInteractive) {\n      await this.runInteractive(args.query, flags.refresh, projectDir);\n    } else {\n      await this.runStatic(args.query!, flags);\n    }\n  }\n\n  private async runInteractive(\n    initialQuery: string | undefined,\n    forceRefresh: boolean,\n    projectDir: string,\n  ): Promise<void> {\n    this.log(\"Loading skills from all sources...\");\n\n    try {\n      const { matrix, sourcePath } = await loadSkillsMatrixFromSource({\n        sourceFlag: undefined,\n        projectDir,\n        forceRefresh,\n      });\n\n      const primarySkills = Object.values(matrix.skills)\n        .filter((skill): skill is ResolvedSkill => skill !== undefined)\n        .map((skill) => toSourcedSkill(skill, \"marketplace\", sourcePath));\n\n      const { extras } = await resolveAllSources(projectDir);\n\n      const extraSkillArrays = await Promise.all(\n        extras.map((source) => fetchSkillsFromSource(source, forceRefresh)),\n      );\n\n      const allSkills: SourcedSkill[] = [...primarySkills, ...extraSkillArrays.flat()];\n      const sourceCount = 1 + extras.length;\n\n      this.log(`Loaded ${allSkills.length} skills from ${sourceCount} source(s)`);\n      this.log(\"\");\n\n      const searchResultPromise = new Promise<SkillSearchResult>((resolve) => {\n        const { waitUntilExit } = render(\n          <SkillSearch\n            skills={allSkills}\n            sourceCount={sourceCount}\n            initialQuery={initialQuery}\n            onComplete={(result) => {\n              resolve(result);\n            }}\n            onCancel={() => {\n              resolve({ selectedSkills: [], cancelled: true });\n            }}\n          />,\n        );\n\n        waitUntilExit().then(() => {\n          resolve({ selectedSkills: [], cancelled: true });\n        });\n      });\n\n      const searchResult = await searchResultPromise;\n\n      if (searchResult.cancelled) {\n        this.log(\"Search cancelled\");\n        this.exit(EXIT_CODES.CANCELLED);\n      }\n\n      if (searchResult.selectedSkills.length === 0) {\n        this.log(\"No skills selected\");\n        return;\n      }\n\n      this.log(\"\");\n      this.log(`Importing ${searchResult.selectedSkills.length} skill(s)...`);\n\n      const destDir = path.join(projectDir, LOCAL_SKILLS_PATH);\n\n      for (const skill of searchResult.selectedSkills) {\n        if (skill.path) {\n          const destPath = path.join(destDir, skill.id);\n          await ensureDir(path.dirname(destPath));\n          await copy(skill.path, destPath);\n          this.logSuccess(`Imported: ${skill.id}`);\n        } else {\n          this.warn(`Skipping ${skill.id}: No source path available`);\n        }\n      }\n\n      this.log(\"\");\n      this.logSuccess(SUCCESS_MESSAGES.IMPORT_COMPLETE);\n      this.log(`Skills location: ${destDir}`);\n      this.log(INFO_MESSAGES.RUN_COMPILE);\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  private async runStatic(\n    query: string,\n    flags: { source?: string; category?: string },\n  ): Promise<void> {\n    try {\n      this.log(STATUS_MESSAGES.LOADING_SKILLS);\n\n      const { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({\n        sourceFlag: flags.source,\n      });\n\n      this.log(`Loaded from ${isLocal ? \"local\" : \"remote\"}: ${sourcePath}`);\n\n      const allSkills = Object.values(matrix.skills).filter(\n        (skill): skill is ResolvedSkill => skill !== undefined,\n      );\n\n      let results = allSkills.filter((skill) => matchesQuery(skill, query));\n\n      if (flags.category) {\n        // CLI flag is an untyped string — cast at data boundary\n        results = results.filter((skill) => matchesCategory(skill, flags.category as CategoryPath));\n      }\n\n      results = sortBy(results, (r) => r.displayName || r.id);\n\n      this.log(\"\");\n      if (results.length === 0) {\n        this.warn(`No skills found matching \"${query}\"`);\n        if (flags.category) {\n          this.logInfo(`Category filter: ${flags.category}`);\n        }\n      } else {\n        this.logInfo(\n          `Found ${results.length} skill${results.length === 1 ? \"\" : \"s\"} matching \"${query}\"`,\n        );\n        if (flags.category) {\n          this.logInfo(`Category filter: ${flags.category}`);\n        }\n        this.log(\"\");\n\n        printTable({\n          data: results.map((skill) => ({\n            id: skill.displayName || skill.id,\n            category: skill.category,\n            description: truncate(skill.description, MAX_DESCRIPTION_WIDTH),\n          })),\n          columns: [\n            { key: \"id\", name: \"ID\" },\n            { key: \"category\", name: \"Category\" },\n            { key: \"description\", name: \"Description\" },\n          ],\n          headerOptions: { bold: true },\n        });\n      }\n      this.log(\"\");\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n}\n","export { SkillSearch, type SkillSearchResult } from \"./skill-search.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,SAAS,MAAM,aAAa;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,cAAc;AACvB,OAAO,UAAU;AACjB,SAAS,cAAc;;;ACJvB;;;ADoMU;AAnLV,IAAM,wBAAwB;AAE9B,SAAS,SAAS,KAAa,WAA2B;AACxD,MAAI,IAAI,UAAU,UAAW,QAAO;AACpC,SAAO,GAAG,IAAI,MAAM,GAAG,YAAY,CAAC,CAAC;AACvC;AAEA,SAAS,aAAa,OAAsB,OAAwB;AAClE,QAAM,aAAa,MAAM,YAAY;AAErC,MAAI,MAAM,GAAG,YAAY,EAAE,SAAS,UAAU,EAAG,QAAO;AACxD,MAAI,MAAM,aAAa,YAAY,EAAE,SAAS,UAAU,EAAG,QAAO;AAClE,MAAI,MAAM,YAAY,YAAY,EAAE,SAAS,UAAU,EAAG,QAAO;AACjE,MAAI,MAAM,SAAS,YAAY,EAAE,SAAS,UAAU,EAAG,QAAO;AAE9D,SAAO,MAAM,KAAK,KAAK,CAAC,QAAQ,IAAI,YAAY,EAAE,SAAS,UAAU,CAAC;AACxE;AAEA,SAAS,gBAAgB,OAAsB,UAAiC;AAC9E,QAAM,gBAAgB,SAAS,YAAY;AAC3C,SAAO,MAAM,SAAS,YAAY,EAAE,SAAS,aAAa;AAC5D;AAEA,SAAS,eACP,OACA,YACA,WACc;AACd,SAAO;AAAA,IACL,GAAG;AAAA,IACH;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAe,sBACb,QACA,cACyB;AACzB,MAAI;AACF,UAAM,SAAS,MAAM,gBAAgB,OAAO,KAAK,EAAE,aAAa,CAAC;AACjE,UAAM,YAAY,KAAK,KAAK,OAAO,MAAM,qBAAqB;AAE9D,QAAI,CAAE,MAAM,WAAW,SAAS,GAAI;AAClC,aAAO,CAAC;AAAA,IACV;AAEA,UAAM,YAAY,MAAM,gBAAgB,SAAS;AACjD,UAAM,SAAyB,CAAC;AAEhC,eAAW,YAAY,WAAW;AAChC,YAAM,cAAc,KAAK,KAAK,WAAW,UAAU,eAAe,QAAQ;AAC1E,UAAI,MAAM,WAAW,WAAW,GAAG;AACjC,eAAO,KAAK;AAAA;AAAA,UAEV,IAAI;AAAA,UACJ,aAAa,cAAc,OAAO,IAAI;AAAA;AAAA,UAEtC,UAAU;AAAA,UACV,mBAAmB;AAAA,UACnB,MAAM,CAAC;AAAA,UACP,QAAQ,IAAI,OAAO,IAAI;AAAA,UACvB,eAAe,CAAC;AAAA,UAChB,YAAY,CAAC;AAAA,UACb,UAAU,CAAC;AAAA,UACX,cAAc,CAAC;AAAA,UACf,aAAa,CAAC;AAAA,UACd,gBAAgB,CAAC;AAAA,UACjB,eAAe,CAAC;AAAA,UAChB,kBAAkB,CAAC;AAAA,UACnB,YAAY,OAAO;AAAA,UACnB,WAAW,OAAO;AAAA,UAClB,MAAM,KAAK,KAAK,WAAW,QAAQ;AAAA,QACrC,CAAC;AAAA,MACH;AAAA,IACF;AAEA,WAAO;AAAA,EACT,QAAQ;AAEN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,IAAqB,SAArB,MAAqB,gBAAe,YAAY;AAAA,EAC9C,OAAO,UAAU;AAAA,EACjB,OAAO,cACL;AAAA,EAGF,OAAO,WAAW;AAAA,IAChB;AAAA,MACE,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EAEA,OAAO,OAAO;AAAA,IACZ,OAAO,KAAK,OAAO;AAAA,MACjB,aAAa;AAAA,MACb,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAAA,EAEA,OAAO,QAAQ;AAAA,IACb,GAAG,YAAY;AAAA,IACf,aAAa,MAAM,QAAQ;AAAA,MACzB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,IACD,UAAU,MAAM,OAAO;AAAA,MACrB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ,CAAC;AAAA,IACD,SAAS,MAAM,QAAQ;AAAA,MACrB,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,KAAK,MAAM,OAAM;AAC/C,UAAM,aAAa,QAAQ,IAAI;AAE/B,UAAM,gBAAgB,MAAM,eAAe,CAAC,KAAK;AAEjD,QAAI,eAAe;AACjB,YAAM,KAAK,eAAe,KAAK,OAAO,MAAM,SAAS,UAAU;AAAA,IACjE,OAAO;AACL,YAAM,KAAK,UAAU,KAAK,OAAQ,KAAK;AAAA,IACzC;AAAA,EACF;AAAA,EAEA,MAAc,eACZ,cACA,cACA,YACe;AACf,SAAK,IAAI,oCAAoC;AAE7C,QAAI;AACF,YAAM,EAAE,QAAQ,WAAW,IAAI,MAAM,2BAA2B;AAAA,QAC9D,YAAY;AAAA,QACZ;AAAA,QACA;AAAA,MACF,CAAC;AAED,YAAM,gBAAgB,OAAO,OAAO,OAAO,MAAM,EAC9C,OAAO,CAAC,UAAkC,UAAU,MAAS,EAC7D,IAAI,CAAC,UAAU,eAAe,OAAO,eAAe,UAAU,CAAC;AAElE,YAAM,EAAE,OAAO,IAAI,MAAM,kBAAkB,UAAU;AAErD,YAAM,mBAAmB,MAAM,QAAQ;AAAA,QACrC,OAAO,IAAI,CAAC,WAAW,sBAAsB,QAAQ,YAAY,CAAC;AAAA,MACpE;AAEA,YAAM,YAA4B,CAAC,GAAG,eAAe,GAAG,iBAAiB,KAAK,CAAC;AAC/E,YAAM,cAAc,IAAI,OAAO;AAE/B,WAAK,IAAI,UAAU,UAAU,MAAM,gBAAgB,WAAW,YAAY;AAC1E,WAAK,IAAI,EAAE;AAEX,YAAM,sBAAsB,IAAI,QAA2B,CAAC,YAAY;AACtE,cAAM,EAAE,cAAc,IAAI;AAAA,UACxB;AAAA,YAAC;AAAA;AAAA,cACC,QAAQ;AAAA,cACR;AAAA,cACA;AAAA,cACA,YAAY,CAAC,WAAW;AACtB,wBAAQ,MAAM;AAAA,cAChB;AAAA,cACA,UAAU,MAAM;AACd,wBAAQ,EAAE,gBAAgB,CAAC,GAAG,WAAW,KAAK,CAAC;AAAA,cACjD;AAAA;AAAA,UACF;AAAA,QACF;AAEA,sBAAc,EAAE,KAAK,MAAM;AACzB,kBAAQ,EAAE,gBAAgB,CAAC,GAAG,WAAW,KAAK,CAAC;AAAA,QACjD,CAAC;AAAA,MACH,CAAC;AAED,YAAM,eAAe,MAAM;AAE3B,UAAI,aAAa,WAAW;AAC1B,aAAK,IAAI,kBAAkB;AAC3B,aAAK,KAAK,WAAW,SAAS;AAAA,MAChC;AAEA,UAAI,aAAa,eAAe,WAAW,GAAG;AAC5C,aAAK,IAAI,oBAAoB;AAC7B;AAAA,MACF;AAEA,WAAK,IAAI,EAAE;AACX,WAAK,IAAI,aAAa,aAAa,eAAe,MAAM,cAAc;AAEtE,YAAM,UAAU,KAAK,KAAK,YAAY,iBAAiB;AAEvD,iBAAW,SAAS,aAAa,gBAAgB;AAC/C,YAAI,MAAM,MAAM;AACd,gBAAM,WAAW,KAAK,KAAK,SAAS,MAAM,EAAE;AAC5C,gBAAM,UAAU,KAAK,QAAQ,QAAQ,CAAC;AACtC,gBAAM,KAAK,MAAM,MAAM,QAAQ;AAC/B,eAAK,WAAW,aAAa,MAAM,EAAE,EAAE;AAAA,QACzC,OAAO;AACL,eAAK,KAAK,YAAY,MAAM,EAAE,4BAA4B;AAAA,QAC5D;AAAA,MACF;AAEA,WAAK,IAAI,EAAE;AACX,WAAK,WAAW,iBAAiB,eAAe;AAChD,WAAK,IAAI,oBAAoB,OAAO,EAAE;AACtC,WAAK,IAAI,cAAc,WAAW;AAAA,IACpC,SAAS,OAAO;AACd,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAc,UACZ,OACA,OACe;AACf,QAAI;AACF,WAAK,IAAI,gBAAgB,cAAc;AAEvC,YAAM,EAAE,QAAQ,YAAY,QAAQ,IAAI,MAAM,2BAA2B;AAAA,QACvE,YAAY,MAAM;AAAA,MACpB,CAAC;AAED,WAAK,IAAI,eAAe,UAAU,UAAU,QAAQ,KAAK,UAAU,EAAE;AAErE,YAAM,YAAY,OAAO,OAAO,OAAO,MAAM,EAAE;AAAA,QAC7C,CAAC,UAAkC,UAAU;AAAA,MAC/C;AAEA,UAAI,UAAU,UAAU,OAAO,CAAC,UAAU,aAAa,OAAO,KAAK,CAAC;AAEpE,UAAI,MAAM,UAAU;AAElB,kBAAU,QAAQ,OAAO,CAAC,UAAU,gBAAgB,OAAO,MAAM,QAAwB,CAAC;AAAA,MAC5F;AAEA,gBAAU,OAAO,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE;AAEtD,WAAK,IAAI,EAAE;AACX,UAAI,QAAQ,WAAW,GAAG;AACxB,aAAK,KAAK,6BAA6B,KAAK,GAAG;AAC/C,YAAI,MAAM,UAAU;AAClB,eAAK,QAAQ,oBAAoB,MAAM,QAAQ,EAAE;AAAA,QACnD;AAAA,MACF,OAAO;AACL,aAAK;AAAA,UACH,SAAS,QAAQ,MAAM,SAAS,QAAQ,WAAW,IAAI,KAAK,GAAG,cAAc,KAAK;AAAA,QACpF;AACA,YAAI,MAAM,UAAU;AAClB,eAAK,QAAQ,oBAAoB,MAAM,QAAQ,EAAE;AAAA,QACnD;AACA,aAAK,IAAI,EAAE;AAEX,mBAAW;AAAA,UACT,MAAM,QAAQ,IAAI,CAAC,WAAW;AAAA,YAC5B,IAAI,MAAM,eAAe,MAAM;AAAA,YAC/B,UAAU,MAAM;AAAA,YAChB,aAAa,SAAS,MAAM,aAAa,qBAAqB;AAAA,UAChE,EAAE;AAAA,UACF,SAAS;AAAA,YACP,EAAE,KAAK,MAAM,MAAM,KAAK;AAAA,YACxB,EAAE,KAAK,YAAY,MAAM,WAAW;AAAA,YACpC,EAAE,KAAK,eAAe,MAAM,cAAc;AAAA,UAC5C;AAAA,UACA,eAAe,EAAE,MAAM,KAAK;AAAA,QAC9B,CAAC;AAAA,MACH;AACA,WAAK,IAAI,EAAE;AAAA,IACb,SAAS,OAAO;AACd,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/cli/commands/search.tsx","../../src/cli/components/skill-search/index.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport { printTable } from \"@oclif/table\";\nimport { render } from \"ink\";\nimport path from \"path\";\nimport { sortBy } from \"remeda\";\n\nimport { BaseCommand } from \"../base-command.js\";\nimport { SkillSearch, type SkillSearchResult } from \"../components/skill-search/index.js\";\nimport type { SourcedSkill } from \"../components/skill-search/skill-search.js\";\nimport { DEFAULT_SKILLS_SUBDIR, LOCAL_SKILLS_PATH, STANDARD_FILES } from \"../consts.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\nimport { resolveAllSources, type SourceEntry } from \"../lib/configuration/index.js\";\nimport { loadSkillsMatrixFromSource, fetchFromSource } from \"../lib/loading/index.js\";\nimport type { CategoryPath, ResolvedSkill, SkillId } from \"../types/index.js\";\nimport { listDirectories, fileExists, copy, ensureDir } from \"../utils/fs.js\";\nimport { SUCCESS_MESSAGES, STATUS_MESSAGES, INFO_MESSAGES } from \"../utils/messages.js\";\n\nconst MAX_DESCRIPTION_WIDTH = 50;\n\nfunction truncate(str: string, maxLength: number): string {\n  if (str.length <= maxLength) return str;\n  return `${str.slice(0, maxLength - 3)}...`;\n}\n\nfunction matchesQuery(skill: ResolvedSkill, query: string): boolean {\n  const lowerQuery = query.toLowerCase();\n\n  if (skill.id.toLowerCase().includes(lowerQuery)) return true;\n  if (skill.displayName?.toLowerCase().includes(lowerQuery)) return true;\n  if (skill.description.toLowerCase().includes(lowerQuery)) return true;\n  if (skill.category.toLowerCase().includes(lowerQuery)) return true;\n\n  return skill.tags.some((tag) => tag.toLowerCase().includes(lowerQuery));\n}\n\nfunction matchesCategory(skill: ResolvedSkill, category: CategoryPath): boolean {\n  const lowerCategory = category.toLowerCase();\n  return skill.category.toLowerCase().includes(lowerCategory);\n}\n\nfunction toSourcedSkill(\n  skill: ResolvedSkill,\n  sourceName: string,\n  sourceUrl?: string,\n): SourcedSkill {\n  return {\n    ...skill,\n    sourceName,\n    sourceUrl,\n  };\n}\n\nasync function fetchSkillsFromSource(\n  source: SourceEntry,\n  forceRefresh: boolean,\n): Promise<SourcedSkill[]> {\n  try {\n    const result = await fetchFromSource(source.url, { forceRefresh });\n    const skillsDir = path.join(result.path, DEFAULT_SKILLS_SUBDIR);\n\n    if (!(await fileExists(skillsDir))) {\n      return [];\n    }\n\n    const skillDirs = await listDirectories(skillsDir);\n    const skills: SourcedSkill[] = [];\n\n    for (const skillDir of skillDirs) {\n      const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);\n      if (await fileExists(skillMdPath)) {\n        skills.push({\n          // Directory name is an untyped string — cast at data boundary\n          id: skillDir as SkillId,\n          description: `Skill from ${source.name}`,\n          // Synthetic category for third-party sources — not in CategoryPath union\n          category: \"imported\" as CategoryPath,\n          tags: [],\n          author: `@${source.name}`,\n          conflictsWith: [],\n          recommends: [],\n          requires: [],\n          alternatives: [],\n          discourages: [],\n          compatibleWith: [],\n          requiresSetup: [],\n          providesSetupFor: [],\n          sourceName: source.name,\n          sourceUrl: source.url,\n          path: path.join(skillsDir, skillDir),\n        });\n      }\n    }\n\n    return skills;\n  } catch {\n    // Source unavailable, return empty\n    return [];\n  }\n}\n\nexport default class Search extends BaseCommand {\n  static summary = \"Search available skills\";\n  static description =\n    \"Search skills by ID, alias, description, category, or tags. \" +\n    \"Run without arguments or with -i for interactive mode with multi-select.\";\n\n  static examples = [\n    {\n      description: \"Search for React skills\",\n      command: \"<%= config.bin %> search react\",\n    },\n    {\n      description: \"Interactive search mode\",\n      command: \"<%= config.bin %> search\",\n    },\n    {\n      description: \"Interactive with pre-filled query\",\n      command: \"<%= config.bin %> search -i react\",\n    },\n    {\n      description: \"Search with category filter\",\n      command: \"<%= config.bin %> search state -c frontend\",\n    },\n  ];\n\n  static args = {\n    query: Args.string({\n      description: \"Search query (matches name, description, category, tags)\",\n      required: false,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    interactive: Flags.boolean({\n      char: \"i\",\n      description: \"Launch interactive search with multi-select\",\n      default: false,\n    }),\n    category: Flags.string({\n      char: \"c\",\n      description: \"Filter by category\",\n      required: false,\n    }),\n    refresh: Flags.boolean({\n      description: \"Force refresh from remote sources\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(Search);\n    const projectDir = process.cwd();\n\n    const isInteractive = flags.interactive || !args.query;\n\n    if (isInteractive) {\n      await this.runInteractive(args.query, flags.refresh, projectDir);\n    } else {\n      await this.runStatic(args.query!, flags);\n    }\n  }\n\n  private async runInteractive(\n    initialQuery: string | undefined,\n    forceRefresh: boolean,\n    projectDir: string,\n  ): Promise<void> {\n    this.log(\"Loading skills from all sources...\");\n\n    try {\n      const { matrix, sourcePath } = await loadSkillsMatrixFromSource({\n        sourceFlag: undefined,\n        projectDir,\n        forceRefresh,\n      });\n\n      const primarySkills = Object.values(matrix.skills)\n        .filter((skill): skill is ResolvedSkill => skill !== undefined)\n        .map((skill) => toSourcedSkill(skill, \"marketplace\", sourcePath));\n\n      const { extras } = await resolveAllSources(projectDir);\n\n      const extraSkillArrays = await Promise.all(\n        extras.map((source) => fetchSkillsFromSource(source, forceRefresh)),\n      );\n\n      const allSkills: SourcedSkill[] = [...primarySkills, ...extraSkillArrays.flat()];\n      const sourceCount = 1 + extras.length;\n\n      this.log(`Loaded ${allSkills.length} skills from ${sourceCount} source(s)`);\n      this.log(\"\");\n\n      const searchResultPromise = new Promise<SkillSearchResult>((resolve) => {\n        const { waitUntilExit } = render(\n          <SkillSearch\n            skills={allSkills}\n            sourceCount={sourceCount}\n            initialQuery={initialQuery}\n            onComplete={(result) => {\n              resolve(result);\n            }}\n            onCancel={() => {\n              resolve({ selectedSkills: [], cancelled: true });\n            }}\n          />,\n        );\n\n        waitUntilExit().then(() => {\n          resolve({ selectedSkills: [], cancelled: true });\n        });\n      });\n\n      const searchResult = await searchResultPromise;\n\n      if (searchResult.cancelled) {\n        this.log(\"Search cancelled\");\n        this.exit(EXIT_CODES.CANCELLED);\n      }\n\n      if (searchResult.selectedSkills.length === 0) {\n        this.log(\"No skills selected\");\n        return;\n      }\n\n      this.log(\"\");\n      this.log(`Importing ${searchResult.selectedSkills.length} skill(s)...`);\n\n      const destDir = path.join(projectDir, LOCAL_SKILLS_PATH);\n\n      for (const skill of searchResult.selectedSkills) {\n        if (skill.path) {\n          const destPath = path.join(destDir, skill.id);\n          await ensureDir(path.dirname(destPath));\n          await copy(skill.path, destPath);\n          this.logSuccess(`Imported: ${skill.id}`);\n        } else {\n          this.warn(`Skipping ${skill.id}: No source path available`);\n        }\n      }\n\n      this.log(\"\");\n      this.logSuccess(SUCCESS_MESSAGES.IMPORT_COMPLETE);\n      this.log(`Skills location: ${destDir}`);\n      this.log(INFO_MESSAGES.RUN_COMPILE);\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  private async runStatic(\n    query: string,\n    flags: { source?: string; category?: string },\n  ): Promise<void> {\n    try {\n      this.log(STATUS_MESSAGES.LOADING_SKILLS);\n\n      const { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({\n        sourceFlag: flags.source,\n      });\n\n      this.log(`Loaded from ${isLocal ? \"local\" : \"remote\"}: ${sourcePath}`);\n\n      const allSkills = Object.values(matrix.skills).filter(\n        (skill): skill is ResolvedSkill => skill !== undefined,\n      );\n\n      let results = allSkills.filter((skill) => matchesQuery(skill, query));\n\n      if (flags.category) {\n        // CLI flag is an untyped string — cast at data boundary\n        results = results.filter((skill) => matchesCategory(skill, flags.category as CategoryPath));\n      }\n\n      results = sortBy(results, (r) => r.displayName || r.id);\n\n      this.log(\"\");\n      if (results.length === 0) {\n        this.warn(`No skills found matching \"${query}\"`);\n        if (flags.category) {\n          this.logInfo(`Category filter: ${flags.category}`);\n        }\n      } else {\n        this.logInfo(\n          `Found ${results.length} skill${results.length === 1 ? \"\" : \"s\"} matching \"${query}\"`,\n        );\n        if (flags.category) {\n          this.logInfo(`Category filter: ${flags.category}`);\n        }\n        this.log(\"\");\n\n        printTable({\n          data: results.map((skill) => ({\n            id: skill.displayName || skill.id,\n            category: skill.category,\n            description: truncate(skill.description, MAX_DESCRIPTION_WIDTH),\n          })),\n          columns: [\n            { key: \"id\", name: \"ID\" },\n            { key: \"category\", name: \"Category\" },\n            { key: \"description\", name: \"Description\" },\n          ],\n          headerOptions: { bold: true },\n        });\n      }\n      this.log(\"\");\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n}\n","export { SkillSearch, type SkillSearchResult } from \"./skill-search.js\";\n"],"mappings":"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","names":[]}

package/dist/commands/uninstall.js

@@ -5,35 +5,35 @@ import {
 import {
   claudePluginUninstall,
   isClaudeCLIAvailable
-} from "../chunk-QBUOZVNZ.js";
+} from "../chunk-YDASDMTH.js";
 import {
   DRY_RUN_MESSAGES,
   INFO_MESSAGES,
   SUCCESS_MESSAGES
-} from "../chunk-G2WNOT3R.js";
+} from "../chunk-DG2U2WY3.js";
 import {
   BaseCommand,
   EXIT_CODES
-} from "../chunk-LFZXMQOH.js";
+} from "../chunk-2BVZOYJP.js";
 import {
   getProjectPluginsDir,
   listPluginNames,
   loadProjectSourceConfig,
   readForkedFromMetadata
-} from "../chunk-RT6IBH37.js";
+} from "../chunk-P2SFRDWI.js";
 import "../chunk-T4EXUIBY.js";
 import {
   directoryExists,
   getErrorMessage,
   listDirectories,
   remove
-} from "../chunk-5QRJUBK7.js";
+} from "../chunk-YMUWTPOM.js";
 import {
   CLAUDE_DIR,
   CLAUDE_SRC_DIR,
   CLI_COLORS,
   DEFAULT_BRANDING
-} from "../chunk-74HSA7C4.js";
+} from "../chunk-LESHL6SM.js";
 import {
   init_esm_shims
 } from "../chunk-DHET7RCE.js";

package/dist/commands/update.js

@@ -4,32 +4,32 @@ import {
 } from "../chunk-N6S7ZRIL.js";
 import {
   recompileAgents
-} from "../chunk-PZLUO4OY.js";
+} from "../chunk-AXV7NFFJ.js";
 import {
   ERROR_MESSAGES,
   INFO_MESSAGES,
   STATUS_MESSAGES,
   SUCCESS_MESSAGES
-} from "../chunk-G2WNOT3R.js";
+} from "../chunk-DG2U2WY3.js";
 import {
   BaseCommand,
   EXIT_CODES
-} from "../chunk-LFZXMQOH.js";
+} from "../chunk-2BVZOYJP.js";
 import {
   compareLocalSkillsWithSource,
   injectForkedFromMetadata,
   loadSkillsMatrixFromSource
-} from "../chunk-RT6IBH37.js";
+} from "../chunk-P2SFRDWI.js";
 import "../chunk-T4EXUIBY.js";
 import {
   copy,
   fileExists,
   getErrorMessage
-} from "../chunk-5QRJUBK7.js";
+} from "../chunk-YMUWTPOM.js";
 import {
   CLI_BIN_NAME,
   LOCAL_SKILLS_PATH
-} from "../chunk-74HSA7C4.js";
+} from "../chunk-LESHL6SM.js";
 import {
   init_esm_shims
 } from "../chunk-DHET7RCE.js";

package/dist/commands/validate.js

@@ -1,38 +1,52 @@
 #!/usr/bin/env node
 import {
   ERROR_MESSAGES
-} from "../chunk-G2WNOT3R.js";
+} from "../chunk-DG2U2WY3.js";
 import {
   BaseCommand,
   EXIT_CODES
-} from "../chunk-LFZXMQOH.js";
+} from "../chunk-2BVZOYJP.js";
 import {
+  checkMatrixHealth,
+  extractAllSkills,
   extractFrontmatter,
+  loadProjectSourceConfig,
+  loadSkillCategories,
+  loadSkillRules,
+  mergeMatrixWithSkills,
+  parseFrontmatter,
   printPluginValidationResult,
   validateAllPlugins,
   validatePlugin
-} from "../chunk-RT6IBH37.js";
+} from "../chunk-P2SFRDWI.js";
 import "../chunk-T4EXUIBY.js";
 import {
+  SKILL_ID_PATTERN,
   agentFrontmatterValidationSchema,
   agentYamlGenerationSchema,
+  directoryExists,
   fileExists,
   getErrorMessage,
+  glob,
   log,
   metadataValidationSchema,
   pluginManifestSchema,
   projectSourceConfigSchema,
   readFile,
+  skillCategoriesFileSchema,
   skillFrontmatterValidationSchema,
-  skillsMatrixConfigSchema,
+  skillRulesFileSchema,
   stackConfigValidationSchema,
-  stacksConfigSchema
-} from "../chunk-5QRJUBK7.js";
+  stacksConfigSchema,
+  verbose
+} from "../chunk-YMUWTPOM.js";
 import {
   CLAUDE_DIR,
   CLAUDE_SRC_DIR,
+  SKILL_CATEGORIES_YAML_PATH,
+  SKILL_RULES_YAML_PATH,
   STANDARD_FILES
-} from "../chunk-74HSA7C4.js";
+} from "../chunk-LESHL6SM.js";
 import {
   init_esm_shims
 } from "../chunk-DHET7RCE.js";
@@ -40,7 +54,7 @@ import {
 // src/cli/commands/validate.ts
 init_esm_shims();
 import { Args, Flags } from "@oclif/core";
-import path2 from "path";
+import path3 from "path";
 
 // src/cli/lib/schema-validator.ts
 init_esm_shims();
@@ -50,10 +64,16 @@ import { parse as parseYaml } from "yaml";
 import fg from "fast-glob";
 var VALIDATION_TARGETS = [
   {
-    name: "Skills Matrix",
-    schema: skillsMatrixConfigSchema,
-    pattern: STANDARD_FILES.SKILLS_MATRIX_YAML,
-    baseDir: "src/config"
+    name: "Skill Categories",
+    schema: skillCategoriesFileSchema,
+    pattern: STANDARD_FILES.SKILL_CATEGORIES_YAML,
+    baseDir: "config"
+  },
+  {
+    name: "Skill Rules",
+    schema: skillRulesFileSchema,
+    pattern: STANDARD_FILES.SKILL_RULES_YAML,
+    baseDir: "config"
   },
   {
     name: "Skill Metadata",
@@ -135,11 +155,11 @@ var VALIDATION_TARGETS = [
 ];
 function formatZodErrors(error) {
   return error.issues.map((issue) => {
-    const path3 = issue.path.join(".");
+    const path4 = issue.path.join(".");
     if (issue.code === "unrecognized_keys") {
       return `Unrecognized key: "${issue.keys.join('", "')}"`;
     }
-    return path3 ? `${path3}: ${issue.message}` : issue.message;
+    return path4 ? `${path4}: ${issue.message}` : issue.message;
   });
 }
 async function validateFile(filePath, schema, extractor) {
@@ -246,15 +266,203 @@ function printValidationResults(result) {
   }
 }
 
+// src/cli/lib/source-validator.ts
+init_esm_shims();
+import path2 from "path";
+import { parse as parseYaml2 } from "yaml";
+function isSnakeCase(key) {
+  return /[a-z]_[a-z]/.test(key);
+}
+async function validateSource(sourcePath) {
+  const issues = [];
+  const resolvedPath = path2.isAbsolute(sourcePath) ? sourcePath : path2.resolve(sourcePath);
+  if (!await directoryExists(resolvedPath)) {
+    issues.push({
+      severity: "error",
+      file: resolvedPath,
+      message: "Source directory does not exist"
+    });
+    return buildResult(issues, 0);
+  }
+  const sourceProjectConfig = await loadProjectSourceConfig(resolvedPath);
+  const skillsDirRelPath = sourceProjectConfig?.skillsDir ?? "src/skills";
+  const skillsDir = path2.join(resolvedPath, skillsDirRelPath);
+  if (!await directoryExists(skillsDir)) {
+    issues.push({
+      severity: "error",
+      file: skillsDir,
+      message: "Skills directory does not exist"
+    });
+    return buildResult(issues, 0);
+  }
+  const skillMdFiles = await glob(`**/${STANDARD_FILES.SKILL_MD}`, skillsDir);
+  const metadataFiles = await glob(`**/${STANDARD_FILES.METADATA_YAML}`, skillsDir);
+  const skillMdDirs = new Set(skillMdFiles.map((f) => path2.dirname(f)));
+  const metadataDirs = new Set(metadataFiles.map((f) => path2.dirname(f)));
+  for (const dir of skillMdDirs) {
+    if (!metadataDirs.has(dir)) {
+      issues.push({
+        severity: "error",
+        file: path2.join(skillsDir, dir),
+        message: `Missing ${STANDARD_FILES.METADATA_YAML} \u2014 skill directory has ${STANDARD_FILES.SKILL_MD} but no metadata`
+      });
+    }
+  }
+  for (const dir of metadataDirs) {
+    if (!skillMdDirs.has(dir)) {
+      issues.push({
+        severity: "error",
+        file: path2.join(skillsDir, dir),
+        message: `Missing ${STANDARD_FILES.SKILL_MD} \u2014 skill directory has ${STANDARD_FILES.METADATA_YAML} but no SKILL.md`
+      });
+    }
+  }
+  let skillCount = 0;
+  for (const metadataFile of metadataFiles) {
+    const metadataPath = path2.join(skillsDir, metadataFile);
+    const skillDir = path2.dirname(metadataFile);
+    const skillMdPath = path2.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);
+    if (!await fileExists(skillMdPath)) {
+      continue;
+    }
+    skillCount++;
+    const relPath = path2.join(skillsDirRelPath, metadataFile);
+    let rawMetadata;
+    try {
+      const metadataContent = await readFile(metadataPath);
+      rawMetadata = parseYaml2(metadataContent);
+    } catch (error) {
+      issues.push({
+        severity: "error",
+        file: relPath,
+        message: "Failed to parse YAML"
+      });
+      continue;
+    }
+    if (rawMetadata && typeof rawMetadata === "object" && !Array.isArray(rawMetadata)) {
+      for (const key of Object.keys(rawMetadata)) {
+        if (isSnakeCase(key)) {
+          issues.push({
+            severity: "error",
+            file: relPath,
+            message: `Key '${key}' uses snake_case \u2014 use camelCase instead`
+          });
+        }
+      }
+    }
+    const result = metadataValidationSchema.safeParse(rawMetadata);
+    if (!result.success) {
+      for (const issue of result.error.issues) {
+        const fieldPath = issue.path.join(".");
+        issues.push({
+          severity: "error",
+          file: relPath,
+          message: `${fieldPath}: ${issue.message}`
+        });
+      }
+      continue;
+    }
+    const metadata = result.data;
+    const dirName = path2.basename(skillDir);
+    if (metadata.displayName !== dirName) {
+      issues.push({
+        severity: "warning",
+        file: relPath,
+        message: `displayName '${metadata.displayName}' does not match directory name '${dirName}'`
+      });
+    }
+    const skillMdContent = await readFile(skillMdPath);
+    const frontmatter = parseFrontmatter(skillMdContent, skillMdPath);
+    if (frontmatter) {
+      if (!SKILL_ID_PATTERN.test(frontmatter.name)) {
+        issues.push({
+          severity: "warning",
+          file: path2.join(skillsDirRelPath, skillDir, STANDARD_FILES.SKILL_MD),
+          message: `SKILL.md name '${frontmatter.name}' does not match expected skill ID pattern (domain-subcategory-name)`
+        });
+      }
+    }
+    if (metadata.category && !/^(web|api|cli|mobile|infra|meta|security|shared)-.+$/.test(metadata.category)) {
+      issues.push({
+        severity: "warning",
+        file: relPath,
+        message: `Category '${metadata.category}' does not follow domain-prefixed pattern (e.g., 'web-framework', 'api-database')`
+      });
+    }
+  }
+  try {
+    const categoriesPath = path2.join(resolvedPath, SKILL_CATEGORIES_YAML_PATH);
+    const rulesPath = path2.join(resolvedPath, SKILL_RULES_YAML_PATH);
+    const hasCats = await fileExists(categoriesPath);
+    const hasRules = await fileExists(rulesPath);
+    if (hasCats || hasRules) {
+      const cats = hasCats ? await loadSkillCategories(categoriesPath) : {};
+      const defaultRelationships = {
+        conflicts: [],
+        discourages: [],
+        recommends: [],
+        requires: [],
+        alternatives: []
+      };
+      const rules = hasRules ? await loadSkillRules(rulesPath) : {
+        version: "1.0.0",
+        aliases: {},
+        relationships: defaultRelationships,
+        perSkill: {}
+      };
+      const skills = await extractAllSkills(skillsDir);
+      const mergedMatrix = await mergeMatrixWithSkills(
+        cats,
+        rules.relationships,
+        rules.aliases,
+        skills,
+        rules.perSkill
+      );
+      const healthIssues = checkMatrixHealth(mergedMatrix);
+      for (const healthIssue of healthIssues) {
+        issues.push({
+          severity: healthIssue.severity,
+          file: SKILL_CATEGORIES_YAML_PATH,
+          message: healthIssue.details
+        });
+      }
+    } else {
+      verbose(
+        `No categories/rules files at '${resolvedPath}' \u2014 skipping cross-reference validation`
+      );
+    }
+  } catch (error) {
+    issues.push({
+      severity: "warning",
+      file: SKILL_CATEGORIES_YAML_PATH,
+      message: `Cross-reference validation skipped: failed to load categories/rules`
+    });
+  }
+  return buildResult(issues, skillCount);
+}
+function buildResult(issues, skillCount) {
+  const errorCount = issues.filter((i) => i.severity === "error").length;
+  const warningCount = issues.filter((i) => i.severity === "warning").length;
+  return { issues, skillCount, errorCount, warningCount };
+}
+
 // src/cli/commands/validate.ts
 var Validate = class _Validate extends BaseCommand {
-  static summary = "Validate YAML files against schemas or validate compiled plugins";
-  static description = "Validates skill/agent YAML files against JSON schemas, or validates compiled plugin structure and content. Without arguments, validates all YAML files in the current directory against their schemas. With a path argument or --plugins flag, validates plugin(s) instead.";
+  static summary = "Validate YAML files against schemas, validate compiled plugins, or validate a skills source";
+  static description = "Validates skill/agent YAML files against JSON schemas, validates compiled plugin structure and content, or validates a skills source repository for metadata correctness. Without arguments, validates all YAML files in the current directory against their schemas. With --source, validates all skills in the source for schema compliance, cross-references, and conventions. With a path argument or --plugins flag, validates plugin(s) instead.";
   static examples = [
     {
       description: "Validate all YAML schemas",
       command: "<%= config.bin %> <%= command.id %>"
     },
+    {
+      description: "Validate a skills source repository",
+      command: "<%= config.bin %> <%= command.id %> --source ."
+    },
+    {
+      description: "Validate a remote skills source",
+      command: "<%= config.bin %> <%= command.id %> --source github:acme-corp/skills"
+    },
     {
       description: "Validate a specific plugin",
       command: "<%= config.bin %> <%= command.id %> ./path/to/plugin"
@@ -294,7 +502,9 @@ var Validate = class _Validate extends BaseCommand {
   };
   async run() {
     const { args, flags } = await this.parse(_Validate);
-    if (args.path || flags.plugins) {
+    if (flags.source) {
+      await this.validateSkillsSource(flags.source);
+    } else if (args.path || flags.plugins) {
       await this.validatePlugins(args.path, flags.verbose, flags.all);
     } else {
       await this.validateSchemas();
@@ -317,15 +527,15 @@ var Validate = class _Validate extends BaseCommand {
       this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });
     }
   }
-  async validatePlugins(pluginPath, verbose, all) {
-    const targetPath = pluginPath ? path2.resolve(pluginPath) : process.cwd();
+  async validatePlugins(pluginPath, verbose2, all) {
+    const targetPath = pluginPath ? path3.resolve(pluginPath) : process.cwd();
     if (all) {
-      await this.validateAllPluginsInDirectory(targetPath, verbose);
+      await this.validateAllPluginsInDirectory(targetPath, verbose2);
     } else {
-      await this.validateSinglePlugin(targetPath, verbose);
+      await this.validateSinglePlugin(targetPath, verbose2);
     }
   }
-  async validateAllPluginsInDirectory(targetPath, verbose) {
+  async validateAllPluginsInDirectory(targetPath, verbose2) {
     this.log("");
     this.log(`Validating all plugins in: ${targetPath}`);
     this.log("");
@@ -341,7 +551,7 @@ var Validate = class _Validate extends BaseCommand {
       this.log(`  Invalid: ${result.summary.invalid}`);
       this.log(`  With warnings: ${result.summary.withWarnings}`);
       for (const { name, result: pluginResult } of result.results) {
-        printPluginValidationResult(name, pluginResult, verbose);
+        printPluginValidationResult(name, pluginResult, verbose2);
       }
       if (result.valid) {
         this.log("");
@@ -364,7 +574,7 @@ var Validate = class _Validate extends BaseCommand {
       const result = await validatePlugin(targetPath);
       const summary = result.valid ? "Done: Plugin is valid" : "Done: Plugin has errors";
       this.log(summary);
-      printPluginValidationResult(path2.basename(targetPath), result, true);
+      printPluginValidationResult(path3.basename(targetPath), result, true);
       if (result.valid && result.warnings.length === 0) {
         this.log("");
         this.logSuccess("Plugin validated successfully");
@@ -382,6 +592,39 @@ var Validate = class _Validate extends BaseCommand {
       this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });
     }
   }
+  async validateSkillsSource(source) {
+    this.log("");
+    this.log(`Validating source: ${source}`);
+    this.log("");
+    try {
+      const result = await validateSource(source);
+      this.log(`Checked ${result.skillCount} skill(s)`);
+      this.log("");
+      for (const issue of result.issues) {
+        const prefix = issue.severity === "error" ? "ERROR" : "WARN";
+        this.log(`  [${prefix}] ${issue.file}: ${issue.message}`);
+      }
+      if (result.issues.length > 0) {
+        this.log("");
+      }
+      this.log(`Result: ${result.errorCount} error(s), ${result.warningCount} warning(s)`);
+      if (result.errorCount > 0) {
+        this.log("");
+        this.error(ERROR_MESSAGES.VALIDATION_FAILED, { exit: EXIT_CODES.ERROR });
+      } else if (result.warningCount > 0) {
+        this.log("");
+        this.logWarning("Source valid with warnings");
+        this.log("");
+      } else {
+        this.log("");
+        this.logSuccess("Source validated successfully");
+        this.log("");
+      }
+    } catch (error) {
+      const message = getErrorMessage(error);
+      this.error(`${ERROR_MESSAGES.VALIDATION_FAILED}: ${message}`, { exit: EXIT_CODES.ERROR });
+    }
+  }
 };
 export {
   Validate as default