@agents-inc/cli 0.86.0 → 0.87.0

package/dist/commands/import/skill.js

@@ -4,12 +4,11 @@ import {
   STATUS_MESSAGES
 } from "../../chunk-B7KZLXHV.js";
 import {
-  discoverValidSkills,
-  fetchSkillSource,
-  importSkillFromSource,
-  parseGitHubSource
-} from "../../chunk-O5ZWS26C.js";
-import "../../chunk-TMTUTUEV.js";
+  IMPORT_DEFAULTS,
+  computeFileHash,
+  fetchFromSource,
+  getCurrentDate
+} from "../../chunk-TMTUTUEV.js";
 import "../../chunk-B6MYECV6.js";
 import "../../chunk-ANXHMG32.js";
 import {
@@ -17,13 +16,24 @@ import {
   EXIT_CODES
 } from "../../chunk-MMTMXLI4.js";
 import {
+  copy,
   directoryExists,
-  getErrorMessage
+  ensureDir,
+  fileExists,
+  getErrorMessage,
+  importedSkillMetadataSchema,
+  listDirectories,
+  readFile,
+  warn,
+  writeFile
 } from "../../chunk-NUU3U43A.js";
 import "../../chunk-6XWHJHNZ.js";
 import {
   DEFAULT_SKILLS_SUBDIR,
-  LOCAL_SKILLS_PATH
+  GITHUB_SOURCE,
+  LOCAL_SKILLS_PATH,
+  STANDARD_FILES,
+  YAML_FORMATTING
 } from "../../chunk-6PGL2XMY.js";
 import "../../chunk-NPMMU4GY.js";
 import {
@@ -34,6 +44,7 @@ import {
 init_esm_shims();
 import { Args, Flags } from "@oclif/core";
 import path from "path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
 var ImportSkill = class _ImportSkill extends BaseCommand {
   static summary = "Import a skill from a third-party GitHub repository";
   static description = "Download and import skills from external GitHub repositories into your local .claude/skills/ directory. Supports importing specific skills or listing available skills.";
@@ -95,9 +106,26 @@ var ImportSkill = class _ImportSkill extends BaseCommand {
   async run() {
     const { args, flags } = await this.parse(_ImportSkill);
     const projectDir = process.cwd();
+    this.printHeader();
+    this.validateFlags(flags);
+    const { gigetSource, displaySource } = parseGitHubSource(args.source);
+    this.log(`Source: ${displaySource}`);
+    const repoPath = await this.fetchRepository(gigetSource, args.source, flags.refresh);
+    const skillsDir = this.resolveSkillsDir(repoPath, flags.subdir);
+    const availableSkills = await this.discoverAndValidate(skillsDir, flags.subdir);
+    if (flags.list) {
+      this.listAvailableSkills(availableSkills);
+      return;
+    }
+    const skillsToImport = this.resolveSkillsToImport(flags, availableSkills);
+    await this.importSkills(skillsToImport, skillsDir, projectDir, displaySource, flags.force);
+  }
+  printHeader() {
     this.log("");
     this.log("Import Third-Party Skill");
     this.log("");
+  }
+  validateFlags(flags) {
     if (!flags.list && !flags.skill && !flags.all) {
       this.error("Please specify --skill <name>, --all, or --list to list available skills", {
         exit: EXIT_CODES.INVALID_ARGS
@@ -108,23 +136,23 @@ var ImportSkill = class _ImportSkill extends BaseCommand {
         exit: EXIT_CODES.INVALID_ARGS
       });
     }
-    const { gigetSource, displaySource } = parseGitHubSource(args.source);
-    this.log(`Source: ${displaySource}`);
+  }
+  async fetchRepository(gigetSource, sourceArg, refresh) {
     this.log(STATUS_MESSAGES.FETCHING_REPOSITORY);
-    let repoPath;
     try {
       const result = await fetchSkillSource({
         gigetSource,
-        forceRefresh: flags.refresh
+        forceRefresh: refresh
       });
-      repoPath = result.path;
       this.log(result.fromCache ? "Using cached source" : "Downloaded fresh copy");
+      return result.path;
     } catch (error) {
-      this.error(error instanceof Error ? error.message : `Failed to fetch: ${args.source}`, {
+      this.error(error instanceof Error ? error.message : `Failed to fetch: ${sourceArg}`, {
         exit: EXIT_CODES.NETWORK_ERROR
       });
     }
-    const subdir = flags.subdir;
+  }
+  resolveSkillsDir(repoPath, subdir) {
     if (/\0/.test(subdir)) {
       this.error("--subdir contains null bytes", {
         exit: EXIT_CODES.INVALID_ARGS
@@ -142,36 +170,41 @@ var ImportSkill = class _ImportSkill extends BaseCommand {
         exit: EXIT_CODES.INVALID_ARGS
       });
     }
+    return skillsDir;
+  }
+  async discoverAndValidate(skillsDir, subdir) {
     if (!await directoryExists(skillsDir)) {
       this.error(
-        `Skills directory not found: ${flags.subdir}
-The repository doesn't have a '${flags.subdir}' directory.
+        `Skills directory not found: ${subdir}
+The repository doesn't have a '${subdir}' directory.
 Use --subdir to specify a different location.`,
         { exit: EXIT_CODES.INVALID_ARGS }
       );
     }
     const availableSkills = await discoverValidSkills(skillsDir);
     if (availableSkills.length === 0) {
-      this.error(`No valid skills found in ${flags.subdir}/
+      this.error(`No valid skills found in ${subdir}/
 Skills must have a SKILL.md file.`, {
         exit: EXIT_CODES.ERROR
       });
     }
-    if (flags.list) {
-      this.log("");
-      this.log(`Available skills (${availableSkills.length}):`);
-      this.log("");
-      for (const skill of availableSkills) {
-        this.log(`  - ${skill}`);
-      }
-      this.log("");
-      this.log("Use --skill <name> to import a specific skill, or --all to import all.");
-      return;
+    return availableSkills;
+  }
+  listAvailableSkills(skills) {
+    this.log("");
+    this.log(`Available skills (${skills.length}):`);
+    this.log("");
+    for (const skill of skills) {
+      this.log(`  - ${skill}`);
     }
-    let skillsToImport = [];
+    this.log("");
+    this.log("Use --skill <name> to import a specific skill, or --all to import all.");
+  }
+  resolveSkillsToImport(flags, availableSkills) {
     if (flags.all) {
-      skillsToImport = availableSkills;
-    } else if (flags.skill) {
+      return availableSkills;
+    }
+    if (flags.skill) {
       if (!availableSkills.includes(flags.skill)) {
         this.error(
           `Skill '${flags.skill}' not found in repository.
@@ -180,8 +213,11 @@ Use --list to see all available skills.`,
           { exit: EXIT_CODES.INVALID_ARGS }
         );
       }
-      skillsToImport = [flags.skill];
+      return [flags.skill];
     }
+    return [];
+  }
+  async importSkills(skillsToImport, skillsDir, projectDir, displaySource, force) {
     const destDir = path.join(projectDir, LOCAL_SKILLS_PATH);
     this.log("");
     this.log(`Importing ${skillsToImport.length} skill(s)...`);
@@ -191,7 +227,7 @@ Use --list to see all available skills.`,
       const sourcePath = path.join(skillsDir, skillName);
       const destPath = path.join(destDir, skillName);
       if (await directoryExists(destPath)) {
-        if (!flags.force) {
+        if (!force) {
           this.warn(`Skipping '${skillName}': already exists. Use --force to overwrite.`);
           skipped++;
           continue;
@@ -214,6 +250,134 @@ Use --list to see all available skills.`,
     this.log("");
   }
 };
+function parseGitHubSource(source) {
+  if (source.startsWith(GITHUB_SOURCE.HTTPS_PREFIX)) {
+    const path2 = source.replace(GITHUB_SOURCE.HTTPS_PREFIX, "");
+    return {
+      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${path2}`,
+      displaySource: source
+    };
+  }
+  if (source.startsWith(GITHUB_SOURCE.GITHUB_PREFIX) || source.startsWith(GITHUB_SOURCE.GH_PREFIX)) {
+    const normalized = source.startsWith(GITHUB_SOURCE.GH_PREFIX) ? GITHUB_SOURCE.GITHUB_PREFIX + source.slice(GITHUB_SOURCE.GH_PREFIX.length) : source;
+    return {
+      gigetSource: normalized,
+      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${normalized.replace(GITHUB_SOURCE.GITHUB_PREFIX, "")}`
+    };
+  }
+  if (source.includes("/") && !source.includes(":")) {
+    return {
+      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${source}`,
+      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${source}`
+    };
+  }
+  return {
+    gigetSource: source,
+    displaySource: source
+  };
+}
+async function fetchSkillSource(options) {
+  const result = await fetchFromSource(options.gigetSource, {
+    forceRefresh: options.forceRefresh
+  });
+  return { path: result.path, fromCache: result.fromCache };
+}
+async function discoverValidSkills(skillsDir) {
+  const skillDirs = await listDirectories(skillsDir);
+  const validSkills = [];
+  for (const skillDir of skillDirs) {
+    const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);
+    if (await fileExists(skillMdPath)) {
+      validSkills.push(skillDir);
+    }
+  }
+  return validSkills.sort();
+}
+async function importSkillFromSource(options) {
+  const { sourcePath, destPath, skillName, displaySource } = options;
+  const skillMdPath = path.join(sourcePath, STANDARD_FILES.SKILL_MD);
+  if (!await fileExists(skillMdPath)) {
+    throw new Error(
+      `Missing required SKILL.md file at ${skillMdPath}
+Every skill must have a SKILL.md file containing the skill's prompt content.
+Create one with:
+  echo "# ${skillName}" > ${path.join(sourcePath, STANDARD_FILES.SKILL_MD)}`
+    );
+  }
+  const contentHash = await computeFileHash(skillMdPath);
+  await ensureDir(path.dirname(destPath));
+  await copy(sourcePath, destPath);
+  await injectImportedForkedFromMetadata(destPath, skillName, displaySource, contentHash);
+}
+async function injectImportedForkedFromMetadata(destPath, skillName, source, contentHash) {
+  const metadataYamlPath = path.join(destPath, STANDARD_FILES.METADATA_YAML);
+  const metadataJsonPath = path.join(destPath, STANDARD_FILES.METADATA_JSON);
+  const forkedFrom = {
+    source,
+    skillName,
+    contentHash,
+    date: getCurrentDate()
+  };
+  if (await fileExists(metadataYamlPath)) {
+    const rawContent = await readFile(metadataYamlPath);
+    const lines = rawContent.split("\n");
+    let yamlContent2 = rawContent;
+    let schemaComment = "";
+    if (lines[0]?.startsWith("# yaml-language-server:")) {
+      schemaComment = `${lines[0]}
+`;
+      yamlContent2 = lines.slice(1).join("\n");
+    }
+    const raw = parseYaml(yamlContent2);
+    const parseResult = importedSkillMetadataSchema.safeParse(raw);
+    if (!parseResult.success) {
+      warn(
+        `Malformed metadata.yaml at ${metadataYamlPath} \u2014 existing fields may be lost
+  Validation errors: ${parseResult.error.issues.map((i) => i.message).join(", ")}
+  Expected fields: displayName (string), cliDescription (string), category (string)
+  Validate your YAML syntax at https://yamllint.com`
+      );
+    }
+    const metadata = parseResult.success ? parseResult.data : { forkedFrom: void 0 };
+    metadata.forkedFrom = forkedFrom;
+    const newYamlContent = stringifyYaml(metadata, {
+      lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE
+    });
+    await writeFile(metadataYamlPath, schemaComment + newYamlContent);
+    return;
+  }
+  if (await fileExists(metadataJsonPath)) {
+    const rawContent = await readFile(metadataJsonPath);
+    let jsonParsed;
+    try {
+      jsonParsed = JSON.parse(rawContent);
+    } catch {
+      warn(
+        `Malformed JSON in ${metadataJsonPath} \u2014 skipping metadata injection
+  Common issues: trailing commas, unquoted keys, single quotes instead of double quotes
+  Validate your JSON at https://jsonlint.com`
+      );
+      return;
+    }
+    const jsonResult = importedSkillMetadataSchema.safeParse(jsonParsed);
+    const metadata = jsonResult.success ? jsonResult.data : { forkedFrom: void 0 };
+    metadata.forkedFrom = forkedFrom;
+    const yamlContent2 = stringifyYaml(metadata, { lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE });
+    await writeFile(metadataYamlPath, yamlContent2);
+    return;
+  }
+  const minimalMetadata = {
+    displayName: skillName.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
+    cliDescription: "Imported from third-party repository",
+    category: IMPORT_DEFAULTS.CATEGORY,
+    author: IMPORT_DEFAULTS.AUTHOR,
+    forkedFrom
+  };
+  const yamlContent = stringifyYaml(minimalMetadata, {
+    lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE
+  });
+  await writeFile(metadataYamlPath, yamlContent);
+}
 export {
   ImportSkill as default
 };

package/dist/commands/import/skill.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/commands/import/skill.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { BaseCommand } from \"../../base-command.js\";\nimport { getErrorMessage } from \"../../utils/errors.js\";\nimport { EXIT_CODES } from \"../../lib/exit-codes.js\";\nimport { directoryExists } from \"../../utils/fs.js\";\nimport { DEFAULT_SKILLS_SUBDIR, LOCAL_SKILLS_PATH } from \"../../consts.js\";\nimport { STATUS_MESSAGES, INFO_MESSAGES } from \"../../utils/messages.js\";\nimport {\n  parseGitHubSource,\n  fetchSkillSource,\n  discoverValidSkills,\n  importSkillFromSource,\n} from \"../../lib/operations/import-skill.js\";\n\nexport default class ImportSkill extends BaseCommand {\n  static summary = \"Import a skill from a third-party GitHub repository\";\n  static description =\n    \"Download and import skills from external GitHub repositories into your local \" +\n    \".claude/skills/ directory. Supports importing specific skills or listing available skills.\";\n\n  static examples = [\n    {\n      description: \"List available skills from a repository\",\n      command: \"<%= config.bin %> import skill github:vercel-labs/agent-skills --list\",\n    },\n    {\n      description: \"Import a specific skill\",\n      command:\n        \"<%= config.bin %> import skill github:vercel-labs/agent-skills --skill react-best-practices\",\n    },\n    {\n      description: \"Import all skills from a repository\",\n      command: \"<%= config.bin %> import skill github:vercel-labs/agent-skills --all\",\n    },\n    {\n      description: \"Import with custom skills directory\",\n      command:\n        \"<%= config.bin %> import skill github:owner/repo --skill my-skill --subdir custom-skills\",\n    },\n  ];\n\n  static args = {\n    source: Args.string({\n      description:\n        \"GitHub repository source (github:owner/repo, https://github.com/owner/repo, or owner/repo)\",\n      required: true,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    skill: Flags.string({\n      char: \"n\",\n      description: \"Name of the specific skill to import\",\n      required: false,\n    }),\n    all: Flags.boolean({\n      char: \"a\",\n      description: \"Import all skills from the repository\",\n      default: false,\n    }),\n    list: Flags.boolean({\n      char: \"l\",\n      description: \"List available skills without importing\",\n      default: false,\n    }),\n    subdir: Flags.string({\n      description: \"Subdirectory containing skills (default: skills)\",\n      default: DEFAULT_SKILLS_SUBDIR,\n    }),\n    force: Flags.boolean({\n      char: \"f\",\n      description: \"Overwrite existing skills\",\n      default: false,\n    }),\n    refresh: Flags.boolean({\n      description: \"Force refresh from remote (ignore cache)\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(ImportSkill);\n    const projectDir = process.cwd();\n\n    this.log(\"\");\n    this.log(\"Import Third-Party Skill\");\n    this.log(\"\");\n\n    if (!flags.list && !flags.skill && !flags.all) {\n      this.error(\"Please specify --skill <name>, --all, or --list to list available skills\", {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n\n    if (flags.skill && flags.all) {\n      this.error(\"Cannot use --skill and --all together\", {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n\n    const { gigetSource, displaySource } = parseGitHubSource(args.source);\n    this.log(`Source: ${displaySource}`);\n\n    this.log(STATUS_MESSAGES.FETCHING_REPOSITORY);\n\n    let repoPath: string;\n    try {\n      const result = await fetchSkillSource({\n        gigetSource,\n        forceRefresh: flags.refresh,\n      });\n      repoPath = result.path;\n      this.log(result.fromCache ? \"Using cached source\" : \"Downloaded fresh copy\");\n    } catch (error) {\n      this.error(error instanceof Error ? error.message : `Failed to fetch: ${args.source}`, {\n        exit: EXIT_CODES.NETWORK_ERROR,\n      });\n    }\n\n    // Validate --subdir to prevent path traversal outside repository boundary\n    const subdir = flags.subdir;\n    if (/\\0/.test(subdir)) {\n      this.error(\"--subdir contains null bytes\", {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n    if (path.isAbsolute(subdir)) {\n      this.error(`--subdir must be a relative path, got: ${subdir}`, {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n    const skillsDir = path.resolve(path.join(repoPath, subdir));\n    const resolvedRepoPath = path.resolve(repoPath);\n    if (!skillsDir.startsWith(resolvedRepoPath + path.sep) && skillsDir !== resolvedRepoPath) {\n      this.error(`--subdir path escapes repository boundary: ${subdir}`, {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n\n    if (!(await directoryExists(skillsDir))) {\n      this.error(\n        `Skills directory not found: ${flags.subdir}\\n` +\n          `The repository doesn't have a '${flags.subdir}' directory.\\n` +\n          `Use --subdir to specify a different location.`,\n        { exit: EXIT_CODES.INVALID_ARGS },\n      );\n    }\n\n    const availableSkills = await discoverValidSkills(skillsDir);\n\n    if (availableSkills.length === 0) {\n      this.error(`No valid skills found in ${flags.subdir}/\\nSkills must have a SKILL.md file.`, {\n        exit: EXIT_CODES.ERROR,\n      });\n    }\n\n    if (flags.list) {\n      this.log(\"\");\n      this.log(`Available skills (${availableSkills.length}):`);\n      this.log(\"\");\n      for (const skill of availableSkills) {\n        this.log(`  - ${skill}`);\n      }\n      this.log(\"\");\n      this.log(\"Use --skill <name> to import a specific skill, or --all to import all.\");\n      return;\n    }\n\n    let skillsToImport: string[] = [];\n\n    if (flags.all) {\n      skillsToImport = availableSkills;\n    } else if (flags.skill) {\n      if (!availableSkills.includes(flags.skill)) {\n        this.error(\n          `Skill '${flags.skill}' not found in repository.\\n` +\n            `Available skills: ${availableSkills.join(\", \")}\\n` +\n            `Use --list to see all available skills.`,\n          { exit: EXIT_CODES.INVALID_ARGS },\n        );\n      }\n      skillsToImport = [flags.skill];\n    }\n\n    const destDir = path.join(projectDir, LOCAL_SKILLS_PATH);\n\n    this.log(\"\");\n    this.log(`Importing ${skillsToImport.length} skill(s)...`);\n\n    let imported = 0;\n    let skipped = 0;\n\n    for (const skillName of skillsToImport) {\n      const sourcePath = path.join(skillsDir, skillName);\n      const destPath = path.join(destDir, skillName);\n\n      if (await directoryExists(destPath)) {\n        if (!flags.force) {\n          this.warn(`Skipping '${skillName}': already exists. Use --force to overwrite.`);\n          skipped++;\n          continue;\n        }\n      }\n\n      try {\n        await importSkillFromSource({ sourcePath, destPath, skillName, displaySource });\n        this.logSuccess(`Imported: ${skillName}`);\n        imported++;\n      } catch (error) {\n        this.warn(`Failed to import '${skillName}': ${getErrorMessage(error)}`);\n        skipped++;\n      }\n    }\n\n    this.log(\"\");\n    this.logSuccess(`Import complete: ${imported} imported, ${skipped} skipped`);\n    this.log(`Skills location: ${destDir}`);\n    this.log(\"\");\n    this.log(INFO_MESSAGES.RUN_COMPILE);\n    this.log(\"\");\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/cli/commands/import/skill.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { parse as parseYaml, stringify as stringifyYaml } from \"yaml\";\nimport { BaseCommand } from \"../../base-command.js\";\nimport { getErrorMessage } from \"../../utils/errors.js\";\nimport { EXIT_CODES } from \"../../lib/exit-codes.js\";\nimport { fetchFromSource } from \"../../lib/loading/index.js\";\nimport { importedSkillMetadataSchema } from \"../../lib/schemas.js\";\nimport { getCurrentDate, computeFileHash } from \"../../lib/versioning.js\";\nimport {\n  copy,\n  directoryExists,\n  fileExists,\n  listDirectories,\n  readFile,\n  writeFile,\n  ensureDir,\n} from \"../../utils/fs.js\";\nimport { warn } from \"../../utils/logger.js\";\nimport {\n  DEFAULT_SKILLS_SUBDIR,\n  GITHUB_SOURCE,\n  LOCAL_SKILLS_PATH,\n  STANDARD_FILES,\n  YAML_FORMATTING,\n} from \"../../consts.js\";\nimport { IMPORT_DEFAULTS } from \"../../lib/metadata-keys.js\";\nimport { STATUS_MESSAGES, INFO_MESSAGES } from \"../../utils/messages.js\";\n\nexport default class ImportSkill extends BaseCommand {\n  static summary = \"Import a skill from a third-party GitHub repository\";\n  static description =\n    \"Download and import skills from external GitHub repositories into your local \" +\n    \".claude/skills/ directory. Supports importing specific skills or listing available skills.\";\n\n  static examples = [\n    {\n      description: \"List available skills from a repository\",\n      command: \"<%= config.bin %> import skill github:vercel-labs/agent-skills --list\",\n    },\n    {\n      description: \"Import a specific skill\",\n      command:\n        \"<%= config.bin %> import skill github:vercel-labs/agent-skills --skill react-best-practices\",\n    },\n    {\n      description: \"Import all skills from a repository\",\n      command: \"<%= config.bin %> import skill github:vercel-labs/agent-skills --all\",\n    },\n    {\n      description: \"Import with custom skills directory\",\n      command:\n        \"<%= config.bin %> import skill github:owner/repo --skill my-skill --subdir custom-skills\",\n    },\n  ];\n\n  static args = {\n    source: Args.string({\n      description:\n        \"GitHub repository source (github:owner/repo, https://github.com/owner/repo, or owner/repo)\",\n      required: true,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    skill: Flags.string({\n      char: \"n\",\n      description: \"Name of the specific skill to import\",\n      required: false,\n    }),\n    all: Flags.boolean({\n      char: \"a\",\n      description: \"Import all skills from the repository\",\n      default: false,\n    }),\n    list: Flags.boolean({\n      char: \"l\",\n      description: \"List available skills without importing\",\n      default: false,\n    }),\n    subdir: Flags.string({\n      description: \"Subdirectory containing skills (default: skills)\",\n      default: DEFAULT_SKILLS_SUBDIR,\n    }),\n    force: Flags.boolean({\n      char: \"f\",\n      description: \"Overwrite existing skills\",\n      default: false,\n    }),\n    refresh: Flags.boolean({\n      description: \"Force refresh from remote (ignore cache)\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(ImportSkill);\n    const projectDir = process.cwd();\n\n    this.printHeader();\n    this.validateFlags(flags);\n\n    const { gigetSource, displaySource } = parseGitHubSource(args.source);\n    this.log(`Source: ${displaySource}`);\n\n    const repoPath = await this.fetchRepository(gigetSource, args.source, flags.refresh);\n    const skillsDir = this.resolveSkillsDir(repoPath, flags.subdir);\n    const availableSkills = await this.discoverAndValidate(skillsDir, flags.subdir);\n\n    if (flags.list) {\n      this.listAvailableSkills(availableSkills);\n      return;\n    }\n\n    const skillsToImport = this.resolveSkillsToImport(flags, availableSkills);\n    await this.importSkills(skillsToImport, skillsDir, projectDir, displaySource, flags.force);\n  }\n\n  private printHeader(): void {\n    this.log(\"\");\n    this.log(\"Import Third-Party Skill\");\n    this.log(\"\");\n  }\n\n  private validateFlags(flags: { list: boolean; skill?: string; all: boolean }): void {\n    if (!flags.list && !flags.skill && !flags.all) {\n      this.error(\"Please specify --skill <name>, --all, or --list to list available skills\", {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n\n    if (flags.skill && flags.all) {\n      this.error(\"Cannot use --skill and --all together\", {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n  }\n\n  private async fetchRepository(\n    gigetSource: string,\n    sourceArg: string,\n    refresh: boolean,\n  ): Promise<string> {\n    this.log(STATUS_MESSAGES.FETCHING_REPOSITORY);\n\n    try {\n      const result = await fetchSkillSource({\n        gigetSource,\n        forceRefresh: refresh,\n      });\n      this.log(result.fromCache ? \"Using cached source\" : \"Downloaded fresh copy\");\n      return result.path;\n    } catch (error) {\n      this.error(error instanceof Error ? error.message : `Failed to fetch: ${sourceArg}`, {\n        exit: EXIT_CODES.NETWORK_ERROR,\n      });\n    }\n  }\n\n  private resolveSkillsDir(repoPath: string, subdir: string): string {\n    if (/\\0/.test(subdir)) {\n      this.error(\"--subdir contains null bytes\", {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n    if (path.isAbsolute(subdir)) {\n      this.error(`--subdir must be a relative path, got: ${subdir}`, {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n    const skillsDir = path.resolve(path.join(repoPath, subdir));\n    const resolvedRepoPath = path.resolve(repoPath);\n    if (!skillsDir.startsWith(resolvedRepoPath + path.sep) && skillsDir !== resolvedRepoPath) {\n      this.error(`--subdir path escapes repository boundary: ${subdir}`, {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n    return skillsDir;\n  }\n\n  private async discoverAndValidate(skillsDir: string, subdir: string): Promise<string[]> {\n    if (!(await directoryExists(skillsDir))) {\n      this.error(\n        `Skills directory not found: ${subdir}\\n` +\n          `The repository doesn't have a '${subdir}' directory.\\n` +\n          `Use --subdir to specify a different location.`,\n        { exit: EXIT_CODES.INVALID_ARGS },\n      );\n    }\n\n    const availableSkills = await discoverValidSkills(skillsDir);\n\n    if (availableSkills.length === 0) {\n      this.error(`No valid skills found in ${subdir}/\\nSkills must have a SKILL.md file.`, {\n        exit: EXIT_CODES.ERROR,\n      });\n    }\n\n    return availableSkills;\n  }\n\n  private listAvailableSkills(skills: string[]): void {\n    this.log(\"\");\n    this.log(`Available skills (${skills.length}):`);\n    this.log(\"\");\n    for (const skill of skills) {\n      this.log(`  - ${skill}`);\n    }\n    this.log(\"\");\n    this.log(\"Use --skill <name> to import a specific skill, or --all to import all.\");\n  }\n\n  private resolveSkillsToImport(\n    flags: { all: boolean; skill?: string },\n    availableSkills: string[],\n  ): string[] {\n    if (flags.all) {\n      return availableSkills;\n    }\n\n    if (flags.skill) {\n      if (!availableSkills.includes(flags.skill)) {\n        this.error(\n          `Skill '${flags.skill}' not found in repository.\\n` +\n            `Available skills: ${availableSkills.join(\", \")}\\n` +\n            `Use --list to see all available skills.`,\n          { exit: EXIT_CODES.INVALID_ARGS },\n        );\n      }\n      return [flags.skill];\n    }\n\n    return [];\n  }\n\n  private async importSkills(\n    skillsToImport: string[],\n    skillsDir: string,\n    projectDir: string,\n    displaySource: string,\n    force: boolean,\n  ): Promise<void> {\n    const destDir = path.join(projectDir, LOCAL_SKILLS_PATH);\n\n    this.log(\"\");\n    this.log(`Importing ${skillsToImport.length} skill(s)...`);\n\n    let imported = 0;\n    let skipped = 0;\n\n    for (const skillName of skillsToImport) {\n      const sourcePath = path.join(skillsDir, skillName);\n      const destPath = path.join(destDir, skillName);\n\n      if (await directoryExists(destPath)) {\n        if (!force) {\n          this.warn(`Skipping '${skillName}': already exists. Use --force to overwrite.`);\n          skipped++;\n          continue;\n        }\n      }\n\n      try {\n        await importSkillFromSource({ sourcePath, destPath, skillName, displaySource });\n        this.logSuccess(`Imported: ${skillName}`);\n        imported++;\n      } catch (error) {\n        this.warn(`Failed to import '${skillName}': ${getErrorMessage(error)}`);\n        skipped++;\n      }\n    }\n\n    this.log(\"\");\n    this.logSuccess(`Import complete: ${imported} imported, ${skipped} skipped`);\n    this.log(`Skills location: ${destDir}`);\n    this.log(\"\");\n    this.log(INFO_MESSAGES.RUN_COMPILE);\n    this.log(\"\");\n  }\n}\n\ntype ImportedForkedFromMetadata = {\n  source: string;\n  skillName: string;\n  contentHash: string;\n  date: string;\n};\n\ntype SkillMetadata = {\n  forkedFrom?: ImportedForkedFromMetadata;\n  [key: string]: unknown;\n};\n\ntype ParsedGitHubSource = {\n  gigetSource: string;\n  displaySource: string;\n};\n\ntype FetchSourceOptions = {\n  gigetSource: string;\n  forceRefresh?: boolean;\n};\n\ntype FetchedSource = {\n  path: string;\n  fromCache: boolean;\n};\n\ntype ImportSkillOptions = {\n  sourcePath: string;\n  destPath: string;\n  skillName: string;\n  displaySource: string;\n};\n\n/**\n * Parses various GitHub URL formats into a normalized giget source string\n * and a human-readable display URL.\n *\n * Supports: `https://github.com/owner/repo`, `github:owner/repo`,\n * `gh:owner/repo`, and bare `owner/repo` formats.\n */\nfunction parseGitHubSource(source: string): ParsedGitHubSource {\n  if (source.startsWith(GITHUB_SOURCE.HTTPS_PREFIX)) {\n    const path = source.replace(GITHUB_SOURCE.HTTPS_PREFIX, \"\");\n    return {\n      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${path}`,\n      displaySource: source,\n    };\n  }\n\n  if (\n    source.startsWith(GITHUB_SOURCE.GITHUB_PREFIX) ||\n    source.startsWith(GITHUB_SOURCE.GH_PREFIX)\n  ) {\n    const normalized = source.startsWith(GITHUB_SOURCE.GH_PREFIX)\n      ? GITHUB_SOURCE.GITHUB_PREFIX + source.slice(GITHUB_SOURCE.GH_PREFIX.length)\n      : source;\n    return {\n      gigetSource: normalized,\n      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${normalized.replace(GITHUB_SOURCE.GITHUB_PREFIX, \"\")}`,\n    };\n  }\n\n  if (source.includes(\"/\") && !source.includes(\":\")) {\n    return {\n      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${source}`,\n      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${source}`,\n    };\n  }\n\n  return {\n    gigetSource: source,\n    displaySource: source,\n  };\n}\n\n/**\n * Fetches a source repository using giget. Wraps `fetchFromSource` from the\n * loading layer.\n */\nasync function fetchSkillSource(options: FetchSourceOptions): Promise<FetchedSource> {\n  const result = await fetchFromSource(options.gigetSource, {\n    forceRefresh: options.forceRefresh,\n  });\n  return { path: result.path, fromCache: result.fromCache };\n}\n\n/**\n * Discovers valid skill directories within a source path by checking\n * for the presence of SKILL.md files.\n *\n * @returns Sorted list of directory names that contain a SKILL.md file.\n */\nasync function discoverValidSkills(skillsDir: string): Promise<string[]> {\n  const skillDirs = await listDirectories(skillsDir);\n  const validSkills: string[] = [];\n\n  for (const skillDir of skillDirs) {\n    const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);\n    if (await fileExists(skillMdPath)) {\n      validSkills.push(skillDir);\n    }\n  }\n\n  return validSkills.sort();\n}\n\n/**\n * Imports a single skill from a source directory into the destination.\n *\n * Validates that the source skill has a SKILL.md file, copies the directory,\n * and injects `forkedFrom` metadata into the destination's metadata.yaml.\n *\n * @throws {Error} If the source skill is missing a SKILL.md file.\n */\nasync function importSkillFromSource(options: ImportSkillOptions): Promise<void> {\n  const { sourcePath, destPath, skillName, displaySource } = options;\n  const skillMdPath = path.join(sourcePath, STANDARD_FILES.SKILL_MD);\n\n  if (!(await fileExists(skillMdPath))) {\n    throw new Error(\n      `Missing required SKILL.md file at ${skillMdPath}\\n` +\n        `Every skill must have a SKILL.md file containing the skill's prompt content.\\n` +\n        `Create one with:\\n` +\n        `  echo \"# ${skillName}\" > ${path.join(sourcePath, STANDARD_FILES.SKILL_MD)}`,\n    );\n  }\n\n  const contentHash = await computeFileHash(skillMdPath);\n\n  await ensureDir(path.dirname(destPath));\n  await copy(sourcePath, destPath);\n\n  await injectImportedForkedFromMetadata(destPath, skillName, displaySource, contentHash);\n}\n\n/**\n * Injects `forkedFrom` metadata into a third-party imported skill's metadata.yaml.\n *\n * Handles three cases:\n * 1. Existing metadata.yaml -- preserves fields, adds/overwrites forkedFrom\n * 2. Existing metadata.json -- converts to YAML, adds forkedFrom\n * 3. No metadata file -- creates minimal metadata.yaml with forkedFrom\n *\n * Different from `injectForkedFromMetadata` in `skill-metadata.ts` which tracks\n * internal marketplace fork lineage using `skillId`. This function tracks\n * third-party imports using `source` + `skillName`.\n */\nasync function injectImportedForkedFromMetadata(\n  destPath: string,\n  skillName: string,\n  source: string,\n  contentHash: string,\n): Promise<void> {\n  const metadataYamlPath = path.join(destPath, STANDARD_FILES.METADATA_YAML);\n  const metadataJsonPath = path.join(destPath, STANDARD_FILES.METADATA_JSON);\n\n  const forkedFrom: ImportedForkedFromMetadata = {\n    source,\n    skillName,\n    contentHash,\n    date: getCurrentDate(),\n  };\n\n  if (await fileExists(metadataYamlPath)) {\n    const rawContent = await readFile(metadataYamlPath);\n    const lines = rawContent.split(\"\\n\");\n    let yamlContent = rawContent;\n    let schemaComment = \"\";\n\n    if (lines[0]?.startsWith(\"# yaml-language-server:\")) {\n      schemaComment = `${lines[0]}\\n`;\n      yamlContent = lines.slice(1).join(\"\\n\");\n    }\n\n    const raw = parseYaml(yamlContent);\n    const parseResult = importedSkillMetadataSchema.safeParse(raw);\n    if (!parseResult.success) {\n      warn(\n        `Malformed metadata.yaml at ${metadataYamlPath} — existing fields may be lost\\n` +\n          `  Validation errors: ${parseResult.error.issues.map((i) => i.message).join(\", \")}\\n` +\n          `  Expected fields: displayName (string), cliDescription (string), category (string)\\n` +\n          `  Validate your YAML syntax at https://yamllint.com`,\n      );\n    }\n    const metadata = parseResult.success\n      ? (parseResult.data as SkillMetadata)\n      : { forkedFrom: undefined };\n    metadata.forkedFrom = forkedFrom;\n\n    const newYamlContent = stringifyYaml(metadata, {\n      lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE,\n    });\n    await writeFile(metadataYamlPath, schemaComment + newYamlContent);\n    return;\n  }\n\n  if (await fileExists(metadataJsonPath)) {\n    const rawContent = await readFile(metadataJsonPath);\n    let jsonParsed: unknown;\n    try {\n      jsonParsed = JSON.parse(rawContent);\n    } catch {\n      warn(\n        `Malformed JSON in ${metadataJsonPath} — skipping metadata injection\\n` +\n          `  Common issues: trailing commas, unquoted keys, single quotes instead of double quotes\\n` +\n          `  Validate your JSON at https://jsonlint.com`,\n      );\n      return;\n    }\n    const jsonResult = importedSkillMetadataSchema.safeParse(jsonParsed);\n    const metadata = jsonResult.success\n      ? (jsonResult.data as SkillMetadata)\n      : { forkedFrom: undefined };\n    metadata.forkedFrom = forkedFrom;\n\n    const yamlContent = stringifyYaml(metadata, { lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE });\n    await writeFile(metadataYamlPath, yamlContent);\n    return;\n  }\n\n  const minimalMetadata: SkillMetadata = {\n    displayName: skillName\n      .split(\"-\")\n      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n      .join(\" \"),\n    cliDescription: \"Imported from third-party repository\",\n    category: IMPORT_DEFAULTS.CATEGORY,\n    author: IMPORT_DEFAULTS.AUTHOR,\n    forkedFrom,\n  };\n\n  const yamlContent = stringifyYaml(minimalMetadata, {\n    lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE,\n  });\n  await writeFile(metadataYamlPath, yamlContent);\n}\n"],"mappings":"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","names":["path","yamlContent"]}

package/dist/commands/info.js

@@ -5,10 +5,8 @@ import {
 import {
   loadSource,
   resolveSkillInfo
-} from "../chunk-DCVCFBQ7.js";
+} from "../chunk-5UJJQFET.js";
 import "../chunk-N6A7A4RA.js";
-import "../chunk-O5ZWS26C.js";
-import "../chunk-XQK4S22C.js";
 import "../chunk-FBZR46GC.js";
 import "../chunk-TMTUTUEV.js";
 import "../chunk-B6MYECV6.js";
@@ -104,52 +102,61 @@ var Info = class _Info extends BaseCommand {
   };
   async run() {
     const { args, flags } = await this.parse(_Info);
+    const projectDir = process.cwd();
     try {
-      this.log(STATUS_MESSAGES.LOADING_SKILLS);
-      const { sourceResult } = await loadSource({
-        sourceFlag: flags.source,
-        projectDir: process.cwd()
-      });
-      const { sourcePath, isLocal } = sourceResult;
-      this.log(`Loaded from ${isLocal ? "local" : "remote"}: ${sourcePath}`);
+      const { sourcePath, isLocal } = await this.loadSourceAndLog(flags.source, projectDir);
       const result = await resolveSkillInfo({
         query: args.skill,
         skills: matrix.skills,
         slugToId: matrix.slugMap.slugToId,
-        projectDir: process.cwd(),
+        projectDir,
         sourcePath,
         isLocal,
         includePreview: flags.preview
       });
       if (!result.resolved) {
-        this.log("");
-        this.error(`Skill "${args.skill}" not found.`, { exit: false });
-        if (result.suggestions.length > 0) {
-          this.log("");
-          this.log("Did you mean one of these?");
-          for (const suggestion of result.suggestions) {
-            this.log(`  - ${suggestion}`);
-          }
-        }
-        this.log("");
-        this.logInfo(`Use '${CLI_BIN_NAME} search <query>' to find available skills.`);
-        this.log("");
-        this.exit(EXIT_CODES.ERROR);
+        this.reportNotFound(args.skill, result.suggestions);
+        return;
       }
-      const { skill, isInstalled, preview } = result.resolved;
+      this.displaySkillInfo(result.resolved, flags.preview);
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  async loadSourceAndLog(sourceFlag, projectDir) {
+    this.log(STATUS_MESSAGES.LOADING_SKILLS);
+    const { sourceResult } = await loadSource({ sourceFlag, projectDir });
+    const { sourcePath, isLocal } = sourceResult;
+    this.log(`Loaded from ${isLocal ? "local" : "remote"}: ${sourcePath}`);
+    return { sourcePath, isLocal };
+  }
+  reportNotFound(query, suggestions) {
+    this.log("");
+    this.error(`Skill "${query}" not found.`, { exit: false });
+    if (suggestions.length > 0) {
       this.log("");
-      this.log(formatSkillInfo(skill, isInstalled));
-      if (flags.preview && preview.length > 0) {
-        this.log("");
-        this.log(`--- Content Preview (first ${CONTENT_PREVIEW_LINES} lines) ---`);
-        for (const line of preview) {
-          this.log(line);
-        }
+      this.log("Did you mean one of these?");
+      for (const suggestion of suggestions) {
+        this.log(`  - ${suggestion}`);
       }
+    }
+    this.log("");
+    this.logInfo(`Use '${CLI_BIN_NAME} search <query>' to find available skills.`);
+    this.log("");
+    this.exit(EXIT_CODES.ERROR);
+  }
+  displaySkillInfo(resolved, showPreview) {
+    const { skill, isInstalled, preview } = resolved;
+    this.log("");
+    this.log(formatSkillInfo(skill, isInstalled));
+    if (showPreview && preview.length > 0) {
       this.log("");
-    } catch (error) {
-      this.handleError(error);
+      this.log(`--- Content Preview (first ${CONTENT_PREVIEW_LINES} lines) ---`);
+      for (const line of preview) {
+        this.log(line);
+      }
     }
+    this.log("");
   }
 };
 export {

package/dist/commands/info.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/commands/info.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport { BaseCommand } from \"../base-command.js\";\nimport { loadSource, resolveSkillInfo } from \"../lib/operations/index.js\";\nimport { matrix } from \"../lib/matrix/matrix-provider\";\nimport { CLI_BIN_NAME } from \"../consts.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\nimport { STATUS_MESSAGES } from \"../utils/messages.js\";\nimport type { ResolvedSkill, SkillRequirement } from \"../types/index.js\";\n\nconst CONTENT_PREVIEW_LINES = 10;\n\nfunction formatRequirements(requirements: SkillRequirement[]): string {\n  if (requirements.length === 0) {\n    return \"(none)\";\n  }\n  return requirements\n    .map((req) => {\n      const prefix = req.needsAny ? \"any of: \" : \"\";\n      return prefix + req.skillIds.join(\", \");\n    })\n    .join(\"; \");\n}\n\nfunction formatSkillInfo(skill: ResolvedSkill, isInstalled: boolean): string {\n  const lines: string[] = [];\n\n  lines.push(`Skill: ${skill.id}`);\n  if (skill.slug) {\n    lines.push(`Slug: ${skill.slug}`);\n  }\n  lines.push(`Display Name: ${skill.displayName}`);\n  lines.push(`Author: ${skill.author}`);\n  lines.push(`Category: ${skill.category}`);\n  lines.push(\"\");\n  lines.push(\"Description:\");\n  lines.push(`  ${skill.description}`);\n  lines.push(\"\");\n  lines.push(`Requires: ${formatRequirements(skill.requires)}`);\n  lines.push(\n    `Conflicts with: ${skill.conflictsWith.length > 0 ? skill.conflictsWith.map((r) => r.skillId).join(\", \") : \"(none)\"}`,\n  );\n  lines.push(\n    `Recommended: ${skill.isRecommended ? `Yes${skill.recommendedReason ? ` — ${skill.recommendedReason}` : \"\"}` : \"No\"}`,\n  );\n\n  if (skill.usageGuidance) {\n    lines.push(\"\");\n    lines.push(\"Usage Guidance:\");\n    lines.push(`  ${skill.usageGuidance}`);\n  }\n\n  lines.push(\"\");\n  lines.push(`Local Status: ${isInstalled ? \"Installed\" : \"Not installed\"}`);\n\n  return lines.join(\"\\n\");\n}\n\nexport default class Info extends BaseCommand {\n  static summary = \"Show detailed information about a skill\";\n  static description =\n    \"Display comprehensive information about a skill including metadata, relationships, and content preview\";\n\n  static examples = [\n    {\n      description: \"Show info for a skill by ID\",\n      command: \"<%= config.bin %> <%= command.id %> web-framework-react\",\n    },\n    {\n      description: \"Show info without content preview\",\n      command: \"<%= config.bin %> <%= command.id %> web-framework-react --no-preview\",\n    },\n    {\n      description: \"Show info from a custom source\",\n      command: \"<%= config.bin %> <%= command.id %> my-skill --source github:org/marketplace\",\n    },\n  ];\n\n  static args = {\n    skill: Args.string({\n      description: \"Skill ID or alias to look up\",\n      required: true,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    preview: Flags.boolean({\n      description: \"Show content preview from SKILL.md\",\n      default: true,\n      allowNo: true,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(Info);\n\n    try {\n      this.log(STATUS_MESSAGES.LOADING_SKILLS);\n\n      const { sourceResult } = await loadSource({\n        sourceFlag: flags.source,\n        projectDir: process.cwd(),\n      });\n      const { sourcePath, isLocal } = sourceResult;\n\n      this.log(`Loaded from ${isLocal ? \"local\" : \"remote\"}: ${sourcePath}`);\n\n      const result = await resolveSkillInfo({\n        query: args.skill,\n        skills: matrix.skills,\n        slugToId: matrix.slugMap.slugToId,\n        projectDir: process.cwd(),\n        sourcePath,\n        isLocal,\n        includePreview: flags.preview,\n      });\n\n      if (!result.resolved) {\n        this.log(\"\");\n        this.error(`Skill \"${args.skill}\" not found.`, { exit: false });\n\n        if (result.suggestions.length > 0) {\n          this.log(\"\");\n          this.log(\"Did you mean one of these?\");\n          for (const suggestion of result.suggestions) {\n            this.log(`  - ${suggestion}`);\n          }\n        }\n\n        this.log(\"\");\n        this.logInfo(`Use '${CLI_BIN_NAME} search <query>' to find available skills.`);\n        this.log(\"\");\n        this.exit(EXIT_CODES.ERROR);\n      }\n\n      const { skill, isInstalled, preview } = result.resolved;\n\n      this.log(\"\");\n      this.log(formatSkillInfo(skill, isInstalled));\n\n      if (flags.preview && preview.length > 0) {\n        this.log(\"\");\n        this.log(`--- Content Preview (first ${CONTENT_PREVIEW_LINES} lines) ---`);\n        for (const line of preview) {\n          this.log(line);\n        }\n      }\n\n      this.log(\"\");\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/cli/commands/info.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport { BaseCommand } from \"../base-command.js\";\nimport { loadSource, resolveSkillInfo } from \"../lib/operations/index.js\";\nimport { matrix } from \"../lib/matrix/matrix-provider\";\nimport { CLI_BIN_NAME } from \"../consts.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\nimport { STATUS_MESSAGES } from \"../utils/messages.js\";\nimport type { ResolvedSkill, SkillRequirement } from \"../types/index.js\";\n\nconst CONTENT_PREVIEW_LINES = 10;\n\nfunction formatRequirements(requirements: SkillRequirement[]): string {\n  if (requirements.length === 0) {\n    return \"(none)\";\n  }\n  return requirements\n    .map((req) => {\n      const prefix = req.needsAny ? \"any of: \" : \"\";\n      return prefix + req.skillIds.join(\", \");\n    })\n    .join(\"; \");\n}\n\nfunction formatSkillInfo(skill: ResolvedSkill, isInstalled: boolean): string {\n  const lines: string[] = [];\n\n  lines.push(`Skill: ${skill.id}`);\n  if (skill.slug) {\n    lines.push(`Slug: ${skill.slug}`);\n  }\n  lines.push(`Display Name: ${skill.displayName}`);\n  lines.push(`Author: ${skill.author}`);\n  lines.push(`Category: ${skill.category}`);\n  lines.push(\"\");\n  lines.push(\"Description:\");\n  lines.push(`  ${skill.description}`);\n  lines.push(\"\");\n  lines.push(`Requires: ${formatRequirements(skill.requires)}`);\n  lines.push(\n    `Conflicts with: ${skill.conflictsWith.length > 0 ? skill.conflictsWith.map((r) => r.skillId).join(\", \") : \"(none)\"}`,\n  );\n  lines.push(\n    `Recommended: ${skill.isRecommended ? `Yes${skill.recommendedReason ? ` — ${skill.recommendedReason}` : \"\"}` : \"No\"}`,\n  );\n\n  if (skill.usageGuidance) {\n    lines.push(\"\");\n    lines.push(\"Usage Guidance:\");\n    lines.push(`  ${skill.usageGuidance}`);\n  }\n\n  lines.push(\"\");\n  lines.push(`Local Status: ${isInstalled ? \"Installed\" : \"Not installed\"}`);\n\n  return lines.join(\"\\n\");\n}\n\nexport default class Info extends BaseCommand {\n  static summary = \"Show detailed information about a skill\";\n  static description =\n    \"Display comprehensive information about a skill including metadata, relationships, and content preview\";\n\n  static examples = [\n    {\n      description: \"Show info for a skill by ID\",\n      command: \"<%= config.bin %> <%= command.id %> web-framework-react\",\n    },\n    {\n      description: \"Show info without content preview\",\n      command: \"<%= config.bin %> <%= command.id %> web-framework-react --no-preview\",\n    },\n    {\n      description: \"Show info from a custom source\",\n      command: \"<%= config.bin %> <%= command.id %> my-skill --source github:org/marketplace\",\n    },\n  ];\n\n  static args = {\n    skill: Args.string({\n      description: \"Skill ID or alias to look up\",\n      required: true,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    preview: Flags.boolean({\n      description: \"Show content preview from SKILL.md\",\n      default: true,\n      allowNo: true,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(Info);\n    const projectDir = process.cwd();\n\n    try {\n      const { sourcePath, isLocal } = await this.loadSourceAndLog(flags.source, projectDir);\n      const result = await resolveSkillInfo({\n        query: args.skill,\n        skills: matrix.skills,\n        slugToId: matrix.slugMap.slugToId,\n        projectDir,\n        sourcePath,\n        isLocal,\n        includePreview: flags.preview,\n      });\n\n      if (!result.resolved) {\n        this.reportNotFound(args.skill, result.suggestions);\n        return;\n      }\n\n      this.displaySkillInfo(result.resolved, flags.preview);\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  private async loadSourceAndLog(\n    sourceFlag: string | undefined,\n    projectDir: string,\n  ): Promise<{ sourcePath: string; isLocal: boolean }> {\n    this.log(STATUS_MESSAGES.LOADING_SKILLS);\n\n    const { sourceResult } = await loadSource({ sourceFlag, projectDir });\n    const { sourcePath, isLocal } = sourceResult;\n\n    this.log(`Loaded from ${isLocal ? \"local\" : \"remote\"}: ${sourcePath}`);\n    return { sourcePath, isLocal };\n  }\n\n  private reportNotFound(query: string, suggestions: string[]): never {\n    this.log(\"\");\n    this.error(`Skill \"${query}\" not found.`, { exit: false });\n\n    if (suggestions.length > 0) {\n      this.log(\"\");\n      this.log(\"Did you mean one of these?\");\n      for (const suggestion of suggestions) {\n        this.log(`  - ${suggestion}`);\n      }\n    }\n\n    this.log(\"\");\n    this.logInfo(`Use '${CLI_BIN_NAME} search <query>' to find available skills.`);\n    this.log(\"\");\n    this.exit(EXIT_CODES.ERROR);\n  }\n\n  private displaySkillInfo(\n    resolved: { skill: ResolvedSkill; isInstalled: boolean; preview: string[] },\n    showPreview: boolean,\n  ): void {\n    const { skill, isInstalled, preview } = resolved;\n\n    this.log(\"\");\n    this.log(formatSkillInfo(skill, isInstalled));\n\n    if (showPreview && preview.length > 0) {\n      this.log(\"\");\n      this.log(`--- Content Preview (first ${CONTENT_PREVIEW_LINES} lines) ---`);\n      for (const line of preview) {\n        this.log(line);\n      }\n    }\n\n    this.log(\"\");\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/commands/init.js

@@ -2,8 +2,9 @@
 import {
   Init,
   formatDashboardText,
+  getDashboardData,
   showDashboard
-} from "../chunk-GED2F75H.js";
+} from "../chunk-7FFNNDJQ.js";
 import "../chunk-HZQOFFKA.js";
 import "../chunk-UNEJKTLP.js";
 import "../chunk-YVFGISUO.js";
@@ -36,12 +37,8 @@ import "../chunk-HEQVUIHQ.js";
 import "../chunk-U3IGFMCY.js";
 import "../chunk-HK53FRMU.js";
 import "../chunk-B7KZLXHV.js";
-import {
-  getDashboardData
-} from "../chunk-DCVCFBQ7.js";
+import "../chunk-5UJJQFET.js";
 import "../chunk-N6A7A4RA.js";
-import "../chunk-O5ZWS26C.js";
-import "../chunk-XQK4S22C.js";
 import "../chunk-FBZR46GC.js";
 import "../chunk-TMTUTUEV.js";
 import "../chunk-B6MYECV6.js";