@claude-collective/cli 0.26.0 → 0.29.4

package/dist/commands/import/skill.js

@@ -1,27 +1,36 @@
 #!/usr/bin/env node
+import {
+  INFO_MESSAGES,
+  STATUS_MESSAGES
+} from "../../chunk-FUPBGSRA.js";
 import {
   BaseCommand,
   EXIT_CODES
-} from "../../chunk-OBXAY23Y.js";
+} from "../../chunk-5I6VY2E7.js";
 import {
+  IMPORT_DEFAULTS,
+  computeFileHash,
   fetchFromSource,
-  getCurrentDate,
-  hashFile
-} from "../../chunk-ETQ3BPGU.js";
+  getCurrentDate
+} from "../../chunk-SSHG7MEE.js";
 import {
   copy,
   directoryExists,
   ensureDir,
   fileExists,
+  getErrorMessage,
   importedSkillMetadataSchema,
   listDirectories,
   readFile,
   writeFile
-} from "../../chunk-ZDREFYD2.js";
-import "../../chunk-HWD32NP7.js";
+} from "../../chunk-5WIHSJRO.js";
 import {
-  LOCAL_SKILLS_PATH
-} from "../../chunk-O6ZTD7ZI.js";
+  DEFAULT_SKILLS_SUBDIR,
+  GITHUB_SOURCE,
+  LOCAL_SKILLS_PATH,
+  STANDARD_FILES,
+  YAML_FORMATTING
+} from "../../chunk-IFODQTCX.js";
 import {
   init_esm_shims
 } from "../../chunk-AWKZ5BDL.js";
@@ -31,29 +40,28 @@ init_esm_shims();
 import { Args, Flags } from "@oclif/core";
 import path from "path";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
-var SKILL_MD_FILE = "SKILL.md";
-var METADATA_YAML_FILE = "metadata.yaml";
-var METADATA_JSON_FILE = "metadata.json";
-var DEFAULT_SKILLS_SUBDIR = "skills";
+var SKILL_MD_FILE = STANDARD_FILES.SKILL_MD;
+var METADATA_YAML_FILE = STANDARD_FILES.METADATA_YAML;
+var METADATA_JSON_FILE = STANDARD_FILES.METADATA_JSON;
 function parseGitHubSource(source) {
-  if (source.startsWith("https://github.com/")) {
-    const path2 = source.replace("https://github.com/", "");
+  if (source.startsWith(GITHUB_SOURCE.HTTPS_PREFIX)) {
+    const path2 = source.replace(GITHUB_SOURCE.HTTPS_PREFIX, "");
     return {
-      gigetSource: `github:${path2}`,
+      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${path2}`,
       displaySource: source
     };
   }
-  if (source.startsWith("github:") || source.startsWith("gh:")) {
-    const normalized = source.replace(/^gh:/, "github:");
+  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: `https://github.com/${normalized.replace("github:", "")}`
+      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${normalized.replace(GITHUB_SOURCE.GITHUB_PREFIX, "")}`
     };
   }
   if (source.includes("/") && !source.includes(":")) {
     return {
-      gigetSource: `github:${source}`,
-      displaySource: `https://github.com/${source}`
+      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${source}`,
+      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${source}`
     };
   }
   return {
@@ -61,6 +69,16 @@ function parseGitHubSource(source) {
     displaySource: source
   };
 }
+async function discoverValidSkills(skillsDir, skillDirs) {
+  const validSkills = [];
+  for (const skillDir of skillDirs) {
+    const skillMdPath = path.join(skillsDir, skillDir, SKILL_MD_FILE);
+    if (await fileExists(skillMdPath)) {
+      validSkills.push(skillDir);
+    }
+  }
+  return validSkills.sort();
+}
 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.";
@@ -137,7 +155,7 @@ var ImportSkill = class _ImportSkill extends BaseCommand {
     }
     const { gigetSource, displaySource } = parseGitHubSource(args.source);
     this.log(`Source: ${displaySource}`);
-    this.log("Fetching repository...");
+    this.log(STATUS_MESSAGES.FETCHING_REPOSITORY);
     let repoPath;
     try {
       const result = await fetchFromSource(gigetSource, {
@@ -150,7 +168,24 @@ var ImportSkill = class _ImportSkill extends BaseCommand {
         exit: EXIT_CODES.NETWORK_ERROR
       });
     }
-    const skillsDir = path.join(repoPath, flags.subdir);
+    const subdir = flags.subdir;
+    if (/\0/.test(subdir)) {
+      this.error("--subdir contains null bytes", {
+        exit: EXIT_CODES.INVALID_ARGS
+      });
+    }
+    if (path.isAbsolute(subdir)) {
+      this.error(`--subdir must be a relative path, got: ${subdir}`, {
+        exit: EXIT_CODES.INVALID_ARGS
+      });
+    }
+    const skillsDir = path.resolve(path.join(repoPath, subdir));
+    const resolvedRepoPath = path.resolve(repoPath);
+    if (!skillsDir.startsWith(resolvedRepoPath + path.sep) && skillsDir !== resolvedRepoPath) {
+      this.error(`--subdir path escapes repository boundary: ${subdir}`, {
+        exit: EXIT_CODES.INVALID_ARGS
+      });
+    }
     if (!await directoryExists(skillsDir)) {
       this.error(
         `Skills directory not found: ${flags.subdir}
@@ -160,13 +195,12 @@ Use --subdir to specify a different location.`,
       );
     }
     const skillDirs = await listDirectories(skillsDir);
-    const availableSkills = await this.discoverValidSkills(skillsDir, skillDirs);
+    const availableSkills = await discoverValidSkills(skillsDir, skillDirs);
     if (availableSkills.length === 0) {
-      this.error(
-        `No valid skills found in ${flags.subdir}/
-Skills must have a SKILL.md file.`,
-        { exit: EXIT_CODES.ERROR }
-      );
+      this.error(`No valid skills found in ${flags.subdir}/
+Skills must have a SKILL.md file.`, {
+        exit: EXIT_CODES.ERROR
+      });
     }
     if (flags.list) {
       this.log("");
@@ -223,9 +257,7 @@ Use --list to see all available skills.`,
         this.logSuccess(`Imported: ${skillName}`);
         imported++;
       } catch (error) {
-        this.warn(
-          `Failed to import '${skillName}': ${error instanceof Error ? error.message : String(error)}`
-        );
+        this.warn(`Failed to import '${skillName}': ${getErrorMessage(error)}`);
         skipped++;
       }
     }
@@ -233,25 +265,20 @@ Use --list to see all available skills.`,
     this.logSuccess(`Import complete: ${imported} imported, ${skipped} skipped`);
     this.log(`Skills location: ${destDir}`);
     this.log("");
-    this.log("Run 'cc compile' to include imported skills in your agents.");
+    this.log(INFO_MESSAGES.RUN_COMPILE);
     this.log("");
   }
-  async discoverValidSkills(skillsDir, skillDirs) {
-    const validSkills = [];
-    for (const skillDir of skillDirs) {
-      const skillMdPath = path.join(skillsDir, skillDir, SKILL_MD_FILE);
-      if (await fileExists(skillMdPath)) {
-        validSkills.push(skillDir);
-      }
-    }
-    return validSkills.sort();
-  }
   async importSkill(sourcePath, destPath, skillName, source) {
     const skillMdPath = path.join(sourcePath, SKILL_MD_FILE);
     if (!await fileExists(skillMdPath)) {
-      throw new Error("Missing required SKILL.md file");
+      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, SKILL_MD_FILE)}`
+      );
     }
-    const contentHash = await hashFile(skillMdPath);
+    const contentHash = await computeFileHash(skillMdPath);
     await ensureDir(path.dirname(destPath));
     await copy(sourcePath, destPath);
     await this.injectForkedFromMetadata(destPath, skillName, source, contentHash);
@@ -271,17 +298,25 @@ Use --list to see all available skills.`,
       let yamlContent2 = rawContent;
       let schemaComment = "";
       if (lines[0]?.startsWith("# yaml-language-server:")) {
-        schemaComment = lines[0] + "\n";
+        schemaComment = `${lines[0]}
+`;
         yamlContent2 = lines.slice(1).join("\n");
       }
       const raw = parseYaml(yamlContent2);
       const parseResult = importedSkillMetadataSchema.safeParse(raw);
       if (!parseResult.success) {
-        this.warn(`Malformed metadata.yaml at ${metadataYamlPath} \u2014 existing fields may be lost`);
+        this.warn(
+          `Malformed metadata.yaml at ${metadataYamlPath} \u2014 existing fields may be lost
+  Validation errors: ${parseResult.error.issues.map((i) => i.message).join(", ")}
+  Expected fields: cli_name (string), cli_description (string), category (string)
+  Validate your YAML syntax at https://yamllint.com`
+        );
       }
       const metadata = parseResult.success ? parseResult.data : { forked_from: void 0 };
       metadata.forked_from = forkedFrom;
-      const newYamlContent = stringifyYaml(metadata, { lineWidth: 0 });
+      const newYamlContent = stringifyYaml(metadata, {
+        lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE
+      });
       await writeFile(metadataYamlPath, schemaComment + newYamlContent);
       return;
     }
@@ -291,25 +326,31 @@ Use --list to see all available skills.`,
       try {
         jsonParsed = JSON.parse(rawContent);
       } catch {
-        this.warn(`Malformed JSON in ${metadataJsonPath} \u2014 skipping metadata injection`);
+        this.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 : { forked_from: void 0 };
       metadata.forked_from = forkedFrom;
-      const yamlContent2 = stringifyYaml(metadata, { lineWidth: 0 });
+      const yamlContent2 = stringifyYaml(metadata, { lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE });
       await writeFile(metadataYamlPath, yamlContent2);
       return;
     }
     const minimalMetadata = {
       cli_name: skillName.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
       cli_description: "Imported from third-party repository",
-      category: "imported",
+      category: IMPORT_DEFAULTS.CATEGORY,
       category_exclusive: false,
-      author: "@imported",
+      author: IMPORT_DEFAULTS.AUTHOR,
       forked_from: forkedFrom
     };
-    const yamlContent = stringifyYaml(minimalMetadata, { lineWidth: 0 });
+    const yamlContent = stringifyYaml(minimalMetadata, {
+      lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE
+    });
     await writeFile(metadataYamlPath, yamlContent);
   }
 };

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 { parse as parseYaml, stringify as stringifyYaml } from \"yaml\";\nimport { BaseCommand } from \"../../base-command.js\";\nimport { EXIT_CODES } from \"../../lib/exit-codes.js\";\nimport { fetchFromSource } from \"../../lib/loading/index.js\";\nimport { importedSkillMetadataSchema } from \"../../lib/schemas.js\";\nimport { getCurrentDate, hashFile } 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 { LOCAL_SKILLS_PATH } from \"../../consts.js\";\n\n/**\n * Metadata for tracking third-party imports. Different from ForkedFromMetadata\n * in skill-metadata.ts which tracks internal fork lineage (uses skill_id\n * instead of source/skill_name).\n */\ntype ImportedForkedFromMetadata = {\n  source: string;\n  skill_name: string;\n  content_hash: string;\n  date: string;\n};\n\ntype SkillMetadata = {\n  forked_from?: ImportedForkedFromMetadata;\n  [key: string]: unknown;\n};\n\nconst SKILL_MD_FILE = \"SKILL.md\";\nconst METADATA_YAML_FILE = \"metadata.yaml\";\nconst METADATA_JSON_FILE = \"metadata.json\";\nconst DEFAULT_SKILLS_SUBDIR = \"skills\";\n\nfunction parseGitHubSource(source: string): {\n  gigetSource: string;\n  displaySource: string;\n} {\n  if (source.startsWith(\"https://github.com/\")) {\n    const path = source.replace(\"https://github.com/\", \"\");\n    return {\n      gigetSource: `github:${path}`,\n      displaySource: source,\n    };\n  }\n\n  if (source.startsWith(\"github:\") || source.startsWith(\"gh:\")) {\n    const normalized = source.replace(/^gh:/, \"github:\");\n    return {\n      gigetSource: normalized,\n      displaySource: `https://github.com/${normalized.replace(\"github:\", \"\")}`,\n    };\n  }\n\n  if (source.includes(\"/\") && !source.includes(\":\")) {\n    return {\n      gigetSource: `github:${source}`,\n      displaySource: `https://github.com/${source}`,\n    };\n  }\n\n  return {\n    gigetSource: source,\n    displaySource: source,\n  };\n}\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(\"Fetching repository...\");\n\n    let repoPath: string;\n    try {\n      const result = await fetchFromSource(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    const skillsDir = path.join(repoPath, flags.subdir);\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 skillDirs = await listDirectories(skillsDir);\n    const availableSkills = await this.discoverValidSkills(skillsDir, skillDirs);\n\n    if (availableSkills.length === 0) {\n      this.error(\n        `No valid skills found in ${flags.subdir}/\\n` + `Skills 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    if (flags[\"dry-run\"]) {\n      this.log(\"\");\n      this.log(\"[DRY RUN] Would import the following skills:\");\n      for (const skill of skillsToImport) {\n        const destPath = path.join(destDir, skill);\n        const exists = await directoryExists(destPath);\n        this.log(`  - ${skill} -> ${destPath}${exists ? \" (exists)\" : \"\"}`);\n      }\n      return;\n    }\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 this.importSkill(sourcePath, destPath, skillName, displaySource);\n        this.logSuccess(`Imported: ${skillName}`);\n        imported++;\n      } catch (error) {\n        this.warn(\n          `Failed to import '${skillName}': ${error instanceof Error ? error.message : String(error)}`,\n        );\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(\"Run 'cc compile' to include imported skills in your agents.\");\n    this.log(\"\");\n  }\n\n  private async discoverValidSkills(skillsDir: string, skillDirs: string[]): Promise<string[]> {\n    const validSkills: string[] = [];\n\n    for (const skillDir of skillDirs) {\n      const skillMdPath = path.join(skillsDir, skillDir, SKILL_MD_FILE);\n      if (await fileExists(skillMdPath)) {\n        validSkills.push(skillDir);\n      }\n    }\n\n    return validSkills.sort();\n  }\n\n  private async importSkill(\n    sourcePath: string,\n    destPath: string,\n    skillName: string,\n    source: string,\n  ): Promise<void> {\n    const skillMdPath = path.join(sourcePath, SKILL_MD_FILE);\n    if (!(await fileExists(skillMdPath))) {\n      throw new Error(\"Missing required SKILL.md file\");\n    }\n\n    const contentHash = await hashFile(skillMdPath);\n\n    await ensureDir(path.dirname(destPath));\n    await copy(sourcePath, destPath);\n\n    await this.injectForkedFromMetadata(destPath, skillName, source, contentHash);\n  }\n\n  private async injectForkedFromMetadata(\n    destPath: string,\n    skillName: string,\n    source: string,\n    contentHash: string,\n  ): Promise<void> {\n    const metadataYamlPath = path.join(destPath, METADATA_YAML_FILE);\n    const metadataJsonPath = path.join(destPath, METADATA_JSON_FILE);\n\n    const forkedFrom: ImportedForkedFromMetadata = {\n      source,\n      skill_name: skillName,\n      content_hash: 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        this.warn(`Malformed metadata.yaml at ${metadataYamlPath} — existing fields may be lost`);\n      }\n      const metadata = parseResult.success\n        ? (parseResult.data as SkillMetadata)\n        : { forked_from: undefined };\n      metadata.forked_from = forkedFrom;\n\n      const newYamlContent = stringifyYaml(metadata, { lineWidth: 0 });\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        this.warn(`Malformed JSON in ${metadataJsonPath} — skipping metadata injection`);\n        return;\n      }\n      const jsonResult = importedSkillMetadataSchema.safeParse(jsonParsed);\n      const metadata = jsonResult.success\n        ? (jsonResult.data as SkillMetadata)\n        : { forked_from: undefined };\n      metadata.forked_from = forkedFrom;\n\n      const yamlContent = stringifyYaml(metadata, { lineWidth: 0 });\n      await writeFile(metadataYamlPath, yamlContent);\n      return;\n    }\n\n    const minimalMetadata: SkillMetadata = {\n      cli_name: skillName\n        .split(\"-\")\n        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n        .join(\" \"),\n      cli_description: \"Imported from third-party repository\",\n      category: \"imported\",\n      category_exclusive: false,\n      author: \"@imported\",\n      forked_from: forkedFrom,\n    };\n\n    const yamlContent = stringifyYaml(minimalMetadata, { lineWidth: 0 });\n    await writeFile(metadataYamlPath, yamlContent);\n  }\n}\n"],"mappings":"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","names":["path","yamlContent"]}
+{"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 {\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\n/**\n * Metadata for tracking third-party imports. Different from ForkedFromMetadata\n * in skill-metadata.ts which tracks internal fork lineage (uses skill_id\n * instead of source/skill_name).\n */\ntype ImportedForkedFromMetadata = {\n  source: string;\n  skill_name: string;\n  content_hash: string;\n  date: string;\n};\n\ntype SkillMetadata = {\n  forked_from?: ImportedForkedFromMetadata;\n  [key: string]: unknown;\n};\n\nconst SKILL_MD_FILE = STANDARD_FILES.SKILL_MD;\nconst METADATA_YAML_FILE = STANDARD_FILES.METADATA_YAML;\nconst METADATA_JSON_FILE = STANDARD_FILES.METADATA_JSON;\n\nfunction parseGitHubSource(source: string): {\n  gigetSource: string;\n  displaySource: string;\n} {\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\nasync function discoverValidSkills(skillsDir: string, skillDirs: string[]): Promise<string[]> {\n  const validSkills: string[] = [];\n\n  for (const skillDir of skillDirs) {\n    const skillMdPath = path.join(skillsDir, skillDir, SKILL_MD_FILE);\n    if (await fileExists(skillMdPath)) {\n      validSkills.push(skillDir);\n    }\n  }\n\n  return validSkills.sort();\n}\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 fetchFromSource(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 skillDirs = await listDirectories(skillsDir);\n    const availableSkills = await discoverValidSkills(skillsDir, skillDirs);\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    if (flags[\"dry-run\"]) {\n      this.log(\"\");\n      this.log(\"[DRY RUN] Would import the following skills:\");\n      for (const skill of skillsToImport) {\n        const destPath = path.join(destDir, skill);\n        const exists = await directoryExists(destPath);\n        this.log(`  - ${skill} -> ${destPath}${exists ? \" (exists)\" : \"\"}`);\n      }\n      return;\n    }\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 this.importSkill(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  private async importSkill(\n    sourcePath: string,\n    destPath: string,\n    skillName: string,\n    source: string,\n  ): Promise<void> {\n    const skillMdPath = path.join(sourcePath, SKILL_MD_FILE);\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, SKILL_MD_FILE)}`,\n      );\n    }\n\n    const contentHash = await computeFileHash(skillMdPath);\n\n    await ensureDir(path.dirname(destPath));\n    await copy(sourcePath, destPath);\n\n    await this.injectForkedFromMetadata(destPath, skillName, source, contentHash);\n  }\n\n  private async injectForkedFromMetadata(\n    destPath: string,\n    skillName: string,\n    source: string,\n    contentHash: string,\n  ): Promise<void> {\n    const metadataYamlPath = path.join(destPath, METADATA_YAML_FILE);\n    const metadataJsonPath = path.join(destPath, METADATA_JSON_FILE);\n\n    const forkedFrom: ImportedForkedFromMetadata = {\n      source,\n      skill_name: skillName,\n      content_hash: 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        this.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: cli_name (string), cli_description (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        : { forked_from: undefined };\n      metadata.forked_from = 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        this.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        : { forked_from: undefined };\n      metadata.forked_from = 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      cli_name: skillName\n        .split(\"-\")\n        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n        .join(\" \"),\n      cli_description: \"Imported from third-party repository\",\n      category: IMPORT_DEFAULTS.CATEGORY,\n      category_exclusive: false,\n      author: IMPORT_DEFAULTS.AUTHOR,\n      forked_from: forkedFrom,\n    };\n\n    const yamlContent = stringifyYaml(minimalMetadata, {\n      lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE,\n    });\n    await writeFile(metadataYamlPath, yamlContent);\n  }\n}\n"],"mappings":"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","names":["path","yamlContent"]}

package/dist/commands/info.js

@@ -1,18 +1,22 @@
 #!/usr/bin/env node
+import {
+  STATUS_MESSAGES
+} from "../chunk-FUPBGSRA.js";
 import {
   BaseCommand,
   EXIT_CODES
-} from "../chunk-OBXAY23Y.js";
+} from "../chunk-5I6VY2E7.js";
 import {
   discoverLocalSkills,
   loadSkillsMatrixFromSource
-} from "../chunk-ETQ3BPGU.js";
+} from "../chunk-SSHG7MEE.js";
 import {
   fileExists,
   readFile
-} from "../chunk-ZDREFYD2.js";
-import "../chunk-HWD32NP7.js";
-import "../chunk-O6ZTD7ZI.js";
+} from "../chunk-5WIHSJRO.js";
+import {
+  STANDARD_FILES
+} from "../chunk-IFODQTCX.js";
 import {
   init_esm_shims
 } from "../chunk-AWKZ5BDL.js";
@@ -48,7 +52,7 @@ function getPreviewLines(content, maxLines) {
   for (const line of lines) {
     if (result.length >= maxLines) break;
     if (line.trim() || result.length > 0) {
-      const truncated = line.length > MAX_LINE_LENGTH ? line.slice(0, MAX_LINE_LENGTH - 3) + "..." : line;
+      const truncated = line.length > MAX_LINE_LENGTH ? `${line.slice(0, MAX_LINE_LENGTH - 3)}...` : line;
       result.push(truncated);
     }
   }
@@ -116,6 +120,20 @@ function formatSkillInfo(skill, isInstalled) {
 var Info = class _Info extends BaseCommand {
   static summary = "Show detailed information about a skill";
   static description = "Display comprehensive information about a skill including metadata, relationships, and content preview";
+  static examples = [
+    {
+      description: "Show info for a skill by ID",
+      command: "<%= config.bin %> <%= command.id %> web-framework-react"
+    },
+    {
+      description: "Show info without content preview",
+      command: "<%= config.bin %> <%= command.id %> web-framework-react --no-preview"
+    },
+    {
+      description: "Show info from a custom source",
+      command: "<%= config.bin %> <%= command.id %> my-skill --source github:org/marketplace"
+    }
+  ];
   static args = {
     skill: Args.string({
       description: "Skill ID or alias to look up",
@@ -133,7 +151,7 @@ var Info = class _Info extends BaseCommand {
   async run() {
     const { args, flags } = await this.parse(_Info);
     try {
-      this.log("Loading skills...");
+      this.log(STATUS_MESSAGES.LOADING_SKILLS);
       const { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({
         sourceFlag: flags.source
       });
@@ -169,10 +187,10 @@ var Info = class _Info extends BaseCommand {
       if (flags.preview) {
         let skillMdPath;
         if (skill.local && skill.localPath) {
-          skillMdPath = path.join(process.cwd(), skill.localPath, "SKILL.md");
+          skillMdPath = path.join(process.cwd(), skill.localPath, STANDARD_FILES.SKILL_MD);
         } else {
           const sourceDir = isLocal ? sourcePath : path.dirname(sourcePath);
-          skillMdPath = path.join(sourceDir, skill.path, "SKILL.md");
+          skillMdPath = path.join(sourceDir, skill.path, STANDARD_FILES.SKILL_MD);
         }
         if (await fileExists(skillMdPath)) {
           const content = await readFile(skillMdPath);

package/dist/commands/info.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/commands/info.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { BaseCommand } from \"../base-command.js\";\nimport { loadSkillsMatrixFromSource } from \"../lib/loading/index.js\";\nimport { discoverLocalSkills } from \"../lib/skills/index.js\";\nimport { fileExists, readFile } from \"../utils/fs.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\nimport type {\n  ResolvedSkill,\n  SkillDisplayName,\n  SkillId,\n  SkillRelation,\n  SkillRequirement,\n} from \"../types/index.js\";\n\nconst CONTENT_PREVIEW_LINES = 10;\nconst MAX_LINE_LENGTH = 80;\nconst MAX_SUGGESTIONS = 5;\n\nfunction stripFrontmatter(content: string): string {\n  const lines = content.split(\"\\n\");\n  let inFrontmatter = false;\n  let frontmatterEndIndex = 0;\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i].trim();\n    if (line === \"---\") {\n      if (!inFrontmatter) {\n        inFrontmatter = true;\n      } else {\n        frontmatterEndIndex = i + 1;\n        break;\n      }\n    }\n  }\n\n  return lines.slice(frontmatterEndIndex).join(\"\\n\");\n}\n\nfunction getPreviewLines(content: string, maxLines: number): string[] {\n  const body = stripFrontmatter(content);\n  const lines = body.split(\"\\n\");\n  const result: string[] = [];\n\n  for (const line of lines) {\n    if (result.length >= maxLines) break;\n    if (line.trim() || result.length > 0) {\n      const truncated =\n        line.length > MAX_LINE_LENGTH ? line.slice(0, MAX_LINE_LENGTH - 3) + \"...\" : line;\n      result.push(truncated);\n    }\n  }\n\n  return result;\n}\n\nfunction formatRelations(relations: SkillRelation[]): string {\n  if (relations.length === 0) {\n    return \"(none)\";\n  }\n  return relations.map((r) => r.skillId).join(\", \");\n}\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 formatTags(tags: string[]): string {\n  if (tags.length === 0) {\n    return \"(none)\";\n  }\n  return tags.join(\", \");\n}\n\nfunction findSuggestions(\n  skills: Partial<Record<SkillId, ResolvedSkill>>,\n  query: string,\n  maxSuggestions: number,\n): string[] {\n  const lowerQuery = query.toLowerCase();\n  const matches: string[] = [];\n\n  for (const skill of Object.values(skills)) {\n    if (!skill) continue;\n    if (matches.length >= maxSuggestions) break;\n    if (\n      skill.id.toLowerCase().includes(lowerQuery) ||\n      skill.displayName?.toLowerCase().includes(lowerQuery)\n    ) {\n      matches.push(skill.id);\n    }\n  }\n\n  return matches;\n}\n\nfunction formatSkillInfo(skill: ResolvedSkill, isInstalled: boolean): string {\n  const lines: string[] = [];\n\n  lines.push(`Skill: ${skill.id}`);\n  if (skill.displayName) {\n    lines.push(`Alias: ${skill.displayName}`);\n  }\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(`Tags: ${formatTags(skill.tags)}`);\n  lines.push(\"\");\n  lines.push(`Requires: ${formatRequirements(skill.requires)}`);\n  lines.push(`Conflicts with: ${formatRelations(skill.conflictsWith)}`);\n  lines.push(`Recommends: ${formatRelations(skill.recommends)}`);\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 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(\"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      // CLI arg is an untyped string — cast at data boundary\n      let skill: ResolvedSkill | undefined = matrix.skills[args.skill as SkillId];\n\n      if (!skill) {\n        // Try alias lookup — CLI arg is an untyped string\n        const fullId = matrix.displayNameToId[args.skill as SkillDisplayName];\n        if (fullId) {\n          skill = matrix.skills[fullId];\n        }\n      }\n\n      if (!skill) {\n        const suggestions = findSuggestions(matrix.skills, args.skill, MAX_SUGGESTIONS);\n\n        this.log(\"\");\n        this.error(`Skill \"${args.skill}\" 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 'cc search <query>' to find available skills.\");\n        this.log(\"\");\n        this.exit(EXIT_CODES.ERROR);\n      }\n\n      const localSkillsResult = await discoverLocalSkills(process.cwd());\n      const localSkillIds = localSkillsResult?.skills.map((s) => s.id) || [];\n      const isInstalled = localSkillIds.includes(skill.id);\n\n      this.log(\"\");\n      this.log(formatSkillInfo(skill, isInstalled));\n\n      if (flags.preview) {\n        let skillMdPath: string;\n\n        if (skill.local && skill.localPath) {\n          skillMdPath = path.join(process.cwd(), skill.localPath, \"SKILL.md\");\n        } else {\n          const sourceDir = isLocal ? sourcePath : path.dirname(sourcePath);\n          skillMdPath = path.join(sourceDir, skill.path, \"SKILL.md\");\n        }\n\n        if (await fileExists(skillMdPath)) {\n          const content = await readFile(skillMdPath);\n          const previewLines = getPreviewLines(content, CONTENT_PREVIEW_LINES);\n\n          if (previewLines.length > 0) {\n            this.log(\"\");\n            this.log(`--- Content Preview (first ${CONTENT_PREVIEW_LINES} lines) ---`);\n            for (const line of previewLines) {\n              this.log(line);\n            }\n          }\n        }\n      }\n\n      this.log(\"\");\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA,SAAS,MAAM,aAAa;AAC5B,OAAO,UAAU;AAcjB,IAAM,wBAAwB;AAC9B,IAAM,kBAAkB;AACxB,IAAM,kBAAkB;AAExB,SAAS,iBAAiB,SAAyB;AACjD,QAAM,QAAQ,QAAQ,MAAM,IAAI;AAChC,MAAI,gBAAgB;AACpB,MAAI,sBAAsB;AAE1B,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,OAAO,MAAM,CAAC,EAAE,KAAK;AAC3B,QAAI,SAAS,OAAO;AAClB,UAAI,CAAC,eAAe;AAClB,wBAAgB;AAAA,MAClB,OAAO;AACL,8BAAsB,IAAI;AAC1B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,MAAM,MAAM,mBAAmB,EAAE,KAAK,IAAI;AACnD;AAEA,SAAS,gBAAgB,SAAiB,UAA4B;AACpE,QAAM,OAAO,iBAAiB,OAAO;AACrC,QAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,QAAM,SAAmB,CAAC;AAE1B,aAAW,QAAQ,OAAO;AACxB,QAAI,OAAO,UAAU,SAAU;AAC/B,QAAI,KAAK,KAAK,KAAK,OAAO,SAAS,GAAG;AACpC,YAAM,YACJ,KAAK,SAAS,kBAAkB,KAAK,MAAM,GAAG,kBAAkB,CAAC,IAAI,QAAQ;AAC/E,aAAO,KAAK,SAAS;AAAA,IACvB;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,gBAAgB,WAAoC;AAC3D,MAAI,UAAU,WAAW,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,SAAO,UAAU,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI;AAClD;AAEA,SAAS,mBAAmB,cAA0C;AACpE,MAAI,aAAa,WAAW,GAAG;AAC7B,WAAO;AAAA,EACT;AACA,SAAO,aACJ,IAAI,CAAC,QAAQ;AACZ,UAAM,SAAS,IAAI,WAAW,aAAa;AAC3C,WAAO,SAAS,IAAI,SAAS,KAAK,IAAI;AAAA,EACxC,CAAC,EACA,KAAK,IAAI;AACd;AAEA,SAAS,WAAW,MAAwB;AAC1C,MAAI,KAAK,WAAW,GAAG;AACrB,WAAO;AAAA,EACT;AACA,SAAO,KAAK,KAAK,IAAI;AACvB;AAEA,SAAS,gBACP,QACA,OACA,gBACU;AACV,QAAM,aAAa,MAAM,YAAY;AACrC,QAAM,UAAoB,CAAC;AAE3B,aAAW,SAAS,OAAO,OAAO,MAAM,GAAG;AACzC,QAAI,CAAC,MAAO;AACZ,QAAI,QAAQ,UAAU,eAAgB;AACtC,QACE,MAAM,GAAG,YAAY,EAAE,SAAS,UAAU,KAC1C,MAAM,aAAa,YAAY,EAAE,SAAS,UAAU,GACpD;AACA,cAAQ,KAAK,MAAM,EAAE;AAAA,IACvB;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,gBAAgB,OAAsB,aAA8B;AAC3E,QAAM,QAAkB,CAAC;AAEzB,QAAM,KAAK,UAAU,MAAM,EAAE,EAAE;AAC/B,MAAI,MAAM,aAAa;AACrB,UAAM,KAAK,UAAU,MAAM,WAAW,EAAE;AAAA,EAC1C;AACA,QAAM,KAAK,WAAW,MAAM,MAAM,EAAE;AACpC,QAAM,KAAK,aAAa,MAAM,QAAQ,EAAE;AACxC,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,cAAc;AACzB,QAAM,KAAK,KAAK,MAAM,WAAW,EAAE;AACnC,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,SAAS,WAAW,MAAM,IAAI,CAAC,EAAE;AAC5C,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,aAAa,mBAAmB,MAAM,QAAQ,CAAC,EAAE;AAC5D,QAAM,KAAK,mBAAmB,gBAAgB,MAAM,aAAa,CAAC,EAAE;AACpE,QAAM,KAAK,eAAe,gBAAgB,MAAM,UAAU,CAAC,EAAE;AAE7D,MAAI,MAAM,eAAe;AACvB,UAAM,KAAK,EAAE;AACb,UAAM,KAAK,iBAAiB;AAC5B,UAAM,KAAK,KAAK,MAAM,aAAa,EAAE;AAAA,EACvC;AAEA,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,iBAAiB,cAAc,cAAc,eAAe,EAAE;AAEzE,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,IAAqB,OAArB,MAAqB,cAAa,YAAY;AAAA,EAC5C,OAAO,UAAU;AAAA,EACjB,OAAO,cACL;AAAA,EAEF,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,SAAS,MAAM,QAAQ;AAAA,MACrB,aAAa;AAAA,MACb,SAAS;AAAA,MACT,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAqB;AACzB,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,KAAK,MAAM,KAAI;AAE7C,QAAI;AACF,WAAK,IAAI,mBAAmB;AAE5B,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;AAGrE,UAAI,QAAmC,OAAO,OAAO,KAAK,KAAgB;AAE1E,UAAI,CAAC,OAAO;AAEV,cAAM,SAAS,OAAO,gBAAgB,KAAK,KAAyB;AACpE,YAAI,QAAQ;AACV,kBAAQ,OAAO,OAAO,MAAM;AAAA,QAC9B;AAAA,MACF;AAEA,UAAI,CAAC,OAAO;AACV,cAAM,cAAc,gBAAgB,OAAO,QAAQ,KAAK,OAAO,eAAe;AAE9E,aAAK,IAAI,EAAE;AACX,aAAK,MAAM,UAAU,KAAK,KAAK,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAE9D,YAAI,YAAY,SAAS,GAAG;AAC1B,eAAK,IAAI,EAAE;AACX,eAAK,IAAI,4BAA4B;AACrC,qBAAW,cAAc,aAAa;AACpC,iBAAK,IAAI,OAAO,UAAU,EAAE;AAAA,UAC9B;AAAA,QACF;AAEA,aAAK,IAAI,EAAE;AACX,aAAK,QAAQ,mDAAmD;AAChE,aAAK,IAAI,EAAE;AACX,aAAK,KAAK,WAAW,KAAK;AAAA,MAC5B;AAEA,YAAM,oBAAoB,MAAM,oBAAoB,QAAQ,IAAI,CAAC;AACjE,YAAM,gBAAgB,mBAAmB,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC;AACrE,YAAM,cAAc,cAAc,SAAS,MAAM,EAAE;AAEnD,WAAK,IAAI,EAAE;AACX,WAAK,IAAI,gBAAgB,OAAO,WAAW,CAAC;AAE5C,UAAI,MAAM,SAAS;AACjB,YAAI;AAEJ,YAAI,MAAM,SAAS,MAAM,WAAW;AAClC,wBAAc,KAAK,KAAK,QAAQ,IAAI,GAAG,MAAM,WAAW,UAAU;AAAA,QACpE,OAAO;AACL,gBAAM,YAAY,UAAU,aAAa,KAAK,QAAQ,UAAU;AAChE,wBAAc,KAAK,KAAK,WAAW,MAAM,MAAM,UAAU;AAAA,QAC3D;AAEA,YAAI,MAAM,WAAW,WAAW,GAAG;AACjC,gBAAM,UAAU,MAAM,SAAS,WAAW;AAC1C,gBAAM,eAAe,gBAAgB,SAAS,qBAAqB;AAEnE,cAAI,aAAa,SAAS,GAAG;AAC3B,iBAAK,IAAI,EAAE;AACX,iBAAK,IAAI,8BAA8B,qBAAqB,aAAa;AACzE,uBAAW,QAAQ,cAAc;AAC/B,mBAAK,IAAI,IAAI;AAAA,YACf;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,WAAK,IAAI,EAAE;AAAA,IACb,SAAS,OAAO;AACd,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/cli/commands/info.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { BaseCommand } from \"../base-command.js\";\nimport { loadSkillsMatrixFromSource } from \"../lib/loading/index.js\";\nimport { discoverLocalSkills } from \"../lib/skills/index.js\";\nimport { fileExists, readFile } from \"../utils/fs.js\";\nimport { STANDARD_FILES } from \"../consts.js\";\nimport { EXIT_CODES } from \"../lib/exit-codes.js\";\nimport { STATUS_MESSAGES } from \"../utils/messages.js\";\nimport type {\n  ResolvedSkill,\n  SkillDisplayName,\n  SkillId,\n  SkillRelation,\n  SkillRequirement,\n} from \"../types/index.js\";\n\nconst CONTENT_PREVIEW_LINES = 10;\nconst MAX_LINE_LENGTH = 80;\nconst MAX_SUGGESTIONS = 5;\n\nfunction stripFrontmatter(content: string): string {\n  const lines = content.split(\"\\n\");\n  let inFrontmatter = false;\n  let frontmatterEndIndex = 0;\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i].trim();\n    if (line === \"---\") {\n      if (!inFrontmatter) {\n        inFrontmatter = true;\n      } else {\n        frontmatterEndIndex = i + 1;\n        break;\n      }\n    }\n  }\n\n  return lines.slice(frontmatterEndIndex).join(\"\\n\");\n}\n\nfunction getPreviewLines(content: string, maxLines: number): string[] {\n  const body = stripFrontmatter(content);\n  const lines = body.split(\"\\n\");\n  const result: string[] = [];\n\n  for (const line of lines) {\n    if (result.length >= maxLines) break;\n    if (line.trim() || result.length > 0) {\n      const truncated =\n        line.length > MAX_LINE_LENGTH ? `${line.slice(0, MAX_LINE_LENGTH - 3)}...` : line;\n      result.push(truncated);\n    }\n  }\n\n  return result;\n}\n\nfunction formatRelations(relations: SkillRelation[]): string {\n  if (relations.length === 0) {\n    return \"(none)\";\n  }\n  return relations.map((r) => r.skillId).join(\", \");\n}\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 formatTags(tags: string[]): string {\n  if (tags.length === 0) {\n    return \"(none)\";\n  }\n  return tags.join(\", \");\n}\n\nfunction findSuggestions(\n  skills: Partial<Record<SkillId, ResolvedSkill>>,\n  query: string,\n  maxSuggestions: number,\n): string[] {\n  const lowerQuery = query.toLowerCase();\n  const matches: string[] = [];\n\n  for (const skill of Object.values(skills)) {\n    if (!skill) continue;\n    if (matches.length >= maxSuggestions) break;\n    if (\n      skill.id.toLowerCase().includes(lowerQuery) ||\n      skill.displayName?.toLowerCase().includes(lowerQuery)\n    ) {\n      matches.push(skill.id);\n    }\n  }\n\n  return matches;\n}\n\nfunction formatSkillInfo(skill: ResolvedSkill, isInstalled: boolean): string {\n  const lines: string[] = [];\n\n  lines.push(`Skill: ${skill.id}`);\n  if (skill.displayName) {\n    lines.push(`Alias: ${skill.displayName}`);\n  }\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(`Tags: ${formatTags(skill.tags)}`);\n  lines.push(\"\");\n  lines.push(`Requires: ${formatRequirements(skill.requires)}`);\n  lines.push(`Conflicts with: ${formatRelations(skill.conflictsWith)}`);\n  lines.push(`Recommends: ${formatRelations(skill.recommends)}`);\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 { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({\n        sourceFlag: flags.source,\n      });\n\n      this.log(`Loaded from ${isLocal ? \"local\" : \"remote\"}: ${sourcePath}`);\n\n      // CLI arg is an untyped string — cast at data boundary\n      let skill: ResolvedSkill | undefined = matrix.skills[args.skill as SkillId];\n\n      if (!skill) {\n        // Try alias lookup — CLI arg is an untyped string\n        const fullId = matrix.displayNameToId[args.skill as SkillDisplayName];\n        if (fullId) {\n          skill = matrix.skills[fullId];\n        }\n      }\n\n      if (!skill) {\n        const suggestions = findSuggestions(matrix.skills, args.skill, MAX_SUGGESTIONS);\n\n        this.log(\"\");\n        this.error(`Skill \"${args.skill}\" 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 'cc search <query>' to find available skills.\");\n        this.log(\"\");\n        this.exit(EXIT_CODES.ERROR);\n      }\n\n      const localSkillsResult = await discoverLocalSkills(process.cwd());\n      const localSkillIds = localSkillsResult?.skills.map((s) => s.id) || [];\n      const isInstalled = localSkillIds.includes(skill.id);\n\n      this.log(\"\");\n      this.log(formatSkillInfo(skill, isInstalled));\n\n      if (flags.preview) {\n        let skillMdPath: string;\n\n        if (skill.local && skill.localPath) {\n          skillMdPath = path.join(process.cwd(), skill.localPath, STANDARD_FILES.SKILL_MD);\n        } else {\n          const sourceDir = isLocal ? sourcePath : path.dirname(sourcePath);\n          skillMdPath = path.join(sourceDir, skill.path, STANDARD_FILES.SKILL_MD);\n        }\n\n        if (await fileExists(skillMdPath)) {\n          const content = await readFile(skillMdPath);\n          const previewLines = getPreviewLines(content, CONTENT_PREVIEW_LINES);\n\n          if (previewLines.length > 0) {\n            this.log(\"\");\n            this.log(`--- Content Preview (first ${CONTENT_PREVIEW_LINES} lines) ---`);\n            for (const line of previewLines) {\n              this.log(line);\n            }\n          }\n        }\n      }\n\n      this.log(\"\");\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n}\n"],"mappings":"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","names":[]}