skillli 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,1230 @@
+#!/usr/bin/env node
+
+// src/cli/index.ts
+import { Command } from "commander";
+
+// src/core/constants.ts
+import { homedir } from "os";
+import { join } from "path";
+var SKILLLI_DIR = join(homedir(), ".skillli");
+var LOCAL_INDEX_PATH = join(SKILLLI_DIR, "index.json");
+var CONFIG_PATH = join(SKILLLI_DIR, "config.json");
+var SKILLS_DIR = join(SKILLLI_DIR, "skills");
+var CACHE_DIR = join(SKILLLI_DIR, "cache");
+var DEFAULT_REGISTRY_URL = "https://raw.githubusercontent.com/skillli/registry/main/index.json";
+var SKILL_FILENAME = "SKILL.md";
+var MAX_SKILL_SIZE_BYTES = 5 * 1024 * 1024;
+var MAX_SKILL_MD_LINES = 500;
+var VERSION = "0.1.0";
+
+// src/cli/commands/init.ts
+import { mkdir, writeFile } from "fs/promises";
+import { join as join2 } from "path";
+import { existsSync } from "fs";
+import chalk from "chalk";
+
+// src/cli/utils/prompts.ts
+import inquirer from "inquirer";
+async function promptInit(defaults) {
+  return inquirer.prompt([
+    {
+      type: "input",
+      name: "name",
+      message: "Skill name (lowercase, hyphens):",
+      default: defaults?.name,
+      validate: (v) => /^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/.test(v) || "Must be lowercase alphanumeric with hyphens"
+    },
+    {
+      type: "input",
+      name: "version",
+      message: "Version:",
+      default: defaults?.version ?? "1.0.0"
+    },
+    {
+      type: "input",
+      name: "description",
+      message: "Description (10-500 chars):",
+      default: defaults?.description,
+      validate: (v) => v.length >= 10 && v.length <= 500 || "Must be 10-500 characters"
+    },
+    {
+      type: "input",
+      name: "author",
+      message: "Author (GitHub username):",
+      default: defaults?.author
+    },
+    {
+      type: "input",
+      name: "license",
+      message: "License:",
+      default: defaults?.license ?? "MIT"
+    },
+    {
+      type: "input",
+      name: "tags",
+      message: "Tags (comma-separated):",
+      default: defaults?.tags
+    },
+    {
+      type: "list",
+      name: "category",
+      message: "Category:",
+      choices: ["development", "creative", "enterprise", "data", "devops", "other"],
+      default: defaults?.category ?? "other"
+    }
+  ]);
+}
+
+// src/cli/commands/init.ts
+var SKILL_TEMPLATE = (answers) => `---
+name: ${answers.name}
+version: ${answers.version}
+description: ${answers.description}
+author: ${answers.author}
+license: ${answers.license}
+tags: [${answers.tags.join(", ")}]
+category: ${answers.category}
+trust-level: community
+user-invocable: true
+---
+
+# ${answers.name}
+
+${answers.description}
+
+## When to Use
+
+Describe when this skill should be invoked.
+
+## Instructions
+
+Describe what the AI should do when this skill is activated.
+
+## Examples
+
+Provide example inputs and expected behavior.
+`;
+function registerInitCommand(program2) {
+  program2.command("init [name]").description("Create a new skill from template").option("-d, --dir <path>", "Output directory", ".").action(async (name, options) => {
+    try {
+      const answers = await promptInit({ name });
+      const tags = answers.tags.split(",").map((t) => t.trim()).filter(Boolean);
+      const outputDir = join2(options.dir, answers.name);
+      if (existsSync(outputDir)) {
+        console.log(chalk.red(`Directory ${outputDir} already exists.`));
+        process.exit(1);
+      }
+      await mkdir(outputDir, { recursive: true });
+      await mkdir(join2(outputDir, "scripts"), { recursive: true });
+      await mkdir(join2(outputDir, "references"), { recursive: true });
+      const content = SKILL_TEMPLATE({ ...answers, tags });
+      await writeFile(join2(outputDir, "SKILL.md"), content);
+      const manifest = {
+        name: answers.name,
+        version: answers.version,
+        description: answers.description,
+        author: answers.author,
+        license: answers.license,
+        tags,
+        category: answers.category
+      };
+      await writeFile(join2(outputDir, "skillli.json"), JSON.stringify(manifest, null, 2));
+      console.log(chalk.green(`
+Skill "${answers.name}" created at ${outputDir}`));
+      console.log(chalk.gray("  Edit SKILL.md to add your skill instructions."));
+      console.log(chalk.gray("  Run `skillli publish` when ready to share.\n"));
+    } catch (error) {
+      console.error(chalk.red("Error:"), error);
+      process.exit(1);
+    }
+  });
+}
+
+// src/cli/commands/search.ts
+import chalk3 from "chalk";
+import ora from "ora";
+
+// src/core/search.ts
+function tokenize(text) {
+  return text.toLowerCase().split(/[\s\-_,./]+/).filter((t) => t.length > 1);
+}
+function textScore(tokens, text) {
+  const lower = text.toLowerCase();
+  let score = 0;
+  for (const token of tokens) {
+    if (lower.includes(token)) score += 1;
+  }
+  return score;
+}
+function scoreSkill(entry, queryTokens, options) {
+  let score = 0;
+  const matchedOn = [];
+  const nameScore = textScore(queryTokens, entry.name);
+  if (nameScore > 0) {
+    score += nameScore * 5;
+    matchedOn.push("name");
+  }
+  if (entry.name === options.query.toLowerCase()) {
+    score += 10;
+  }
+  const descScore = textScore(queryTokens, entry.description);
+  if (descScore > 0) {
+    score += descScore * 2;
+    matchedOn.push("description");
+  }
+  for (const token of queryTokens) {
+    if (entry.tags.some((t) => t.toLowerCase() === token)) {
+      score += 4;
+      if (!matchedOn.includes("tags")) matchedOn.push("tags");
+    }
+  }
+  if (options.tags) {
+    for (const tag of options.tags) {
+      if (entry.tags.includes(tag)) {
+        score += 3;
+        if (!matchedOn.includes("tags")) matchedOn.push("tags");
+      }
+    }
+  }
+  if (options.category && entry.category === options.category) {
+    score += 2;
+    matchedOn.push("category");
+  }
+  if (matchedOn.length > 0) {
+    if (entry.trustLevel === "official") score += 3;
+    if (entry.trustLevel === "verified") score += 1.5;
+    score += entry.rating.average * 0.5;
+    if (entry.downloads > 0) {
+      score += Math.log10(entry.downloads) * 0.5;
+    }
+  }
+  return { score, matchedOn };
+}
+function search(index, options) {
+  const queryTokens = tokenize(options.query);
+  const results = [];
+  for (const entry of Object.values(index.skills)) {
+    if (options.category && entry.category !== options.category) continue;
+    if (options.trustLevel && entry.trustLevel !== options.trustLevel) continue;
+    if (options.minRating && entry.rating.average < options.minRating) continue;
+    const { score, matchedOn } = scoreSkill(entry, queryTokens, options);
+    if (score > 0) {
+      results.push({ skill: entry, relevanceScore: score, matchedOn });
+    }
+  }
+  results.sort((a, b) => b.relevanceScore - a.relevanceScore);
+  const offset = options.offset ?? 0;
+  const limit = options.limit ?? 20;
+  return results.slice(offset, offset + limit);
+}
+
+// src/core/local-store.ts
+import { mkdir as mkdir2, readFile, writeFile as writeFile2 } from "fs/promises";
+import { existsSync as existsSync2 } from "fs";
+async function ensureDir() {
+  for (const dir of [SKILLLI_DIR, SKILLS_DIR, CACHE_DIR]) {
+    if (!existsSync2(dir)) {
+      await mkdir2(dir, { recursive: true });
+    }
+  }
+}
+function defaultConfig() {
+  return {
+    installedSkills: {},
+    registryUrl: DEFAULT_REGISTRY_URL,
+    lastSync: ""
+  };
+}
+function defaultIndex() {
+  return {
+    version: "1.0.0",
+    lastUpdated: "",
+    skills: {}
+  };
+}
+async function getConfig() {
+  await ensureDir();
+  if (!existsSync2(CONFIG_PATH)) {
+    const config = defaultConfig();
+    await saveConfig(config);
+    return config;
+  }
+  const raw = await readFile(CONFIG_PATH, "utf-8");
+  return JSON.parse(raw);
+}
+async function saveConfig(config) {
+  await ensureDir();
+  await writeFile2(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+async function getLocalIndex() {
+  await ensureDir();
+  if (!existsSync2(LOCAL_INDEX_PATH)) {
+    const index = defaultIndex();
+    await saveLocalIndex(index);
+    return index;
+  }
+  const raw = await readFile(LOCAL_INDEX_PATH, "utf-8");
+  return JSON.parse(raw);
+}
+async function saveLocalIndex(index) {
+  await ensureDir();
+  await writeFile2(LOCAL_INDEX_PATH, JSON.stringify(index, null, 2));
+}
+async function getInstalledSkills() {
+  const config = await getConfig();
+  return Object.values(config.installedSkills);
+}
+async function markInstalled(skill) {
+  const config = await getConfig();
+  config.installedSkills[skill.name] = skill;
+  await saveConfig(config);
+}
+async function markUninstalled(name) {
+  const config = await getConfig();
+  delete config.installedSkills[name];
+  await saveConfig(config);
+}
+
+// src/cli/utils/display.ts
+import chalk2 from "chalk";
+function trustBadge(level) {
+  switch (level) {
+    case "official":
+      return chalk2.green.bold("[OFFICIAL]");
+    case "verified":
+      return chalk2.blue.bold("[VERIFIED]");
+    default:
+      return chalk2.gray("[COMMUNITY]");
+  }
+}
+function stars(rating) {
+  const filled = Math.round(rating.average);
+  const empty = 5 - filled;
+  return chalk2.yellow("\u2605".repeat(filled)) + chalk2.gray("\u2606".repeat(empty));
+}
+function displaySearchResults(results) {
+  if (results.length === 0) {
+    console.log(chalk2.yellow("No skills found matching your query."));
+    return;
+  }
+  console.log(chalk2.bold(`
+Found ${results.length} skill(s):
+`));
+  for (const { skill, relevanceScore, matchedOn } of results) {
+    const badge = trustBadge(skill.trustLevel);
+    const rating = stars(skill.rating);
+    console.log(
+      `  ${chalk2.cyan.bold(skill.name)} ${chalk2.gray("v" + skill.version)} ${badge}`
+    );
+    console.log(`    ${skill.description}`);
+    console.log(
+      `    ${rating} ${chalk2.gray(`| ${skill.downloads} downloads | by ${skill.author}`)}`
+    );
+    console.log(
+      `    ${chalk2.gray("Tags:")} ${skill.tags.map((t) => chalk2.magenta(t)).join(", ")}`
+    );
+    console.log();
+  }
+}
+function displaySkillInfo(skill) {
+  console.log(chalk2.bold.cyan(`
+  ${skill.name}`) + chalk2.gray(` v${skill.version}`));
+  console.log(`  ${trustBadge(skill.trustLevel)}
+`);
+  console.log(`  ${skill.description}
+`);
+  console.log(`  ${chalk2.bold("Author:")}     ${skill.author}`);
+  console.log(`  ${chalk2.bold("Category:")}   ${skill.category}`);
+  console.log(`  ${chalk2.bold("Tags:")}       ${skill.tags.join(", ")}`);
+  console.log(`  ${chalk2.bold("Rating:")}     ${stars(skill.rating)} (${skill.rating.count} ratings)`);
+  console.log(`  ${chalk2.bold("Downloads:")}  ${skill.downloads}`);
+  if (skill.repository) {
+    console.log(`  ${chalk2.bold("Repository:")} ${skill.repository}`);
+  }
+  console.log(`  ${chalk2.bold("Published:")}  ${skill.publishedAt}`);
+  console.log(`  ${chalk2.bold("Updated:")}    ${skill.updatedAt}`);
+  console.log();
+}
+function displayTrustScore(score) {
+  let color;
+  if (score >= 70) color = chalk2.green;
+  else if (score >= 40) color = chalk2.yellow;
+  else color = chalk2.red;
+  const bar = "\u2588".repeat(Math.round(score / 5)) + chalk2.gray("\u2591".repeat(20 - Math.round(score / 5)));
+  console.log(`  Trust Score: ${color.bold(score.toString())} / 100  ${bar}`);
+}
+function displaySafeguardReport(result) {
+  console.log(chalk2.bold("\nSafeguard Report:"));
+  for (const check of result.checks) {
+    const icon = check.passed ? chalk2.green("\u2713") : check.severity === "error" ? chalk2.red("\u2717") : chalk2.yellow("\u26A0");
+    console.log(`  ${icon} ${check.name}: ${check.message}`);
+  }
+  displayTrustScore(result.score);
+  console.log();
+}
+function displayInstalledSkills(skills) {
+  if (skills.length === 0) {
+    console.log(chalk2.yellow("No skills installed."));
+    return;
+  }
+  console.log(chalk2.bold(`
+Installed skills (${skills.length}):
+`));
+  for (const skill of skills) {
+    console.log(
+      `  ${chalk2.cyan.bold(skill.name)} ${chalk2.gray("v" + skill.version)} ${chalk2.gray(`(${skill.source})`)}`
+    );
+    console.log(`    Installed: ${skill.installedAt}`);
+    console.log(`    Path: ${skill.path}`);
+    console.log();
+  }
+}
+
+// src/cli/commands/search.ts
+function registerSearchCommand(program2) {
+  program2.command("search <query>").description("Search for skills in the registry").option("-t, --tag <tags...>", "Filter by tags").option("-c, --category <category>", "Filter by category").option("--trust <level>", "Filter by trust level").option("--min-rating <n>", "Minimum rating", parseFloat).option("-l, --limit <n>", "Max results", parseInt).action(
+    async (query, options) => {
+      const spinner = ora("Searching skills...").start();
+      try {
+        const index = await getLocalIndex();
+        const results = search(index, {
+          query,
+          tags: options.tag,
+          category: options.category,
+          trustLevel: options.trust,
+          minRating: options.minRating,
+          limit: options.limit
+        });
+        spinner.stop();
+        displaySearchResults(results);
+      } catch (error) {
+        spinner.fail("Search failed");
+        console.error(chalk3.red(String(error)));
+        process.exit(1);
+      }
+    }
+  );
+}
+
+// src/cli/commands/install.ts
+import chalk4 from "chalk";
+import ora2 from "ora";
+
+// src/core/installer.ts
+import { mkdir as mkdir3, rm, symlink } from "fs/promises";
+import { existsSync as existsSync4 } from "fs";
+import { join as join4 } from "path";
+import { execSync } from "child_process";
+
+// src/core/errors.ts
+var SkillliError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "SkillliError";
+  }
+};
+var SkillValidationError = class extends SkillliError {
+  details;
+  constructor(message, details = []) {
+    super(message);
+    this.name = "SkillValidationError";
+    this.details = details;
+  }
+};
+var SkillNotFoundError = class extends SkillliError {
+  constructor(skillName) {
+    super(`Skill not found: ${skillName}`);
+    this.name = "SkillNotFoundError";
+  }
+};
+var RegistryError = class extends SkillliError {
+  constructor(message) {
+    super(message);
+    this.name = "RegistryError";
+  }
+};
+var InstallError = class extends SkillliError {
+  constructor(message) {
+    super(message);
+    this.name = "InstallError";
+  }
+};
+
+// src/core/registry.ts
+async function fetchIndex(registryUrl) {
+  const config = await getConfig();
+  const url = registryUrl ?? config.registryUrl ?? DEFAULT_REGISTRY_URL;
+  try {
+    const res = await fetch(url);
+    if (!res.ok) {
+      throw new RegistryError(`Failed to fetch registry: ${res.status} ${res.statusText}`);
+    }
+    const index = await res.json();
+    index.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
+    await saveLocalIndex(index);
+    return index;
+  } catch (error) {
+    if (error instanceof RegistryError) throw error;
+    const localIndex = await getLocalIndex();
+    if (Object.keys(localIndex.skills).length > 0) {
+      return localIndex;
+    }
+    throw new RegistryError(`Cannot reach registry at ${url}: ${error}`);
+  }
+}
+async function getSkillEntry(name) {
+  const index = await getLocalIndex();
+  const entry = index.skills[name];
+  if (!entry) {
+    throw new SkillNotFoundError(name);
+  }
+  return entry;
+}
+async function syncIndex() {
+  return fetchIndex();
+}
+
+// src/core/parser.ts
+import { readFile as readFile2 } from "fs/promises";
+import matter from "gray-matter";
+
+// src/core/schema.ts
+import { z } from "zod";
+var SkillCategorySchema = z.enum([
+  "development",
+  "creative",
+  "enterprise",
+  "data",
+  "devops",
+  "other"
+]);
+var TrustLevelSchema = z.enum(["community", "verified", "official"]);
+var SkillMetadataSchema = z.object({
+  name: z.string().min(1).max(100).regex(/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/, "Must be lowercase alphanumeric with hyphens, not starting/ending with hyphen"),
+  version: z.string().regex(/^\d+\.\d+\.\d+$/, "Must be valid semver (e.g. 1.0.0)"),
+  description: z.string().min(10).max(500),
+  author: z.string().min(1),
+  license: z.string().min(1),
+  tags: z.array(z.string().min(1).max(50)).min(1).max(20),
+  category: SkillCategorySchema,
+  repository: z.string().url().optional(),
+  homepage: z.string().url().optional(),
+  "min-skillli-version": z.string().optional(),
+  "trust-level": TrustLevelSchema.default("community"),
+  checksum: z.string().optional(),
+  "disable-model-invocation": z.boolean().default(false),
+  "user-invocable": z.boolean().default(true)
+});
+
+// src/core/parser.ts
+function normalizeMetadata(raw) {
+  return {
+    name: raw.name,
+    version: raw.version,
+    description: raw.description,
+    author: raw.author,
+    license: raw.license,
+    tags: raw.tags,
+    category: raw.category,
+    repository: raw.repository,
+    homepage: raw.homepage,
+    minSkillliVersion: raw["min-skillli-version"],
+    trustLevel: raw["trust-level"],
+    checksum: raw.checksum,
+    disableModelInvocation: raw["disable-model-invocation"],
+    userInvocable: raw["user-invocable"]
+  };
+}
+function validateMetadata(data) {
+  const result = SkillMetadataSchema.safeParse(data);
+  if (!result.success) {
+    const details = result.error.issues.map(
+      (issue) => `${issue.path.join(".")}: ${issue.message}`
+    );
+    throw new SkillValidationError("Invalid skill metadata", details);
+  }
+  return normalizeMetadata(result.data);
+}
+function parseSkillContent(content, filePath = "<inline>") {
+  const { data, content: body, matter: rawFrontmatter } = matter(content);
+  const metadata = validateMetadata(data);
+  return {
+    metadata,
+    content: body.trim(),
+    rawFrontmatter: rawFrontmatter || "",
+    filePath
+  };
+}
+async function parseSkillFile(filePath) {
+  const content = await readFile2(filePath, "utf-8");
+  return parseSkillContent(content, filePath);
+}
+function extractManifest(skill) {
+  const { metadata } = skill;
+  return {
+    name: metadata.name,
+    version: metadata.version,
+    description: metadata.description,
+    author: metadata.author,
+    license: metadata.license,
+    tags: metadata.tags,
+    category: metadata.category,
+    repository: metadata.repository,
+    trust_level: metadata.trustLevel,
+    checksum: metadata.checksum,
+    created_at: (/* @__PURE__ */ new Date()).toISOString(),
+    updated_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+
+// src/core/safeguards.ts
+import { stat } from "fs/promises";
+import { join as join3 } from "path";
+import { existsSync as existsSync3, readdirSync } from "fs";
+var PROHIBITED_PATTERNS = [
+  { pattern: /\beval\s*\(/, label: "eval()" },
+  { pattern: /\bexec\s*\(/, label: "exec()" },
+  { pattern: /\bexecSync\s*\(/, label: "execSync()" },
+  { pattern: /rm\s+-rf\s+\//, label: "rm -rf /" },
+  { pattern: /\bchild_process\b/, label: "child_process" },
+  { pattern: /\bProcess\.kill\b/i, label: "Process.kill" },
+  { pattern: /password\s*[:=]\s*['"][^'"]+['"]/, label: "hardcoded password" },
+  { pattern: /api[_-]?key\s*[:=]\s*['"][^'"]+['"]/, label: "hardcoded API key" },
+  { pattern: /[A-Za-z0-9+/]{100,}={0,2}/, label: "large base64 blob" }
+];
+var ALLOWED_SCRIPT_EXTENSIONS = [".sh", ".py", ".js", ".ts"];
+function checkSchema(skill) {
+  return {
+    name: "schema-validation",
+    passed: true,
+    severity: "info",
+    message: "SKILL.md metadata is valid"
+  };
+}
+function checkLineCount(content) {
+  const lines = content.split("\n").length;
+  const passed = lines <= MAX_SKILL_MD_LINES;
+  return {
+    name: "line-count",
+    passed,
+    severity: passed ? "info" : "warning",
+    message: passed ? `SKILL.md has ${lines} lines (max ${MAX_SKILL_MD_LINES})` : `SKILL.md has ${lines} lines, exceeds max of ${MAX_SKILL_MD_LINES}`
+  };
+}
+function checkProhibitedPatterns(content) {
+  const found = [];
+  for (const { pattern, label } of PROHIBITED_PATTERNS) {
+    if (pattern.test(content)) {
+      found.push(label);
+    }
+  }
+  const passed = found.length === 0;
+  return {
+    name: "prohibited-patterns",
+    passed,
+    severity: passed ? "info" : "error",
+    message: passed ? "No prohibited patterns detected" : `Prohibited patterns found: ${found.join(", ")}`
+  };
+}
+function checkScriptSafety(skillDir) {
+  const scriptsDir = join3(skillDir, "scripts");
+  if (!existsSync3(scriptsDir)) {
+    return {
+      name: "script-safety",
+      passed: true,
+      severity: "info",
+      message: "No scripts directory found"
+    };
+  }
+  const badFiles = [];
+  const files = readdirSync(scriptsDir, { recursive: true });
+  for (const file of files) {
+    const ext = "." + file.split(".").pop();
+    if (!ALLOWED_SCRIPT_EXTENSIONS.includes(ext)) {
+      badFiles.push(file);
+    }
+  }
+  const passed = badFiles.length === 0;
+  return {
+    name: "script-safety",
+    passed,
+    severity: passed ? "info" : "error",
+    message: passed ? "All scripts use allowed extensions" : `Disallowed script types: ${badFiles.join(", ")}`
+  };
+}
+async function checkFileSize(skillDir) {
+  let totalSize = 0;
+  const entries = readdirSync(skillDir, { recursive: true, withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isFile()) {
+      const fullPath = join3(entry.parentPath ?? skillDir, entry.name);
+      const s = await stat(fullPath);
+      totalSize += s.size;
+    }
+  }
+  const passed = totalSize <= MAX_SKILL_SIZE_BYTES;
+  return {
+    name: "file-size",
+    passed,
+    severity: passed ? "info" : "warning",
+    message: passed ? `Total size: ${(totalSize / 1024).toFixed(1)}KB (max ${MAX_SKILL_SIZE_BYTES / 1024 / 1024}MB)` : `Total size ${(totalSize / 1024 / 1024).toFixed(1)}MB exceeds max of ${MAX_SKILL_SIZE_BYTES / 1024 / 1024}MB`
+  };
+}
+async function runSafeguards(skill, skillDir) {
+  const checks = [];
+  checks.push(checkSchema(skill));
+  checks.push(checkLineCount(skill.content));
+  checks.push(checkProhibitedPatterns(skill.content + skill.rawFrontmatter));
+  if (skillDir) {
+    checks.push(checkScriptSafety(skillDir));
+    checks.push(await checkFileSize(skillDir));
+  }
+  const passed = checks.every((c) => c.passed || c.severity !== "error");
+  const score = computeTrustScore(skill);
+  return { passed, score, checks };
+}
+function computeTrustScore(skill, registryEntry) {
+  let score = 0;
+  if (skill.metadata.repository) score += 10;
+  if (skill.metadata.license) score += 10;
+  if (skill.metadata.trustLevel === "verified") score += 15;
+  if (skill.metadata.trustLevel === "official") score += 20;
+  if (registryEntry && registryEntry.rating.average >= 3.5) score += 15;
+  if (registryEntry && registryEntry.downloads > 100) score += 5;
+  if (registryEntry && registryEntry.downloads > 1e3) score += 5;
+  const patternCheck = checkProhibitedPatterns(skill.content);
+  const lineCheck = checkLineCount(skill.content);
+  if (patternCheck.passed) score += 20;
+  if (lineCheck.passed) score += 15;
+  return Math.min(score, 100);
+}
+
+// src/core/installer.ts
+async function installFromRegistry(name, version) {
+  const entry = await getSkillEntry(name);
+  if (!entry.repository) {
+    throw new InstallError(`Skill "${name}" has no repository URL`);
+  }
+  return installFromGithub(entry.repository, name);
+}
+async function installFromGithub(repoUrl, nameOverride) {
+  const name = nameOverride ?? repoUrl.split("/").pop()?.replace(/\.git$/, "") ?? "unknown";
+  const installPath = join4(SKILLS_DIR, name);
+  if (existsSync4(installPath)) {
+    await rm(installPath, { recursive: true });
+  }
+  await mkdir3(installPath, { recursive: true });
+  try {
+    execSync(`git clone --depth 1 "${repoUrl}" "${installPath}"`, {
+      stdio: "pipe",
+      timeout: 3e4
+    });
+  } catch {
+    throw new InstallError(`Failed to clone ${repoUrl}`);
+  }
+  const skillFile = join4(installPath, SKILL_FILENAME);
+  if (!existsSync4(skillFile)) {
+    await rm(installPath, { recursive: true });
+    throw new InstallError(`No ${SKILL_FILENAME} found in ${repoUrl}`);
+  }
+  const skill = await parseSkillFile(skillFile);
+  const safeguards = await runSafeguards(skill, installPath);
+  if (!safeguards.passed) {
+    await rm(installPath, { recursive: true });
+    const errors = safeguards.checks.filter((c) => !c.passed).map((c) => c.message);
+    throw new InstallError(`Skill failed safety checks: ${errors.join("; ")}`);
+  }
+  const installed = {
+    name: skill.metadata.name,
+    version: skill.metadata.version,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    path: installPath,
+    source: "github"
+  };
+  await markInstalled(installed);
+  return installed;
+}
+async function installFromLocal(dirPath) {
+  const skillFile = join4(dirPath, SKILL_FILENAME);
+  if (!existsSync4(skillFile)) {
+    throw new InstallError(`No ${SKILL_FILENAME} found in ${dirPath}`);
+  }
+  const skill = await parseSkillFile(skillFile);
+  const safeguards = await runSafeguards(skill, dirPath);
+  if (!safeguards.passed) {
+    const errors = safeguards.checks.filter((c) => !c.passed).map((c) => c.message);
+    throw new InstallError(`Skill failed safety checks: ${errors.join("; ")}`);
+  }
+  const installPath = join4(SKILLS_DIR, skill.metadata.name);
+  if (existsSync4(installPath)) {
+    await rm(installPath, { recursive: true });
+  }
+  execSync(`cp -r "${dirPath}" "${installPath}"`, { stdio: "pipe" });
+  const installed = {
+    name: skill.metadata.name,
+    version: skill.metadata.version,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    path: installPath,
+    source: "local"
+  };
+  await markInstalled(installed);
+  return installed;
+}
+async function uninstall(name) {
+  const installPath = join4(SKILLS_DIR, name);
+  if (existsSync4(installPath)) {
+    await rm(installPath, { recursive: true });
+  }
+  await markUninstalled(name);
+}
+async function linkToClaudeSkills(skill, projectDir = process.cwd()) {
+  const claudeSkillsDir = join4(projectDir, ".claude", "skills");
+  await mkdir3(claudeSkillsDir, { recursive: true });
+  const linkPath = join4(claudeSkillsDir, skill.name);
+  if (existsSync4(linkPath)) {
+    await rm(linkPath, { recursive: true });
+  }
+  await symlink(skill.path, linkPath, "dir");
+  return linkPath;
+}
+
+// src/cli/commands/install.ts
+function registerInstallCommand(program2) {
+  program2.command("install <skill>").description("Install a skill from the registry, GitHub URL, or local path").option("--link", "Symlink to .claude/skills/ for Claude Code", false).option("--local", "Install from a local directory").action(
+    async (skill, options) => {
+      const spinner = ora2(`Installing ${skill}...`).start();
+      try {
+        let installed;
+        if (options.local) {
+          installed = await installFromLocal(skill);
+        } else if (skill.startsWith("http") || skill.includes("github.com")) {
+          installed = await installFromGithub(skill);
+        } else {
+          installed = await installFromRegistry(skill);
+        }
+        spinner.succeed(`Installed ${chalk4.cyan(installed.name)} v${installed.version}`);
+        console.log(`  Path: ${installed.path}`);
+        if (options.link) {
+          const linkPath = await linkToClaudeSkills(installed);
+          console.log(`  Linked to: ${linkPath}`);
+        }
+      } catch (error) {
+        spinner.fail("Installation failed");
+        console.error(chalk4.red(String(error)));
+        process.exit(1);
+      }
+    }
+  );
+}
+
+// src/cli/commands/uninstall.ts
+import chalk5 from "chalk";
+import ora3 from "ora";
+function registerUninstallCommand(program2) {
+  program2.command("uninstall <skill>").description("Uninstall a skill").action(async (skill) => {
+    const spinner = ora3(`Uninstalling ${skill}...`).start();
+    try {
+      await uninstall(skill);
+      spinner.succeed(`Uninstalled ${chalk5.cyan(skill)}`);
+    } catch (error) {
+      spinner.fail("Uninstall failed");
+      console.error(chalk5.red(String(error)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/cli/commands/info.ts
+import chalk6 from "chalk";
+import ora4 from "ora";
+function registerInfoCommand(program2) {
+  program2.command("info <skill>").description("Display detailed information about a skill").action(async (skill) => {
+    const spinner = ora4("Fetching skill info...").start();
+    try {
+      const entry = await getSkillEntry(skill);
+      spinner.stop();
+      displaySkillInfo(entry);
+    } catch (error) {
+      spinner.fail("Failed to get skill info");
+      console.error(chalk6.red(String(error)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/cli/commands/list.ts
+import chalk7 from "chalk";
+function registerListCommand(program2) {
+  program2.command("list").description("List installed skills").option("--json", "Output as JSON").action(async (options) => {
+    try {
+      const skills = await getInstalledSkills();
+      if (options.json) {
+        console.log(JSON.stringify(skills, null, 2));
+      } else {
+        displayInstalledSkills(skills);
+      }
+    } catch (error) {
+      console.error(chalk7.red(String(error)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/cli/commands/rate.ts
+import chalk8 from "chalk";
+
+// src/core/ratings.ts
+async function submitRating(name, rating, userId, comment) {
+  const index = await getLocalIndex();
+  const entry = index.skills[name];
+  if (!entry) {
+    throw new SkillNotFoundError(name);
+  }
+  const current = entry.rating;
+  const newCount = current.count + 1;
+  const newAverage = (current.average * current.count + rating) / newCount;
+  const dist = [...current.distribution];
+  dist[rating - 1] += 1;
+  entry.rating = {
+    average: Math.round(newAverage * 10) / 10,
+    count: newCount,
+    distribution: dist
+  };
+  await saveLocalIndex(index);
+  return entry.rating;
+}
+function formatRating(rating) {
+  const filled = Math.round(rating.average);
+  const empty = 5 - filled;
+  const stars2 = "\u2605".repeat(filled) + "\u2606".repeat(empty);
+  return `${stars2} ${rating.average.toFixed(1)} (${rating.count} ratings)`;
+}
+
+// src/cli/commands/rate.ts
+function registerRateCommand(program2) {
+  program2.command("rate <skill> <rating>").description("Rate a skill (1-5 stars)").option("-m, --comment <text>", "Add a review comment").action(async (skill, ratingStr, options) => {
+    try {
+      const rating = parseInt(ratingStr, 10);
+      if (isNaN(rating) || rating < 1 || rating > 5) {
+        console.error(chalk8.red("Rating must be 1-5"));
+        process.exit(1);
+      }
+      const config = await getConfig();
+      const userId = config.userId ?? "anonymous";
+      const updated = await submitRating(skill, rating, userId, options.comment);
+      console.log(chalk8.green(`
+Rated ${chalk8.cyan(skill)}: ${"\u2605".repeat(rating)}${"\u2606".repeat(5 - rating)}`));
+      console.log(`  Updated: ${formatRating(updated)}`);
+    } catch (error) {
+      console.error(chalk8.red(String(error)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/cli/commands/update.ts
+import chalk9 from "chalk";
+import ora5 from "ora";
+function registerUpdateCommand(program2) {
+  program2.command("update").description("Update the local skill index from the registry").action(async () => {
+    const spinner = ora5("Syncing registry index...").start();
+    try {
+      const index = await syncIndex();
+      const count = Object.keys(index.skills).length;
+      spinner.succeed(`Index updated: ${count} skills available`);
+    } catch (error) {
+      spinner.fail("Failed to update index");
+      console.error(chalk9.red(String(error)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/cli/commands/publish.ts
+import chalk10 from "chalk";
+import ora6 from "ora";
+
+// src/core/publisher.ts
+import { readFile as readFile5 } from "fs/promises";
+import { join as join5 } from "path";
+import { createHash } from "crypto";
+import { existsSync as existsSync5, readdirSync as readdirSync2, statSync } from "fs";
+async function packageSkill(skillDir) {
+  const skillFile = join5(skillDir, SKILL_FILENAME);
+  if (!existsSync5(skillFile)) {
+    throw new SkillValidationError(`No ${SKILL_FILENAME} found in ${skillDir}`);
+  }
+  const skill = await parseSkillFile(skillFile);
+  const safeguards = await runSafeguards(skill, skillDir);
+  if (!safeguards.passed) {
+    const errors = safeguards.checks.filter((c) => !c.passed).map((c) => `[${c.severity}] ${c.message}`);
+    throw new SkillValidationError("Skill failed safety checks", errors);
+  }
+  const checksum = await computeDirectoryChecksum(skillDir);
+  const manifest = extractManifest(skill);
+  manifest.checksum = `sha256:${checksum}`;
+  manifest.files = listFiles(skillDir);
+  manifest.size_bytes = computeDirectorySize(skillDir);
+  return { skill, manifest, checksum };
+}
+async function computeDirectoryChecksum(dir) {
+  const hash = createHash("sha256");
+  const files = listFiles(dir).sort();
+  for (const file of files) {
+    const content = await readFile5(join5(dir, file));
+    hash.update(file);
+    hash.update(content);
+  }
+  return hash.digest("hex");
+}
+function listFiles(dir, prefix = "") {
+  const files = [];
+  const entries = readdirSync2(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === ".git" || entry.name === "node_modules") continue;
+    const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      files.push(...listFiles(join5(dir, entry.name), relative));
+    } else {
+      files.push(relative);
+    }
+  }
+  return files;
+}
+function computeDirectorySize(dir) {
+  let size = 0;
+  const entries = readdirSync2(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === ".git" || entry.name === "node_modules") continue;
+    const fullPath = join5(dir, entry.name);
+    if (entry.isDirectory()) {
+      size += computeDirectorySize(fullPath);
+    } else {
+      size += statSync(fullPath).size;
+    }
+  }
+  return size;
+}
+
+// src/cli/commands/publish.ts
+function registerPublishCommand(program2) {
+  program2.command("publish [path]").description("Publish a skill to the registry").option("--dry-run", "Validate without publishing").action(async (path, options) => {
+    const skillDir = path ?? process.cwd();
+    const spinner = ora6("Packaging skill...").start();
+    try {
+      const { skill, manifest, checksum } = await packageSkill(skillDir);
+      spinner.succeed(`Packaged ${chalk10.cyan(skill.metadata.name)} v${skill.metadata.version}`);
+      const safeguards = await runSafeguards(skill, skillDir);
+      displaySafeguardReport(safeguards);
+      console.log(chalk10.bold("Manifest:"));
+      console.log(JSON.stringify(manifest, null, 2));
+      if (options.dryRun) {
+        console.log(chalk10.yellow("\n  --dry-run: Skill was NOT published."));
+        console.log(chalk10.gray("  Remove --dry-run to publish for real.\n"));
+        return;
+      }
+      console.log(chalk10.green("\n  Skill validated and ready to publish!"));
+      console.log(chalk10.gray("  To publish, submit a PR to the skillli registry:"));
+      console.log(chalk10.gray("  https://github.com/skillli/registry\n"));
+      console.log(chalk10.gray(`  Checksum: sha256:${checksum}`));
+    } catch (error) {
+      spinner.fail("Publish failed");
+      console.error(chalk10.red(String(error)));
+      process.exit(1);
+    }
+  });
+}
+
+// src/cli/commands/trawl.ts
+import chalk11 from "chalk";
+import ora7 from "ora";
+
+// src/trawler/strategies.ts
+async function searchRegistry(query) {
+  const index = await getLocalIndex();
+  const tokens = query.toLowerCase().split(/\s+/);
+  const results = [];
+  for (const entry of Object.values(index.skills)) {
+    const text = `${entry.name} ${entry.description} ${entry.tags.join(" ")}`.toLowerCase();
+    const matchCount = tokens.filter((t) => text.includes(t)).length;
+    if (matchCount === 0) continue;
+    results.push({
+      source: "registry",
+      skill: entry,
+      confidence: Math.min(matchCount / tokens.length, 1),
+      url: entry.repository || `skillli://registry/${entry.name}`
+    });
+  }
+  return results;
+}
+async function searchGithub(query) {
+  const results = [];
+  const searchQuery = encodeURIComponent(`${query} SKILL.md in:path`);
+  const url = `https://api.github.com/search/repositories?q=${searchQuery}&per_page=10`;
+  try {
+    const res = await fetch(url, {
+      headers: { Accept: "application/vnd.github.v3+json" }
+    });
+    if (!res.ok) return results;
+    const data = await res.json();
+    for (const repo of data.items ?? []) {
+      const confidence = Math.min(
+        0.3 + (repo.stargazers_count > 10 ? 0.2 : 0) + (repo.stargazers_count > 100 ? 0.2 : 0),
+        0.9
+      );
+      results.push({
+        source: "github",
+        skill: {
+          name: repo.full_name.split("/").pop() ?? repo.full_name,
+          description: repo.description ?? "",
+          author: repo.full_name.split("/")[0],
+          repository: repo.html_url,
+          tags: repo.topics ?? []
+        },
+        confidence,
+        url: repo.html_url
+      });
+    }
+  } catch {
+  }
+  return results;
+}
+async function searchNpm(query) {
+  const results = [];
+  const searchQuery = encodeURIComponent(`${query} skill agent claude`);
+  const url = `https://registry.npmjs.org/-/v1/search?text=${searchQuery}&size=10`;
+  try {
+    const res = await fetch(url);
+    if (!res.ok) return results;
+    const data = await res.json();
+    for (const obj of data.objects ?? []) {
+      const pkg = obj.package;
+      results.push({
+        source: "npm",
+        skill: {
+          name: pkg.name,
+          description: pkg.description ?? "",
+          version: pkg.version,
+          repository: pkg.links.repository ?? "",
+          tags: pkg.keywords ?? []
+        },
+        confidence: Math.min(obj.score.final * 0.7, 0.85),
+        url: pkg.links.npm
+      });
+    }
+  } catch {
+  }
+  return results;
+}
+
+// src/trawler/ranker.ts
+function deduplicateResults(results) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const result of results) {
+    const key = result.skill.name?.toLowerCase() ?? result.url;
+    const existing = seen.get(key);
+    if (!existing || result.confidence > existing.confidence) {
+      seen.set(key, result);
+    }
+  }
+  return Array.from(seen.values());
+}
+function rankResults(results, query) {
+  const tokens = query.toLowerCase().split(/\s+/);
+  return results.map((result) => {
+    let bonus = 0;
+    if (result.source === "registry") bonus += 0.2;
+    else if (result.source === "github") bonus += 0.05;
+    const name = (result.skill.name ?? "").toLowerCase();
+    for (const token of tokens) {
+      if (name.includes(token)) bonus += 0.15;
+    }
+    const tags = (result.skill.tags ?? []).map((t) => t.toLowerCase());
+    for (const token of tokens) {
+      if (tags.includes(token)) bonus += 0.1;
+    }
+    return {
+      ...result,
+      confidence: Math.min(result.confidence + bonus, 1)
+    };
+  }).sort((a, b) => b.confidence - a.confidence);
+}
+
+// src/trawler/index.ts
+async function trawl(query, options = {}) {
+  const sources = options.sources ?? ["registry", "github"];
+  const maxResults = options.maxResults ?? 10;
+  const searches = [];
+  if (sources.includes("registry")) {
+    searches.push(searchRegistry(query));
+  }
+  if (sources.includes("github")) {
+    searches.push(searchGithub(query));
+  }
+  if (sources.includes("npm")) {
+    searches.push(searchNpm(query));
+  }
+  const allResults = (await Promise.all(searches)).flat();
+  const deduplicated = deduplicateResults(allResults);
+  const ranked = rankResults(deduplicated, query);
+  return ranked.slice(0, maxResults);
+}
+
+// src/cli/commands/trawl.ts
+function registerTrawlCommand(program2) {
+  program2.command("trawl <query>").description("Agentic search across multiple sources for skills").option(
+    "-s, --sources <sources...>",
+    "Sources to search (registry, github, npm)",
+    ["registry", "github"]
+  ).option("-n, --max-results <n>", "Maximum results", parseInt).action(
+    async (query, options) => {
+      const spinner = ora7("Trawling for skills...").start();
+      try {
+        const results = await trawl(query, {
+          sources: options.sources,
+          maxResults: options.maxResults
+        });
+        spinner.stop();
+        if (results.length === 0) {
+          console.log(chalk11.yellow("No skills found across any source."));
+          return;
+        }
+        console.log(chalk11.bold(`
+Trawled ${results.length} result(s):
+`));
+        for (const result of results) {
+          const confidence = Math.round(result.confidence * 100);
+          const confColor = confidence >= 70 ? chalk11.green : confidence >= 40 ? chalk11.yellow : chalk11.gray;
+          console.log(
+            `  ${chalk11.cyan.bold(result.skill.name ?? "unknown")} ${chalk11.gray(`[${result.source}]`)} ${confColor(`${confidence}% match`)}`
+          );
+          if (result.skill.description) {
+            console.log(`    ${result.skill.description}`);
+          }
+          console.log(`    ${chalk11.gray(result.url)}`);
+          console.log();
+        }
+      } catch (error) {
+        spinner.fail("Trawl failed");
+        console.error(chalk11.red(String(error)));
+        process.exit(1);
+      }
+    }
+  );
+}
+
+// src/cli/index.ts
+var program = new Command();
+program.name("skillli").description("Discover, publish, rate, and use agentic AI skills packages").version(VERSION);
+registerInitCommand(program);
+registerSearchCommand(program);
+registerInstallCommand(program);
+registerUninstallCommand(program);
+registerInfoCommand(program);
+registerListCommand(program);
+registerRateCommand(program);
+registerUpdateCommand(program);
+registerPublishCommand(program);
+registerTrawlCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map