Function listCommand

packages/cli/src/commands/skill.ts:654–749

(options: ListOptions)

}

async function listCommand(options: ListOptions): Promise<void> {
  trackEvent("command", { name: "list" });
  const scope: Scope = options.global ? "global" : "project";
  const baseDir = scope === "global" ? homedir() : process.cwd();

  const results: {
    label: string;
    displayPath: string;
    dir: string;
    source: string;
    skills: string[];
  }[] = [];

  // Helper to scan a skills directory
  async function scanDir(dir: string): Promise<string[]> {
    try {
      const entries = await readdir(dir, { withFileTypes: true });
      return entries.filter((e) => e.isDirectory() || e.isSymbolicLink()).map((e) => e.name);
    } catch {
      return [];
    }
  }

  if (hasExplicitIdeOption(options)) {
    // Explicit flag mode — check the specific IDE paths
    const ides = getSelectedIdes(options);
    for (const ide of ides) {
      const dir =
        ide === "universal"
          ? join(baseDir, scope === "global" ? UNIVERSAL_SKILLS_GLOBAL_PATH : UNIVERSAL_SKILLS_PATH)
          : join(baseDir, (scope === "global" ? IDE_GLOBAL_PATHS : IDE_PATHS)[ide]);
      const label = ide === "universal" ? UNIVERSAL_AGENTS_LABEL : IDE_NAMES[ide];
      const skills = await scanDir(dir);
      if (skills.length > 0) {
        results.push({ label, displayPath: dir, dir, source: ide, skills });
      }
    }
  } else {
    // Default: check universal + vendor-specific
    const universalPath = scope === "global" ? UNIVERSAL_SKILLS_GLOBAL_PATH : UNIVERSAL_SKILLS_PATH;
    const universalDir = join(baseDir, universalPath);
    const universalSkills = await scanDir(universalDir);
    if (universalSkills.length > 0) {
      results.push({
        label: UNIVERSAL_AGENTS_LABEL,
        displayPath: universalPath,
        dir: universalDir,
        source: "universal",
        skills: universalSkills,
      });
    }

    for (const ide of VENDOR_SPECIFIC_AGENTS) {
      const pathMap = scope === "global" ? IDE_GLOBAL_PATHS : IDE_PATHS;
      const dir = join(baseDir, pathMap[ide]);
      const skills = await scanDir(dir);
      if (skills.length > 0) {
        results.push({