@agents-inc/cli 0.32.1

package/dist/commands/import/skill.js

@@ -0,0 +1,361 @@
+#!/usr/bin/env node
+import {
+  INFO_MESSAGES,
+  STATUS_MESSAGES
+} from "../../chunk-R74PZWQS.js";
+import {
+  BaseCommand,
+  EXIT_CODES
+} from "../../chunk-ODUOU55D.js";
+import {
+  IMPORT_DEFAULTS,
+  computeFileHash,
+  fetchFromSource,
+  getCurrentDate
+} from "../../chunk-MM7NK5N2.js";
+import "../../chunk-T4EXUIBY.js";
+import {
+  copy,
+  directoryExists,
+  ensureDir,
+  fileExists,
+  getErrorMessage,
+  importedSkillMetadataSchema,
+  listDirectories,
+  readFile,
+  writeFile
+} from "../../chunk-BZN2Z5P7.js";
+import {
+  DEFAULT_SKILLS_SUBDIR,
+  GITHUB_SOURCE,
+  LOCAL_SKILLS_PATH,
+  STANDARD_FILES,
+  YAML_FORMATTING
+} from "../../chunk-LAPCUV4D.js";
+import {
+  init_esm_shims
+} from "../../chunk-DHET7RCE.js";
+
+// src/cli/commands/import/skill.ts
+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 = 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(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 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.";
+  static examples = [
+    {
+      description: "List available skills from a repository",
+      command: "<%= config.bin %> import skill github:vercel-labs/agent-skills --list"
+    },
+    {
+      description: "Import a specific skill",
+      command: "<%= config.bin %> import skill github:vercel-labs/agent-skills --skill react-best-practices"
+    },
+    {
+      description: "Import all skills from a repository",
+      command: "<%= config.bin %> import skill github:vercel-labs/agent-skills --all"
+    },
+    {
+      description: "Import with custom skills directory",
+      command: "<%= config.bin %> import skill github:owner/repo --skill my-skill --subdir custom-skills"
+    }
+  ];
+  static args = {
+    source: Args.string({
+      description: "GitHub repository source (github:owner/repo, https://github.com/owner/repo, or owner/repo)",
+      required: true
+    })
+  };
+  static flags = {
+    ...BaseCommand.baseFlags,
+    skill: Flags.string({
+      char: "n",
+      description: "Name of the specific skill to import",
+      required: false
+    }),
+    all: Flags.boolean({
+      char: "a",
+      description: "Import all skills from the repository",
+      default: false
+    }),
+    list: Flags.boolean({
+      char: "l",
+      description: "List available skills without importing",
+      default: false
+    }),
+    subdir: Flags.string({
+      description: "Subdirectory containing skills (default: skills)",
+      default: DEFAULT_SKILLS_SUBDIR
+    }),
+    force: Flags.boolean({
+      char: "f",
+      description: "Overwrite existing skills",
+      default: false
+    }),
+    refresh: Flags.boolean({
+      description: "Force refresh from remote (ignore cache)",
+      default: false
+    })
+  };
+  async run() {
+    const { args, flags } = await this.parse(_ImportSkill);
+    const projectDir = process.cwd();
+    this.log("");
+    this.log("Import Third-Party Skill");
+    this.log("");
+    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
+      });
+    }
+    if (flags.skill && flags.all) {
+      this.error("Cannot use --skill and --all together", {
+        exit: EXIT_CODES.INVALID_ARGS
+      });
+    }
+    const { gigetSource, displaySource } = parseGitHubSource(args.source);
+    this.log(`Source: ${displaySource}`);
+    this.log(STATUS_MESSAGES.FETCHING_REPOSITORY);
+    let repoPath;
+    try {
+      const result = await fetchFromSource(gigetSource, {
+        forceRefresh: flags.refresh
+      });
+      repoPath = result.path;
+      this.log(result.fromCache ? "Using cached source" : "Downloaded fresh copy");
+    } catch (error) {
+      this.error(error instanceof Error ? error.message : `Failed to fetch: ${args.source}`, {
+        exit: EXIT_CODES.NETWORK_ERROR
+      });
+    }
+    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}
+The repository doesn't have a '${flags.subdir}' directory.
+Use --subdir to specify a different location.`,
+        { exit: EXIT_CODES.INVALID_ARGS }
+      );
+    }
+    const skillDirs = await listDirectories(skillsDir);
+    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
+      });
+    }
+    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;
+    }
+    let skillsToImport = [];
+    if (flags.all) {
+      skillsToImport = availableSkills;
+    } else if (flags.skill) {
+      if (!availableSkills.includes(flags.skill)) {
+        this.error(
+          `Skill '${flags.skill}' not found in repository.
+Available skills: ${availableSkills.join(", ")}
+Use --list to see all available skills.`,
+          { exit: EXIT_CODES.INVALID_ARGS }
+        );
+      }
+      skillsToImport = [flags.skill];
+    }
+    const destDir = path.join(projectDir, LOCAL_SKILLS_PATH);
+    if (flags["dry-run"]) {
+      this.log("");
+      this.log("[DRY RUN] Would import the following skills:");
+      for (const skill of skillsToImport) {
+        const destPath = path.join(destDir, skill);
+        const exists = await directoryExists(destPath);
+        this.log(`  - ${skill} -> ${destPath}${exists ? " (exists)" : ""}`);
+      }
+      return;
+    }
+    this.log("");
+    this.log(`Importing ${skillsToImport.length} skill(s)...`);
+    let imported = 0;
+    let skipped = 0;
+    for (const skillName of skillsToImport) {
+      const sourcePath = path.join(skillsDir, skillName);
+      const destPath = path.join(destDir, skillName);
+      if (await directoryExists(destPath)) {
+        if (!flags.force) {
+          this.warn(`Skipping '${skillName}': already exists. Use --force to overwrite.`);
+          skipped++;
+          continue;
+        }
+      }
+      try {
+        await this.importSkill(sourcePath, destPath, skillName, displaySource);
+        this.logSuccess(`Imported: ${skillName}`);
+        imported++;
+      } catch (error) {
+        this.warn(`Failed to import '${skillName}': ${getErrorMessage(error)}`);
+        skipped++;
+      }
+    }
+    this.log("");
+    this.logSuccess(`Import complete: ${imported} imported, ${skipped} skipped`);
+    this.log(`Skills location: ${destDir}`);
+    this.log("");
+    this.log(INFO_MESSAGES.RUN_COMPILE);
+    this.log("");
+  }
+  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 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 computeFileHash(skillMdPath);
+    await ensureDir(path.dirname(destPath));
+    await copy(sourcePath, destPath);
+    await this.injectForkedFromMetadata(destPath, skillName, source, contentHash);
+  }
+  async injectForkedFromMetadata(destPath, skillName, source, contentHash) {
+    const metadataYamlPath = path.join(destPath, METADATA_YAML_FILE);
+    const metadataJsonPath = path.join(destPath, METADATA_JSON_FILE);
+    const forkedFrom = {
+      source,
+      skill_name: skillName,
+      content_hash: 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) {
+        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: 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 {
+        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: 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: IMPORT_DEFAULTS.CATEGORY,
+      category_exclusive: false,
+      author: IMPORT_DEFAULTS.AUTHOR,
+      forked_from: forkedFrom
+    };
+    const yamlContent = stringifyYaml(minimalMetadata, {
+      lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE
+    });
+    await writeFile(metadataYamlPath, yamlContent);
+  }
+};
+export {
+  ImportSkill as default
+};
+//# sourceMappingURL=skill.js.map

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

@@ -0,0 +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 { 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

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+import {
+  STATUS_MESSAGES
+} from "../chunk-R74PZWQS.js";
+import {
+  BaseCommand,
+  EXIT_CODES
+} from "../chunk-ODUOU55D.js";
+import {
+  discoverLocalSkills,
+  loadSkillsMatrixFromSource
+} from "../chunk-MM7NK5N2.js";
+import "../chunk-T4EXUIBY.js";
+import {
+  fileExists,
+  readFile
+} from "../chunk-BZN2Z5P7.js";
+import {
+  STANDARD_FILES
+} from "../chunk-LAPCUV4D.js";
+import {
+  init_esm_shims
+} from "../chunk-DHET7RCE.js";
+
+// src/cli/commands/info.ts
+init_esm_shims();
+import { Args, Flags } from "@oclif/core";
+import path from "path";
+var CONTENT_PREVIEW_LINES = 10;
+var MAX_LINE_LENGTH = 80;
+var MAX_SUGGESTIONS = 5;
+function stripFrontmatter(content) {
+  const lines = content.split("\n");
+  let inFrontmatter = false;
+  let frontmatterEndIndex = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line === "---") {
+      if (!inFrontmatter) {
+        inFrontmatter = true;
+      } else {
+        frontmatterEndIndex = i + 1;
+        break;
+      }
+    }
+  }
+  return lines.slice(frontmatterEndIndex).join("\n");
+}
+function getPreviewLines(content, maxLines) {
+  const body = stripFrontmatter(content);
+  const lines = body.split("\n");
+  const result = [];
+  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;
+      result.push(truncated);
+    }
+  }
+  return result;
+}
+function formatRelations(relations) {
+  if (relations.length === 0) {
+    return "(none)";
+  }
+  return relations.map((r) => r.skillId).join(", ");
+}
+function formatRequirements(requirements) {
+  if (requirements.length === 0) {
+    return "(none)";
+  }
+  return requirements.map((req) => {
+    const prefix = req.needsAny ? "any of: " : "";
+    return prefix + req.skillIds.join(", ");
+  }).join("; ");
+}
+function formatTags(tags) {
+  if (tags.length === 0) {
+    return "(none)";
+  }
+  return tags.join(", ");
+}
+function findSuggestions(skills, query, maxSuggestions) {
+  const lowerQuery = query.toLowerCase();
+  const matches = [];
+  for (const skill of Object.values(skills)) {
+    if (!skill) continue;
+    if (matches.length >= maxSuggestions) break;
+    if (skill.id.toLowerCase().includes(lowerQuery) || skill.displayName?.toLowerCase().includes(lowerQuery)) {
+      matches.push(skill.id);
+    }
+  }
+  return matches;
+}
+function formatSkillInfo(skill, isInstalled) {
+  const lines = [];
+  lines.push(`Skill: ${skill.id}`);
+  if (skill.displayName) {
+    lines.push(`Alias: ${skill.displayName}`);
+  }
+  lines.push(`Author: ${skill.author}`);
+  lines.push(`Category: ${skill.category}`);
+  lines.push("");
+  lines.push("Description:");
+  lines.push(`  ${skill.description}`);
+  lines.push("");
+  lines.push(`Tags: ${formatTags(skill.tags)}`);
+  lines.push("");
+  lines.push(`Requires: ${formatRequirements(skill.requires)}`);
+  lines.push(`Conflicts with: ${formatRelations(skill.conflictsWith)}`);
+  lines.push(`Recommends: ${formatRelations(skill.recommends)}`);
+  if (skill.usageGuidance) {
+    lines.push("");
+    lines.push("Usage Guidance:");
+    lines.push(`  ${skill.usageGuidance}`);
+  }
+  lines.push("");
+  lines.push(`Local Status: ${isInstalled ? "Installed" : "Not installed"}`);
+  return lines.join("\n");
+}
+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",
+      required: true
+    })
+  };
+  static flags = {
+    ...BaseCommand.baseFlags,
+    preview: Flags.boolean({
+      description: "Show content preview from SKILL.md",
+      default: true,
+      allowNo: true
+    })
+  };
+  async run() {
+    const { args, flags } = await this.parse(_Info);
+    try {
+      this.log(STATUS_MESSAGES.LOADING_SKILLS);
+      const { matrix, sourcePath, isLocal } = await loadSkillsMatrixFromSource({
+        sourceFlag: flags.source
+      });
+      this.log(`Loaded from ${isLocal ? "local" : "remote"}: ${sourcePath}`);
+      let skill = matrix.skills[args.skill];
+      if (!skill) {
+        const fullId = matrix.displayNameToId[args.skill];
+        if (fullId) {
+          skill = matrix.skills[fullId];
+        }
+      }
+      if (!skill) {
+        const suggestions = findSuggestions(matrix.skills, args.skill, MAX_SUGGESTIONS);
+        this.log("");
+        this.error(`Skill "${args.skill}" not found.`, { exit: false });
+        if (suggestions.length > 0) {
+          this.log("");
+          this.log("Did you mean one of these?");
+          for (const suggestion of suggestions) {
+            this.log(`  - ${suggestion}`);
+          }
+        }
+        this.log("");
+        this.logInfo("Use 'cc search <query>' to find available skills.");
+        this.log("");
+        this.exit(EXIT_CODES.ERROR);
+      }
+      const localSkillsResult = await discoverLocalSkills(process.cwd());
+      const localSkillIds = localSkillsResult?.skills.map((s) => s.id) || [];
+      const isInstalled = localSkillIds.includes(skill.id);
+      this.log("");
+      this.log(formatSkillInfo(skill, isInstalled));
+      if (flags.preview) {
+        let skillMdPath;
+        if (skill.local && skill.localPath) {
+          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, STANDARD_FILES.SKILL_MD);
+        }
+        if (await fileExists(skillMdPath)) {
+          const content = await readFile(skillMdPath);
+          const previewLines = getPreviewLines(content, CONTENT_PREVIEW_LINES);
+          if (previewLines.length > 0) {
+            this.log("");
+            this.log(`--- Content Preview (first ${CONTENT_PREVIEW_LINES} lines) ---`);
+            for (const line of previewLines) {
+              this.log(line);
+            }
+          }
+        }
+      }
+      this.log("");
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+};
+export {
+  Info as default
+};
+//# sourceMappingURL=info.js.map

package/dist/commands/info.js.map

@@ -0,0 +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 { 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":[]}