@hasna/skills 0.1.14 → 0.1.15

package/bin/index.js

@@ -4,6 +4,7 @@ var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 function __accessProp(key) {
   return this[key];
@@ -30,6 +31,23 @@ var __toESM = (mod, isNodeMode, target) => {
     cache.set(mod, to);
   return to;
 };
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
@@ -1896,7 +1914,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.1.14",
+    version: "0.1.15",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -1981,8 +1999,91 @@ var init_package = __esm(() => {
 });
 
 // src/lib/registry.ts
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+function parseSkillMdFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match)
+    return null;
+  const result = {};
+  for (const line of match[1].split(`
+`)) {
+    const colon = line.indexOf(":");
+    if (colon === -1)
+      continue;
+    const key = line.slice(0, colon).trim();
+    const value = line.slice(colon + 1).trim();
+    if (!key || !value)
+      continue;
+    if (key === "name")
+      result.name = value;
+    else if (key === "description")
+      result.description = value;
+    else if (key === "displayName" || key === "display_name")
+      result.displayName = value;
+    else if (key === "category")
+      result.category = value;
+    else if (key === "tags") {
+      result.tags = value.replace(/[\[\]]/g, "").split(",").map((t) => t.trim()).filter(Boolean);
+    }
+  }
+  return Object.keys(result).length > 0 ? result : null;
+}
+function discoverSkillsInDir(dir) {
+  if (!existsSync(dir))
+    return [];
+  const result = [];
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory())
+        continue;
+      const skillMdPath = join(dir, entry.name, "SKILL.md");
+      if (!existsSync(skillMdPath))
+        continue;
+      let content;
+      try {
+        content = readFileSync(skillMdPath, "utf-8");
+      } catch {
+        continue;
+      }
+      const fm = parseSkillMdFrontmatter(content);
+      if (!fm?.name)
+        continue;
+      const name = fm.name.replace(/^skill-/, "");
+      result.push({
+        name,
+        displayName: fm.displayName || name.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()),
+        description: fm.description || "",
+        category: fm.category || "Development Tools",
+        tags: fm.tags || [],
+        source: "custom"
+      });
+    }
+  } catch {}
+  return result;
+}
+function loadRegistry(cwd) {
+  const now = Date.now();
+  if (_registryCache && now - _registryCacheTime < REGISTRY_CACHE_TTL) {
+    return _registryCache;
+  }
+  const official = SKILLS.map((s) => ({ ...s, source: "official" }));
+  const globalCustom = discoverSkillsInDir(join(homedir(), ".skills"));
+  const projectCustom = discoverSkillsInDir(join(cwd || process.cwd(), ".skills", "custom-skills"));
+  const customNames = new Set([...globalCustom, ...projectCustom].map((s) => s.name));
+  const filtered = official.filter((s) => !customNames.has(s.name));
+  _registryCache = [...filtered, ...globalCustom, ...projectCustom];
+  _registryCacheTime = now;
+  return _registryCache;
+}
+function clearRegistryCache() {
+  _registryCache = null;
+  _registryCacheTime = 0;
+}
 function getSkillsByCategory(category) {
-  return SKILLS.filter((s) => s.category === category);
+  return loadRegistry().filter((s) => s.category === category);
 }
 function editDistance(a, b) {
   if (a === b)
@@ -2028,7 +2129,7 @@ function searchSkills(query) {
   if (words.length === 0)
     return [];
   const scored = [];
-  for (const skill of SKILLS) {
+  for (const skill of loadRegistry()) {
     const nameLower = skill.name.toLowerCase();
     const displayNameLower = skill.displayName.toLowerCase();
     const descriptionLower = skill.description.toLowerCase();
@@ -2064,7 +2165,7 @@ function searchSkills(query) {
   return scored.map((s) => s.skill);
 }
 function getSkill(name) {
-  return SKILLS.find((s) => s.name === name);
+  return loadRegistry().find((s) => s.name === name);
 }
 function levenshtein(a, b) {
   const m = a.length, n = b.length;
@@ -2078,10 +2179,10 @@ function levenshtein(a, b) {
 }
 function findSimilarSkills(query, maxResults = 3) {
   const q = query.toLowerCase();
-  const scored = SKILLS.map((s) => ({ name: s.name, dist: levenshtein(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
+  const scored = loadRegistry().map((s) => ({ name: s.name, dist: levenshtein(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
   return scored.slice(0, maxResults).map((s) => s.name);
 }
-var CATEGORIES, SKILLS;
+var CATEGORIES, SKILLS, _registryCache = null, _registryCacheTime = 0, REGISTRY_CACHE_TTL = 5000;
 var init_registry = __esm(() => {
   CATEGORIES = [
     "Development Tools",
@@ -3119,6 +3220,20 @@ var init_registry = __esm(() => {
       category: "Design & Branding",
       tags: ["testimonials", "graphics", "social-proof", "marketing"]
     },
+    {
+      name: "colorextract",
+      displayName: "Color Extract",
+      description: "Extract complete color palettes from screenshots and images using Claude Vision. Outputs open-styles compatible profiles.",
+      category: "Design & Branding",
+      tags: ["colors", "palette", "design", "vision", "screenshot", "extract", "open-styles"]
+    },
+    {
+      name: "siteanalyze",
+      displayName: "Site Analyze",
+      description: "Analyze any website's design system \u2014 detects shadcn/ui, Tailwind, extracts colors, typography, and components via Playwright + Claude Vision.",
+      category: "Design & Branding",
+      tags: ["design", "shadcn", "tailwind", "colors", "typography", "playwright", "analysis", "open-styles"]
+    },
     {
       name: "browse",
       displayName: "Browse",
@@ -5162,39 +5277,39 @@ var require_cli_spinners = __commonJS((exports, module) => {
 });
 
 // src/lib/installer.ts
-import { existsSync, cpSync, mkdirSync, writeFileSync, rmSync, readdirSync, statSync, readFileSync, accessSync, constants } from "fs";
-import { join, dirname } from "path";
-import { homedir } from "os";
+import { existsSync as existsSync2, cpSync, mkdirSync, writeFileSync, rmSync, readdirSync as readdirSync2, statSync, readFileSync as readFileSync2, accessSync, constants } from "fs";
+import { join as join2, dirname } from "path";
+import { homedir as homedir2 } from "os";
 import { fileURLToPath } from "url";
 function findSkillsDir() {
   let dir = __dirname2;
   for (let i = 0;i < 5; i++) {
-    const candidate = join(dir, "skills");
-    if (existsSync(candidate)) {
+    const candidate = join2(dir, "skills");
+    if (existsSync2(candidate) && !dir.includes(".skills")) {
       return candidate;
     }
     dir = dirname(dir);
   }
-  return join(__dirname2, "..", "skills");
+  return join2(__dirname2, "..", "skills");
 }
 function getSkillPath(name) {
   const skillName = normalizeSkillName(name);
-  return join(SKILLS_DIR, skillName);
+  return join2(SKILLS_DIR, skillName);
 }
 function installSkill(name, options = {}) {
   const { targetDir = process.cwd(), overwrite = false } = options;
   const skillName = normalizeSkillName(name);
   const sourcePath = getSkillPath(name);
-  const destDir = join(targetDir, ".skills");
-  const destPath = join(destDir, skillName);
-  if (!existsSync(sourcePath)) {
+  const destDir = join2(targetDir, ".skills");
+  const destPath = join2(destDir, skillName);
+  if (!existsSync2(sourcePath)) {
     return {
       skill: name,
       success: false,
       error: `Skill '${name}' not found`
     };
   }
-  if (existsSync(destPath) && !overwrite) {
+  if (existsSync2(destPath) && !overwrite) {
     return {
       skill: name,
       success: false,
@@ -5203,10 +5318,10 @@ function installSkill(name, options = {}) {
     };
   }
   try {
-    if (!existsSync(destDir)) {
+    if (!existsSync2(destDir)) {
       mkdirSync(destDir, { recursive: true });
     }
-    if (existsSync(destPath) && overwrite) {
+    if (existsSync2(destPath) && overwrite) {
       rmSync(destPath, { recursive: true, force: true });
     }
     cpSync(sourcePath, destPath, {
@@ -5242,10 +5357,10 @@ function installSkill(name, options = {}) {
   }
 }
 function updateSkillsIndex(skillsDir) {
-  const indexPath = join(skillsDir, "index.ts");
+  const indexPath = join2(skillsDir, "index.ts");
   const meta = loadMeta(skillsDir);
   const disabledSet = new Set(meta.disabled || []);
-  const skills = readdirSync(skillsDir).filter((f) => f.startsWith("skill-") && !f.includes(".") && !disabledSet.has(f.replace("skill-", "")));
+  const skills = readdirSync2(skillsDir).filter((f) => f.startsWith("skill-") && !f.includes(".") && !disabledSet.has(f.replace("skill-", "")));
   const exports = skills.map((s) => {
     const name = s.replace("skill-", "").replace(/-/g, "_");
     return `export * as ${name} from './${s}/src/index.js';`;
@@ -5261,13 +5376,13 @@ ${exports}
   writeFileSync(indexPath, content);
 }
 function getMetaPath(skillsDir) {
-  return join(skillsDir, ".meta.json");
+  return join2(skillsDir, ".meta.json");
 }
 function loadMeta(skillsDir) {
   const metaPath = getMetaPath(skillsDir);
-  if (existsSync(metaPath)) {
+  if (existsSync2(metaPath)) {
     try {
-      return JSON.parse(readFileSync(metaPath, "utf-8"));
+      return JSON.parse(readFileSync2(metaPath, "utf-8"));
     } catch {}
   }
   return { skills: {} };
@@ -5280,9 +5395,9 @@ function recordInstall(skillsDir, name) {
   const skillName = normalizeSkillName(name);
   let version = "unknown";
   try {
-    const pkgPath = join(skillsDir, skillName, "package.json");
-    if (existsSync(pkgPath)) {
-      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const pkgPath = join2(skillsDir, skillName, "package.json");
+    if (existsSync2(pkgPath)) {
+      const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
       version = pkg.version || "unknown";
     }
   } catch {}
@@ -5295,23 +5410,23 @@ function recordRemove(skillsDir, name) {
   saveMeta(skillsDir, meta);
 }
 function getInstallMeta(targetDir = process.cwd()) {
-  return loadMeta(join(targetDir, ".skills"));
+  return loadMeta(join2(targetDir, ".skills"));
 }
 function getInstalledSkills(targetDir = process.cwd()) {
-  const skillsDir = join(targetDir, ".skills");
-  if (!existsSync(skillsDir)) {
+  const skillsDir = join2(targetDir, ".skills");
+  if (!existsSync2(skillsDir)) {
     return [];
   }
-  return readdirSync(skillsDir).filter((f) => {
-    const fullPath = join(skillsDir, f);
+  return readdirSync2(skillsDir).filter((f) => {
+    const fullPath = join2(skillsDir, f);
     return f.startsWith("skill-") && statSync(fullPath).isDirectory();
   }).map((f) => f.replace("skill-", ""));
 }
 function removeSkill(name, targetDir = process.cwd()) {
   const skillName = normalizeSkillName(name);
-  const skillsDir = join(targetDir, ".skills");
-  const skillPath = join(skillsDir, skillName);
-  if (!existsSync(skillPath)) {
+  const skillsDir = join2(targetDir, ".skills");
+  const skillPath = join2(skillsDir, skillName);
+  if (!existsSync2(skillPath)) {
     return false;
   }
   rmSync(skillPath, { recursive: true, force: true });
@@ -5329,27 +5444,31 @@ function resolveAgents(agentArg) {
   return [agent];
 }
 function getAgentSkillsDir(agent, scope = "global", projectDir) {
-  const agentDir = `.${agent}`;
-  if (scope === "project") {
-    return join(projectDir || process.cwd(), agentDir, "skills");
+  const base = projectDir || process.cwd();
+  switch (agent) {
+    case "pi":
+      return scope === "project" ? join2(base, ".pi", "skills") : join2(homedir2(), ".pi", "agent", "skills");
+    case "opencode":
+      return scope === "project" ? join2(base, ".opencode", "skills") : join2(homedir2(), ".opencode", "skills");
+    default:
+      return scope === "project" ? join2(base, `.${agent}`, "skills") : join2(homedir2(), `.${agent}`, "skills");
   }
-  return join(homedir(), agentDir, "skills");
 }
 function getAgentSkillPath(name, agent, scope = "global", projectDir) {
   const skillName = normalizeSkillName(name);
-  return join(getAgentSkillsDir(agent, scope, projectDir), skillName);
+  return join2(getAgentSkillsDir(agent, scope, projectDir), skillName);
 }
 function installSkillForAgent(name, options, generateSkillMd) {
   const { agent, scope = "global", projectDir } = options;
   const skillName = normalizeSkillName(name);
   const sourcePath = getSkillPath(name);
-  if (!existsSync(sourcePath)) {
+  if (!existsSync2(sourcePath)) {
     return { skill: name, success: false, error: `Skill '${name}' not found` };
   }
   let skillMdContent = null;
-  const skillMdPath = join(sourcePath, "SKILL.md");
-  if (existsSync(skillMdPath)) {
-    skillMdContent = readFileSync(skillMdPath, "utf-8");
+  const skillMdPath = join2(sourcePath, "SKILL.md");
+  if (existsSync2(skillMdPath)) {
+    skillMdContent = readFileSync2(skillMdPath, "utf-8");
   } else if (generateSkillMd) {
     skillMdContent = generateSkillMd(name);
   }
@@ -5358,17 +5477,12 @@ function installSkillForAgent(name, options, generateSkillMd) {
   }
   const destDir = getAgentSkillPath(name, agent, scope, projectDir);
   if (scope === "global") {
-    const agentBaseDir = join(homedir(), `.${agent}`);
-    if (!existsSync(agentBaseDir)) {
-      const agentLabels = {
-        claude: "Claude Code",
-        codex: "Codex CLI",
-        gemini: "Gemini CLI"
-      };
+    const agentBaseDir = agent === "pi" ? join2(homedir2(), ".pi", "agent") : join2(homedir2(), `.${agent}`);
+    if (!existsSync2(agentBaseDir)) {
       return {
         skill: name,
         success: false,
-        error: `Agent directory ${agentBaseDir} does not exist. Is ${agentLabels[agent]} installed?`
+        error: `Agent directory ${agentBaseDir} does not exist. Is ${AGENT_LABELS[agent]} installed?`
       };
     }
     try {
@@ -5383,7 +5497,7 @@ function installSkillForAgent(name, options, generateSkillMd) {
   }
   try {
     mkdirSync(destDir, { recursive: true });
-    writeFileSync(join(destDir, "SKILL.md"), skillMdContent);
+    writeFileSync(join2(destDir, "SKILL.md"), skillMdContent);
     return { skill: name, success: true, path: destDir };
   } catch (error) {
     return {
@@ -5396,31 +5510,48 @@ function installSkillForAgent(name, options, generateSkillMd) {
 function removeSkillForAgent(name, options) {
   const { agent, scope = "global", projectDir } = options;
   const destDir = getAgentSkillPath(name, agent, scope, projectDir);
-  if (!existsSync(destDir)) {
+  if (!existsSync2(destDir)) {
     return false;
   }
   rmSync(destDir, { recursive: true, force: true });
   return true;
 }
-var __dirname2, SKILLS_DIR, AGENT_TARGETS;
+var __dirname2, SKILLS_DIR, AGENT_TARGETS, AGENT_LABELS;
 var init_installer = __esm(() => {
   init_registry();
   __dirname2 = dirname(fileURLToPath(import.meta.url));
   SKILLS_DIR = findSkillsDir();
-  AGENT_TARGETS = ["claude", "codex", "gemini"];
+  AGENT_TARGETS = ["claude", "codex", "gemini", "pi", "opencode"];
+  AGENT_LABELS = {
+    claude: "Claude Code",
+    codex: "Codex CLI",
+    gemini: "Gemini CLI",
+    pi: "pi.dev",
+    opencode: "OpenCode"
+  };
 });
 
 // src/lib/skillinfo.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync as readdirSync2 } from "fs";
-import { join as join2 } from "path";
+var exports_skillinfo = {};
+__export(exports_skillinfo, {
+  runSkill: () => runSkill,
+  getSkillRequirements: () => getSkillRequirements,
+  getSkillDocs: () => getSkillDocs,
+  getSkillBestDoc: () => getSkillBestDoc,
+  generateSkillMd: () => generateSkillMd,
+  generateEnvExample: () => generateEnvExample,
+  detectProjectSkills: () => detectProjectSkills
+});
+import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync3 } from "fs";
+import { join as join3 } from "path";
 function getSkillDocs(name) {
   const skillPath = getSkillPath(name);
-  if (!existsSync2(skillPath))
+  if (!existsSync3(skillPath))
     return null;
   return {
-    skillMd: readIfExists(join2(skillPath, "SKILL.md")),
-    readme: readIfExists(join2(skillPath, "README.md")),
-    claudeMd: readIfExists(join2(skillPath, "CLAUDE.md"))
+    skillMd: readIfExists(join3(skillPath, "SKILL.md")),
+    readme: readIfExists(join3(skillPath, "README.md")),
+    claudeMd: readIfExists(join3(skillPath, "CLAUDE.md"))
   };
 }
 function getSkillBestDoc(name) {
@@ -5431,11 +5562,11 @@ function getSkillBestDoc(name) {
 }
 function getSkillRequirements(name) {
   const skillPath = getSkillPath(name);
-  if (!existsSync2(skillPath))
+  if (!existsSync3(skillPath))
     return null;
   const texts = [];
   for (const file of ["SKILL.md", "README.md", "CLAUDE.md", ".env.example", ".env.local.example"]) {
-    const content = readIfExists(join2(skillPath, file));
+    const content = readIfExists(join3(skillPath, file));
     if (content)
       texts.push(content);
   }
@@ -5462,10 +5593,10 @@ function getSkillRequirements(name) {
   }
   let cliCommand = null;
   let dependencies = {};
-  const pkgPath = join2(skillPath, "package.json");
-  if (existsSync2(pkgPath)) {
+  const pkgPath = join3(skillPath, "package.json");
+  if (existsSync3(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
       if (pkg.bin) {
         const binKeys = Object.keys(pkg.bin);
         if (binKeys.length > 0)
@@ -5485,25 +5616,25 @@ async function runSkill(name, args, options = {}) {
   const skillName = normalizeSkillName(name);
   let skillPath;
   if (options.installed) {
-    skillPath = join2(process.cwd(), ".skills", skillName);
+    skillPath = join3(process.cwd(), ".skills", skillName);
   } else {
-    const installedPath = join2(process.cwd(), ".skills", skillName);
-    if (existsSync2(installedPath)) {
+    const installedPath = join3(process.cwd(), ".skills", skillName);
+    if (existsSync3(installedPath)) {
       skillPath = installedPath;
     } else {
       skillPath = getSkillPath(name);
     }
   }
-  if (!existsSync2(skillPath)) {
+  if (!existsSync3(skillPath)) {
     return { exitCode: 1, error: `Skill '${name}' not found` };
   }
-  const pkgPath = join2(skillPath, "package.json");
-  if (!existsSync2(pkgPath)) {
+  const pkgPath = join3(skillPath, "package.json");
+  if (!existsSync3(pkgPath)) {
     return { exitCode: 1, error: `No package.json in skill '${name}'` };
   }
   let entryPoint;
   try {
-    const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
     if (pkg.bin) {
       const binValues = Object.values(pkg.bin);
       entryPoint = binValues[0];
@@ -5517,12 +5648,12 @@ async function runSkill(name, args, options = {}) {
   } catch {
     return { exitCode: 1, error: `Failed to parse package.json for skill '${name}'` };
   }
-  const entryPath = join2(skillPath, entryPoint);
-  if (!existsSync2(entryPath)) {
+  const entryPath = join3(skillPath, entryPoint);
+  if (!existsSync3(entryPath)) {
     return { exitCode: 1, error: `Entry point '${entryPoint}' not found in skill '${name}'` };
   }
-  const nodeModules = join2(skillPath, "node_modules");
-  if (!existsSync2(nodeModules)) {
+  const nodeModules = join3(skillPath, "node_modules");
+  if (!existsSync3(nodeModules)) {
     const install = Bun.spawn(["bun", "install", "--no-save"], {
       cwd: skillPath,
       stdout: "pipe",
@@ -5540,18 +5671,18 @@ async function runSkill(name, args, options = {}) {
   return { exitCode };
 }
 function detectProjectSkills(cwd = process.cwd()) {
-  const pkgPath = join2(cwd, "package.json");
-  if (!existsSync2(pkgPath)) {
+  const pkgPath = join3(cwd, "package.json");
+  if (!existsSync3(pkgPath)) {
     const alwaysRecommend = ["implementation-plan", "write", "deepresearch"];
-    const recommended2 = alwaysRecommend.map((name) => SKILLS.find((s) => s.name === name)).filter((s) => s !== undefined);
+    const recommended2 = alwaysRecommend.map((name) => loadRegistry().find((s) => s.name === name)).filter((s) => s !== undefined);
     return { detected: [], recommended: recommended2 };
   }
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+    pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
   } catch {
     const alwaysRecommend = ["implementation-plan", "write", "deepresearch"];
-    const recommended2 = alwaysRecommend.map((name) => SKILLS.find((s) => s.name === name)).filter((s) => s !== undefined);
+    const recommended2 = alwaysRecommend.map((name) => loadRegistry().find((s) => s.name === name)).filter((s) => s !== undefined);
     return { detected: [], recommended: recommended2 };
   }
   const allDeps = {
@@ -5623,15 +5754,66 @@ function detectProjectSkills(cwd = process.cwd()) {
     }
   }
   const uniqueDetected = Array.from(new Set(detected));
-  const recommended = Array.from(recommendedNames).map((name) => SKILLS.find((s) => s.name === name)).filter((s) => s !== undefined);
+  const recommended = Array.from(recommendedNames).map((name) => loadRegistry().find((s) => s.name === name)).filter((s) => s !== undefined);
   return { detected: uniqueDetected, recommended };
 }
+function generateEnvExample(targetDir = process.cwd()) {
+  const skillsDir = join3(targetDir, ".skills");
+  if (!existsSync3(skillsDir))
+    return "";
+  const dirs = readdirSync3(skillsDir).filter((f) => f.startsWith("skill-") && existsSync3(join3(skillsDir, f, "package.json")));
+  const envMap = new Map;
+  for (const dir of dirs) {
+    const skillName = dir.replace("skill-", "");
+    const skillPath = join3(skillsDir, dir);
+    const texts = [];
+    for (const file of ["SKILL.md", "README.md", "CLAUDE.md", ".env.example"]) {
+      const content = readIfExists(join3(skillPath, file));
+      if (content)
+        texts.push(content);
+    }
+    const allText = texts.join(`
+`);
+    const foundVars = extractEnvVars(allText);
+    for (const envVar of foundVars) {
+      if (!envMap.has(envVar)) {
+        envMap.set(envVar, []);
+      }
+      if (!envMap.get(envVar).includes(skillName)) {
+        envMap.get(envVar).push(skillName);
+      }
+    }
+  }
+  if (envMap.size === 0)
+    return "";
+  const lines = [
+    "# Environment variables for installed skills",
+    "# Auto-generated by: skills init",
+    ""
+  ];
+  const sorted = Array.from(envMap.entries()).sort(([a], [b]) => a.localeCompare(b));
+  let lastPrefix = "";
+  for (const [envVar, skills] of sorted) {
+    const prefix = envVar.split("_")[0];
+    if (prefix !== lastPrefix) {
+      if (lastPrefix)
+        lines.push("");
+      lines.push(`# ${prefix}`);
+      lastPrefix = prefix;
+    }
+    lines.push(`# Used by: ${skills.join(", ")}`);
+    lines.push(`${envVar}=`);
+  }
+  return lines.join(`
+`) + `
+`;
+}
 function generateSkillMd(name) {
   const meta = getSkill(name);
   if (!meta)
     return null;
   const skillPath = getSkillPath(name);
-  if (!existsSync2(skillPath))
+  if (!existsSync3(skillPath))
     return null;
   const frontmatter = [
     "---",
@@ -5640,13 +5822,13 @@ function generateSkillMd(name) {
     "---"
   ].join(`
 `);
-  const readme = readIfExists(join2(skillPath, "README.md"));
-  const claudeMd = readIfExists(join2(skillPath, "CLAUDE.md"));
+  const readme = readIfExists(join3(skillPath, "README.md"));
+  const claudeMd = readIfExists(join3(skillPath, "CLAUDE.md"));
   let cliCommand = null;
-  const pkgPath = join2(skillPath, "package.json");
-  if (existsSync2(pkgPath)) {
+  const pkgPath = join3(skillPath, "package.json");
+  if (existsSync3(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
       if (pkg.bin) {
         const binKeys = Object.keys(pkg.bin);
         if (binKeys.length > 0)
@@ -5719,8 +5901,8 @@ function extractEnvVars(text) {
 }
 function readIfExists(path) {
   try {
-    if (existsSync2(path)) {
-      return readFileSync2(path, "utf-8");
+    if (existsSync3(path)) {
+      return readFileSync3(path, "utf-8");
     }
   } catch {}
   return null;
@@ -5733,6 +5915,173 @@ var init_skillinfo = __esm(() => {
   GENERIC_ENV_PATTERN = /\b((?:OPENAI|ANTHROPIC|GEMINI|XAI|ELEVENLABS|DEEPGRAM|REPLICATE|FAL|STABILITY|EXA|FIRECRAWL|TWILIO|SENDGRID|RESEND|SLACK|DISCORD|NOTION|LINEAR|GITHUB|AWS|GOOGLE|CLOUDFLARE|VERCEL|SUPABASE|STRIPE)_[A-Z_]+)\b/g;
 });
 
+// src/lib/scheduler.ts
+var exports_scheduler = {};
+__export(exports_scheduler, {
+  validateCron: () => validateCron,
+  setScheduleEnabled: () => setScheduleEnabled,
+  removeSchedule: () => removeSchedule,
+  recordScheduleRun: () => recordScheduleRun,
+  listSchedules: () => listSchedules,
+  getNextRun: () => getNextRun,
+  getDueSchedules: () => getDueSchedules,
+  addSchedule: () => addSchedule
+});
+import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
+import { join as join5 } from "path";
+function getSchedulesPath(targetDir = process.cwd()) {
+  return join5(targetDir, ".skills", "schedules.json");
+}
+function loadSchedules(targetDir = process.cwd()) {
+  const path = getSchedulesPath(targetDir);
+  if (existsSync5(path)) {
+    try {
+      return JSON.parse(readFileSync5(path, "utf-8"));
+    } catch {}
+  }
+  return { version: 1, schedules: [] };
+}
+function saveSchedules(data, targetDir = process.cwd()) {
+  const path = getSchedulesPath(targetDir);
+  const dir = join5(targetDir, ".skills");
+  if (!existsSync5(dir))
+    mkdirSync3(dir, { recursive: true });
+  writeFileSync3(path, JSON.stringify(data, null, 2));
+}
+function validateCron(expr) {
+  const fields = expr.trim().split(/\s+/);
+  if (fields.length !== 5) {
+    return { valid: false, error: `Expected 5 fields, got ${fields.length}. Format: "minute hour day-of-month month day-of-week"` };
+  }
+  return { valid: true };
+}
+function getNextRun(cron, from = new Date) {
+  const { valid } = validateCron(cron);
+  if (!valid)
+    return null;
+  const [minuteF, hourF, domF, monthF, dowF] = cron.trim().split(/\s+/);
+  function parseField(f, min, max) {
+    if (f === "*")
+      return Array.from({ length: max - min + 1 }, (_, i) => i + min);
+    if (f.startsWith("*/")) {
+      const step = parseInt(f.slice(2));
+      if (isNaN(step))
+        return [];
+      const vals = [];
+      for (let i = min;i <= max; i += step)
+        vals.push(i);
+      return vals;
+    }
+    return f.split(",").flatMap((part) => {
+      if (part.includes("-")) {
+        const [lo, hi] = part.split("-").map(Number);
+        return Array.from({ length: hi - lo + 1 }, (_, i) => i + lo);
+      }
+      const n = parseInt(part);
+      return isNaN(n) ? [] : [n];
+    });
+  }
+  const minutes = parseField(minuteF, 0, 59);
+  const hours = parseField(hourF, 0, 23);
+  const doms = parseField(domF, 1, 31);
+  const months = parseField(monthF, 1, 12);
+  const dows = parseField(dowF, 0, 6);
+  const candidate = new Date(from);
+  candidate.setSeconds(0, 0);
+  candidate.setMinutes(candidate.getMinutes() + 1);
+  const limit = new Date(from);
+  limit.setFullYear(limit.getFullYear() + 1);
+  while (candidate < limit) {
+    const month = candidate.getMonth() + 1;
+    const dom = candidate.getDate();
+    const dow = candidate.getDay();
+    const hour = candidate.getHours();
+    const minute = candidate.getMinutes();
+    if (!months.includes(month)) {
+      candidate.setMonth(candidate.getMonth() + 1, 1);
+      candidate.setHours(0, 0, 0, 0);
+      continue;
+    }
+    if (!doms.includes(dom) || !dows.includes(dow)) {
+      candidate.setDate(candidate.getDate() + 1);
+      candidate.setHours(0, 0, 0, 0);
+      continue;
+    }
+    if (!hours.includes(hour)) {
+      candidate.setHours(candidate.getHours() + 1, 0, 0, 0);
+      continue;
+    }
+    if (!minutes.includes(minute)) {
+      candidate.setMinutes(candidate.getMinutes() + 1, 0, 0);
+      continue;
+    }
+    return new Date(candidate);
+  }
+  return null;
+}
+function addSchedule(skill, cron, options = {}) {
+  const { valid, error } = validateCron(cron);
+  if (!valid)
+    return { schedule: null, error };
+  const data = loadSchedules(options.targetDir);
+  const id = `${skill}-${Date.now()}`;
+  const now = new Date;
+  const nextRun = getNextRun(cron, now);
+  const schedule = {
+    id,
+    name: options.name || `${skill} (${cron})`,
+    skill,
+    cron,
+    args: options.args,
+    enabled: true,
+    createdAt: now.toISOString(),
+    nextRun: nextRun?.toISOString()
+  };
+  data.schedules.push(schedule);
+  saveSchedules(data, options.targetDir);
+  return { schedule };
+}
+function listSchedules(targetDir) {
+  return loadSchedules(targetDir).schedules;
+}
+function removeSchedule(idOrName, targetDir) {
+  const data = loadSchedules(targetDir);
+  const before = data.schedules.length;
+  data.schedules = data.schedules.filter((s) => s.id !== idOrName && s.name !== idOrName);
+  if (data.schedules.length === before)
+    return false;
+  saveSchedules(data, targetDir);
+  return true;
+}
+function setScheduleEnabled(idOrName, enabled, targetDir) {
+  const data = loadSchedules(targetDir);
+  const schedule = data.schedules.find((s) => s.id === idOrName || s.name === idOrName);
+  if (!schedule)
+    return false;
+  schedule.enabled = enabled;
+  if (enabled) {
+    schedule.nextRun = getNextRun(schedule.cron)?.toISOString();
+  }
+  saveSchedules(data, targetDir);
+  return true;
+}
+function getDueSchedules(targetDir) {
+  const now = new Date;
+  return listSchedules(targetDir).filter((s) => s.enabled && s.nextRun && new Date(s.nextRun) <= now);
+}
+function recordScheduleRun(id, status, targetDir) {
+  const data = loadSchedules(targetDir);
+  const schedule = data.schedules.find((s) => s.id === id);
+  if (!schedule)
+    return;
+  const now = new Date;
+  schedule.lastRun = now.toISOString();
+  schedule.lastRunStatus = status;
+  schedule.nextRun = getNextRun(schedule.cron, now)?.toISOString();
+  saveSchedules(data, targetDir);
+}
+var init_scheduler = () => {};
+
 // ../../../../hasnastudio/hasnastudio-alumia/platform/platformdev/platform-alumia/node_modules/.pnpm/zod@4.3.6/node_modules/zod/v3/helpers/util.js
 var util, objectUtil, ZodParsedType, getParsedType = (data) => {
   const t = typeof data;
@@ -34823,9 +35172,8 @@ var init_stdio2 = __esm(() => {
 
 // src/mcp/index.ts
 var exports_mcp = {};
-import { existsSync as existsSync4, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
-import { join as join4 } from "path";
-import { homedir as homedir3 } from "os";
+import { existsSync as existsSync6, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
+import { join as join6 } from "path";
 function stripNulls(obj) {
   return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== null && v !== undefined && !(Array.isArray(v) && v.length === 0)));
 }
@@ -34865,6 +35213,7 @@ var init_mcp2 = __esm(() => {
   init_registry();
   init_installer();
   init_skillinfo();
+  init_scheduler();
   server = new McpServer({
     name: "skills",
     version: package_default.version
@@ -34880,7 +35229,7 @@ var init_mcp2 = __esm(() => {
       offset: exports_external.number().optional()
     }
   }, async ({ category, detail, limit, offset }) => {
-    const skills = category ? getSkillsByCategory(category) : SKILLS;
+    const skills = category ? getSkillsByCategory(category) : loadRegistry();
     const mapped = detail ? skills : skills.map((s) => ({ name: s.name, category: s.category }));
     if (limit !== undefined || offset !== undefined) {
       const start = offset || 0;
@@ -34965,7 +35314,7 @@ var init_mcp2 = __esm(() => {
   });
   server.registerTool("install_skill", {
     title: "Install Skill",
-    description: "Install a skill to .skills/ or to an agent dir (for: claude|codex|gemini|all).",
+    description: "Install a skill to .skills/ or to an agent dir (for: claude|codex|gemini|pi|opencode|all).",
     inputSchema: {
       name: exports_external.string(),
       for: exports_external.string().optional(),
@@ -34977,7 +35326,7 @@ var init_mcp2 = __esm(() => {
       try {
         agents = resolveAgents(agentArg);
       } catch (err) {
-        return mcpError("INVALID_AGENT", err.message, ["claude", "codex", "gemini", "all"]);
+        return mcpError("INVALID_AGENT", err.message, [...AGENT_TARGETS, "all"]);
       }
       const results = agents.map((a) => installSkillForAgent(name, { agent: a, scope: scope || "global" }, generateSkillMd));
       return {
@@ -35015,7 +35364,7 @@ var init_mcp2 = __esm(() => {
       try {
         agents = resolveAgents(agentArg);
       } catch (err) {
-        return mcpError("INVALID_AGENT", err.message, ["claude", "codex", "gemini", "all"]);
+        return mcpError("INVALID_AGENT", err.message, [...AGENT_TARGETS, "all"]);
       }
       const results2 = [];
       for (const name of names) {
@@ -35049,7 +35398,7 @@ var init_mcp2 = __esm(() => {
       try {
         agents = resolveAgents(agentArg);
       } catch (err) {
-        return mcpError("INVALID_AGENT", err.message, ["claude", "codex", "gemini", "all"]);
+        return mcpError("INVALID_AGENT", err.message, [...AGENT_TARGETS, "all"]);
       }
       const results = agents.map((a) => ({
         skill: name,
@@ -35082,7 +35431,7 @@ var init_mcp2 = __esm(() => {
     description: "List all unique skill tags with occurrence counts."
   }, async () => {
     const tagCounts = new Map;
-    for (const skill of SKILLS) {
+    for (const skill of loadRegistry()) {
       for (const tag of skill.tags) {
         tagCounts.set(tag, (tagCounts.get(tag) ?? 0) + 1);
       }
@@ -35156,7 +35505,7 @@ var init_mcp2 = __esm(() => {
       try {
         agents = resolveAgents(agentArg);
       } catch (err) {
-        return mcpError("INVALID_AGENT", err.message, ["claude", "codex", "gemini", "all"]);
+        return mcpError("INVALID_AGENT", err.message, [...AGENT_TARGETS, "all"]);
       }
       for (const name of skillList) {
         const agentResults = agents.map((a) => installSkillForAgent(name, { agent: a, scope: scope || "global" }, generateSkillMd));
@@ -35184,21 +35533,20 @@ var init_mcp2 = __esm(() => {
     const version2 = package_default.version;
     const cwd = process.cwd();
     const installed = getInstalledSkills();
-    const agentNames = ["claude", "codex", "gemini"];
     const agents = [];
-    for (const agent of agentNames) {
-      const agentSkillsPath = join4(homedir3(), `.${agent}`, "skills");
-      const exists = existsSync4(agentSkillsPath);
+    for (const agent of AGENT_TARGETS) {
+      const agentSkillsPath = getAgentSkillsDir(agent, "global");
+      const exists = existsSync6(agentSkillsPath);
       let skillCount = 0;
       if (exists) {
         try {
-          skillCount = readdirSync3(agentSkillsPath).filter((f) => {
-            const full = join4(agentSkillsPath, f);
+          skillCount = readdirSync4(agentSkillsPath).filter((f) => {
+            const full = join6(agentSkillsPath, f);
             return f.startsWith("skill-") && statSync2(full).isDirectory();
           }).length;
         } catch {}
       }
-      agents.push({ agent, path: agentSkillsPath, exists, skillCount });
+      agents.push({ agent, label: AGENT_LABELS[agent], path: agentSkillsPath, exists, skillCount });
     }
     const skillsDir = getSkillPath("image").replace(/[/\\][^/\\]*$/, "");
     const result = {
@@ -35211,12 +35559,107 @@ var init_mcp2 = __esm(() => {
     };
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
   });
+  server.registerTool("schedule_skill", {
+    title: "Schedule Skill",
+    description: "Add a cron schedule to run a skill at a recurring time. Cron format: 'minute hour dom month dow' (e.g. '0 9 * * *' = daily at 9am).",
+    inputSchema: {
+      skill: exports_external.string(),
+      cron: exports_external.string(),
+      name: exports_external.string().optional(),
+      args: exports_external.array(exports_external.string()).optional()
+    }
+  }, async ({ skill, cron, name, args }) => {
+    const { schedule, error: error48 } = addSchedule(skill, cron, { name, args });
+    if (error48 || !schedule) {
+      return { content: [{ type: "text", text: JSON.stringify({ error: error48 || "Failed to add schedule" }) }] };
+    }
+    return { content: [{ type: "text", text: JSON.stringify(schedule, null, 2) }] };
+  });
+  server.registerTool("list_schedules", {
+    title: "List Schedules",
+    description: "List all scheduled skill runs.",
+    inputSchema: {}
+  }, async () => {
+    const schedules = listSchedules();
+    return { content: [{ type: "text", text: JSON.stringify(schedules, null, 2) }] };
+  });
+  server.registerTool("remove_schedule", {
+    title: "Remove Schedule",
+    description: "Remove a schedule by its ID or name.",
+    inputSchema: {
+      id_or_name: exports_external.string()
+    }
+  }, async ({ id_or_name }) => {
+    const removed = removeSchedule(id_or_name);
+    return { content: [{ type: "text", text: JSON.stringify({ removed, id_or_name }) }] };
+  });
+  server.registerTool("detect_project_skills", {
+    title: "Detect Project Skills",
+    description: "Detect project type from package.json and return recommended skills based on dependencies.",
+    inputSchema: {
+      directory: exports_external.string().optional()
+    }
+  }, async ({ directory }) => {
+    const cwd = directory || process.cwd();
+    const { detected, recommended } = detectProjectSkills(cwd);
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          directory: cwd,
+          detected,
+          recommended: recommended.map((s) => ({ name: s.name, displayName: s.displayName, description: s.description, category: s.category }))
+        }, null, 2)
+      }]
+    };
+  });
+  server.registerTool("validate_skill", {
+    title: "Validate Skill",
+    description: "Check a skill's structure: SKILL.md, package.json with bin entry, tsconfig.json, src/index.ts. Returns validation result with list of issues.",
+    inputSchema: {
+      name: exports_external.string()
+    }
+  }, async ({ name }) => {
+    const skillPath = getSkillPath(name);
+    const issues = [];
+    if (!existsSync6(skillPath)) {
+      return {
+        content: [{ type: "text", text: JSON.stringify({ name, valid: false, issues: [`Skill directory not found: ${skillPath}`] }) }]
+      };
+    }
+    if (!existsSync6(join6(skillPath, "SKILL.md")))
+      issues.push("Missing SKILL.md");
+    if (!existsSync6(join6(skillPath, "tsconfig.json")))
+      issues.push("Missing tsconfig.json");
+    const pkgPath = join6(skillPath, "package.json");
+    if (!existsSync6(pkgPath)) {
+      issues.push("Missing package.json");
+    } else {
+      try {
+        const pkg = JSON.parse(__require("fs").readFileSync(pkgPath, "utf-8"));
+        if (!pkg.bin || Object.keys(pkg.bin).length === 0)
+          issues.push("package.json missing 'bin' entry");
+      } catch {
+        issues.push("package.json is invalid JSON");
+      }
+    }
+    const srcDir = join6(skillPath, "src");
+    if (!existsSync6(srcDir)) {
+      issues.push("Missing src/ directory");
+    } else if (!existsSync6(join6(srcDir, "index.ts"))) {
+      issues.push("Missing src/index.ts");
+    }
+    const valid = issues.length === 0;
+    return {
+      content: [{ type: "text", text: JSON.stringify({ name, valid, path: skillPath, issues }) }]
+    };
+  });
   server.registerResource("Skills Registry", "skills://registry", {
     description: "Compact skill list [{name,category}]. Use skills://{name} for detail."
   }, async () => ({
     contents: [{
       uri: "skills://registry",
-      text: JSON.stringify(SKILLS.map((s) => ({ name: s.name, category: s.category }))),
+      text: JSON.stringify(loadRegistry().map((s) => ({ name: s.name, category: s.category }))),
       mimeType: "application/json"
     }]
   }));
@@ -35325,16 +35768,16 @@ __export(exports_serve, {
   startServer: () => startServer,
   createFetchHandler: () => createFetchHandler
 });
-import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
-import { join as join5, dirname as dirname3, extname } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync6 } from "fs";
+import { join as join7, dirname as dirname3, extname } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function getPackageJson() {
   try {
     const scriptDir = dirname3(fileURLToPath2(import.meta.url));
     for (const rel of ["../..", ".."]) {
-      const pkgPath = join5(scriptDir, rel, "package.json");
-      if (existsSync5(pkgPath)) {
-        const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
+      const pkgPath = join7(scriptDir, rel, "package.json");
+      if (existsSync7(pkgPath)) {
+        const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
         return { version: pkg.version || "unknown", name: pkg.name || "skills" };
       }
     }
@@ -35345,20 +35788,20 @@ function resolveDashboardDir() {
   const candidates = [];
   try {
     const scriptDir = dirname3(fileURLToPath2(import.meta.url));
-    candidates.push(join5(scriptDir, "..", "dashboard", "dist"));
-    candidates.push(join5(scriptDir, "..", "..", "dashboard", "dist"));
+    candidates.push(join7(scriptDir, "..", "dashboard", "dist"));
+    candidates.push(join7(scriptDir, "..", "..", "dashboard", "dist"));
   } catch {}
   if (process.argv[1]) {
     const mainDir = dirname3(process.argv[1]);
-    candidates.push(join5(mainDir, "..", "dashboard", "dist"));
-    candidates.push(join5(mainDir, "..", "..", "dashboard", "dist"));
+    candidates.push(join7(mainDir, "..", "dashboard", "dist"));
+    candidates.push(join7(mainDir, "..", "..", "dashboard", "dist"));
   }
-  candidates.push(join5(process.cwd(), "dashboard", "dist"));
+  candidates.push(join7(process.cwd(), "dashboard", "dist"));
   for (const candidate of candidates) {
-    if (existsSync5(candidate))
+    if (existsSync7(candidate))
       return candidate;
   }
-  return join5(process.cwd(), "dashboard", "dist");
+  return join7(process.cwd(), "dashboard", "dist");
 }
 function json2(data, status = 200) {
   return new Response(JSON.stringify(data), {
@@ -35387,7 +35830,7 @@ function parseFields(searchParams) {
 }
 function getAllSkillsWithStatus() {
   const installed = new Set(getInstalledSkills());
-  return SKILLS.map((meta3) => {
+  return loadRegistry().map((meta3) => {
     const reqs = getSkillRequirements(meta3.name);
     const envVars = reqs?.envVars || [];
     return {
@@ -35400,12 +35843,13 @@ function getAllSkillsWithStatus() {
       envVars,
       envVarsSet: envVars.filter((v) => !!process.env[v]),
       systemDeps: reqs?.systemDeps || [],
-      cliCommand: reqs?.cliCommand || null
+      cliCommand: reqs?.cliCommand || null,
+      source: meta3.source ?? "official"
     };
   });
 }
 function serveStaticFile(filePath) {
-  if (!existsSync5(filePath))
+  if (!existsSync7(filePath))
     return null;
   const ext = extname(filePath);
   const contentType = MIME_TYPES[ext] || "application/octet-stream";
@@ -35415,7 +35859,7 @@ function serveStaticFile(filePath) {
 }
 function createFetchHandler(options) {
   const dashboardDir = options?.dashboardDir ?? resolveDashboardDir();
-  const dashboardExists = options?.dashboardExists ?? existsSync5(dashboardDir);
+  const dashboardExists = options?.dashboardExists ?? existsSync7(dashboardDir);
   return async function fetchHandler(req) {
     const url2 = new URL(req.url);
     const path = url2.pathname.replace(/^\/api\/v1\//, "/api/");
@@ -35426,7 +35870,7 @@ function createFetchHandler(options) {
         status: "ok",
         version: pkg.version,
         uptime: Math.floor(process.uptime()),
-        skillCount: SKILLS.length
+        skillCount: loadRegistry().length
       });
     }
     if (path === "/api/skills" && method === "GET") {
@@ -35467,7 +35911,7 @@ function createFetchHandler(options) {
     }
     if (path === "/api/tags" && method === "GET") {
       const tagCounts = new Map;
-      for (const skill of SKILLS) {
+      for (const skill of loadRegistry()) {
         for (const tag of skill.tags) {
           tagCounts.set(tag, (tagCounts.get(tag) ?? 0) + 1);
         }
@@ -35699,12 +36143,12 @@ function createFetchHandler(options) {
     }
     if (dashboardExists && (method === "GET" || method === "HEAD")) {
       if (path !== "/") {
-        const filePath = join5(dashboardDir, path);
+        const filePath = join7(dashboardDir, path);
         const res2 = serveStaticFile(filePath);
         if (res2)
           return res2;
       }
-      const indexPath = join5(dashboardDir, "index.html");
+      const indexPath = join7(dashboardDir, "index.html");
       const res = serveStaticFile(indexPath);
       if (res)
         return res;
@@ -35715,7 +36159,7 @@ function createFetchHandler(options) {
 async function startServer(port = 0, options) {
   const shouldOpen = options?.open ?? true;
   const dashboardDir = resolveDashboardDir();
-  const dashboardExists = existsSync5(dashboardDir);
+  const dashboardExists = existsSync7(dashboardDir);
   if (!dashboardExists) {
     console.error(`
 Dashboard not found at: ${dashboardDir}`);
@@ -35795,8 +36239,8 @@ var {
 // src/cli/index.tsx
 init_package();
 import chalk2 from "chalk";
-import { existsSync as existsSync6, writeFileSync as writeFileSync3, appendFileSync, readFileSync as readFileSync5, readdirSync as readdirSync4, statSync as statSync3 } from "fs";
-import { join as join6 } from "path";
+import { existsSync as existsSync8, writeFileSync as writeFileSync4, appendFileSync, readFileSync as readFileSync7, readdirSync as readdirSync5, statSync as statSync3, mkdirSync as mkdirSync4 } from "fs";
+import { join as join8 } from "path";
 
 // src/cli/components/App.tsx
 import { useState as useState7 } from "react";
@@ -36922,9 +37366,9 @@ init_installer();
 init_skillinfo();
 
 // src/lib/config.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
-import { join as join3, dirname as dirname2 } from "path";
-import { homedir as homedir2 } from "os";
+import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { join as join4, dirname as dirname2 } from "path";
+import { homedir as homedir3 } from "os";
 var VALID_KEYS = {
   defaultAgent: ["claude", "codex", "gemini", "all"],
   defaultScope: ["global", "project"],
@@ -36932,15 +37376,15 @@ var VALID_KEYS = {
 };
 function getConfigPath(scope) {
   if (scope === "global") {
-    return join3(homedir2(), ".skillsrc");
+    return join4(homedir3(), ".skillsrc");
   }
-  return join3(process.cwd(), "skills.config.json");
+  return join4(process.cwd(), "skills.config.json");
 }
 function readConfigFile(path) {
-  if (!existsSync3(path))
+  if (!existsSync4(path))
     return {};
   try {
-    const raw = readFileSync3(path, "utf-8");
+    const raw = readFileSync4(path, "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
       return {};
@@ -36971,9 +37415,9 @@ function saveConfig(key, value, scope = "project") {
   }
   const filePath = getConfigPath(scope);
   let existing = {};
-  if (existsSync3(filePath)) {
+  if (existsSync4(filePath)) {
     try {
-      existing = JSON.parse(readFileSync3(filePath, "utf-8"));
+      existing = JSON.parse(readFileSync4(filePath, "utf-8"));
       if (typeof existing !== "object" || existing === null || Array.isArray(existing)) {
         existing = {};
       }
@@ -36982,7 +37426,7 @@ function saveConfig(key, value, scope = "project") {
     }
   } else {
     const dir = dirname2(filePath);
-    if (!existsSync3(dir)) {
+    if (!existsSync4(dir)) {
       mkdirSync2(dir, { recursive: true });
     }
   }
@@ -36992,6 +37436,7 @@ function saveConfig(key, value, scope = "project") {
 }
 
 // src/cli/index.tsx
+init_scheduler();
 import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
 var isTTY = (process.stdout.isTTY ?? false) && (process.stdin.isTTY ?? false);
 if (process.argv.includes("--no-color")) {
@@ -37024,7 +37469,7 @@ program2.command("interactive", { isDefault: true }).alias("i").description("Int
   }
   render(/* @__PURE__ */ jsxDEV7(App, {}, undefined, false, undefined, this));
 });
-program2.command("install").alias("add").argument("[skills...]", "Skills to install").option("--verbose", "Enable verbose debug logging", false).option("-o, --overwrite", "Overwrite existing skills", false).option("--json", "Output results as JSON", false).option("--for <agent>", "Install for agent: claude, codex, gemini, or all").option("--scope <scope>", "Install scope: global or project", "global").option("--dry-run", "Print what would happen without actually installing", false).option("--category <category>", "Install all skills in a category (case-insensitive)").description("Install one or more skills").action((skills, options) => {
+program2.command("install").alias("add").argument("[skills...]", "Skills to install").option("--verbose", "Enable verbose debug logging", false).option("-o, --overwrite", "Overwrite existing skills", false).option("--json", "Output results as JSON", false).option("--for <agent>", "Install for agent: claude, codex, gemini, pi, opencode, or all").option("--scope <scope>", "Install scope: global or project", "global").option("--dry-run", "Print what would happen without actually installing", false).option("--category <category>", "Install all skills in a category (case-insensitive)").description("Install one or more skills").action((skills, options) => {
   const config2 = loadConfig();
   if (!options.for && config2.defaultAgent) {
     options.for = config2.defaultAgent;
@@ -37165,7 +37610,14 @@ program2.command("list").alias("ls").option("-c, --category <category>", "Filter
   if (options.installed) {
     const installed = getInstalledSkills();
     if (options.json) {
-      console.log(JSON.stringify(installed));
+      const meta4 = getInstallMeta();
+      const registry3 = loadRegistry();
+      const output = installed.map((name) => {
+        const m = meta4.skills[name];
+        const s = registry3.find((r) => r.name === name);
+        return { name, version: m?.version ?? null, installedAt: m?.installedAt ?? null, source: s?.source ?? "official" };
+      });
+      console.log(JSON.stringify(output));
       return;
     }
     if (installed.length === 0) {
@@ -37173,16 +37625,22 @@ program2.command("list").alias("ls").option("-c, --category <category>", "Filter
       return;
     }
     if (brief) {
-      for (const name of installed) {
+      for (const name of installed)
         console.log(name);
-      }
       return;
     }
+    const meta3 = getInstallMeta();
+    const registry2 = loadRegistry();
     console.log(chalk2.bold(`
 Installed skills (${installed.length}):
 `));
     for (const name of installed) {
-      console.log(`  ${name}`);
+      const m = meta3.skills[name];
+      const s = registry2.find((r) => r.name === name);
+      const version2 = m?.version ? chalk2.dim(`v${m.version}`) : "";
+      const installedAt = m?.installedAt ? chalk2.dim(new Date(m.installedAt).toLocaleDateString()) : "";
+      const source = s?.source === "custom" ? chalk2.yellow(" [custom]") : "";
+      console.log(`  ${chalk2.cyan(name)}${source}  ${version2}  ${installedAt}`);
     }
     return;
   }
@@ -37218,7 +37676,7 @@ ${category} (${skills.length}):
     return;
   }
   if (tagFilter) {
-    const skills = SKILLS.filter((s) => s.tags.some((tag) => tagFilter.includes(tag.toLowerCase())));
+    const skills = loadRegistry().filter((s) => s.tags.some((tag) => tagFilter.includes(tag.toLowerCase())));
     if (options.json) {
       console.log(JSON.stringify(skills, null, 2));
       return;
@@ -37233,29 +37691,31 @@ ${category} (${skills.length}):
 Skills matching tags [${tagFilter.join(", ")}] (${skills.length}):
 `));
     for (const s of skills) {
-      console.log(`  ${chalk2.cyan(s.name)} ${chalk2.dim(`[${s.category}]`)} - ${s.description}`);
+      const customBadge = s.source === "custom" ? chalk2.yellow(" [custom]") : "";
+      console.log(`  ${chalk2.cyan(s.name)}${customBadge} ${chalk2.dim(`[${s.category}]`)} - ${s.description}`);
     }
     return;
   }
+  const allSkills = loadRegistry();
   if (options.json) {
-    console.log(JSON.stringify(SKILLS, null, 2));
+    console.log(JSON.stringify(allSkills, null, 2));
     return;
   }
   if (fmt === "compact") {
-    for (const s of SKILLS)
+    for (const s of allSkills)
       console.log(s.name);
     return;
   }
   if (fmt === "csv") {
-    console.log("name,category,description");
-    for (const s of SKILLS) {
+    console.log("name,category,description,source");
+    for (const s of allSkills) {
       const desc = s.description.replace(/"/g, '""');
-      console.log(`${s.name},${s.category},"${desc}"`);
+      console.log(`${s.name},${s.category},"${desc}",${s.source ?? "official"}`);
     }
     return;
   }
   if (brief) {
-    const sorted = [...SKILLS].sort((a, b) => {
+    const sorted = [...allSkills].sort((a, b) => {
       const catCmp = a.category.localeCompare(b.category);
       return catCmp !== 0 ? catCmp : a.name.localeCompare(b.name);
     });
@@ -37265,16 +37725,26 @@ Skills matching tags [${tagFilter.join(", ")}] (${skills.length}):
     return;
   }
   console.log(chalk2.bold(`
-Available skills (${SKILLS.length}):
+Available skills (${allSkills.length}):
 `));
   for (const category of CATEGORIES) {
     const skills = getSkillsByCategory(category);
+    if (skills.length === 0)
+      continue;
     console.log(chalk2.bold(`${category} (${skills.length}):`));
     for (const s of skills) {
-      console.log(`  ${chalk2.cyan(s.name)} - ${s.description}`);
+      const customBadge = s.source === "custom" ? chalk2.yellow(" [custom]") : "";
+      console.log(`  ${chalk2.cyan(s.name)}${customBadge} - ${s.description}`);
     }
     console.log();
   }
+  const customUncategorized = allSkills.filter((s) => s.source === "custom" && !CATEGORIES.includes(s.category));
+  if (customUncategorized.length > 0) {
+    console.log(chalk2.bold(`Custom (${customUncategorized.length}):`));
+    for (const s of customUncategorized) {
+      console.log(`  ${chalk2.yellow(s.name)} - ${s.description}`);
+    }
+  }
 });
 program2.command("search").alias("s").argument("<query>", "Search term").option("--verbose", "Enable verbose debug logging", false).option("--json", "Output as JSON", false).option("--brief", "One line per skill: name \u2014 description [category]", false).option("--format <format>", "Output format: compact (names only) or csv (name,category,description)").option("-c, --category <category>", "Filter results by category").option("-t, --tags <tags>", "Filter results by comma-separated tags (OR logic, case-insensitive)").description("Search for skills").action((query, options) => {
   let results = searchSkills(query);
@@ -37350,8 +37820,17 @@ program2.command("info").argument("<skill>", "Skill name").option("--json", "Out
     console.log(`${skill.name} \u2014 ${skill.description} [${skill.category}] (tags: ${skill.tags.join(", ")})`);
     return;
   }
+  const { execSync: execSyncInfo } = __require("child_process");
+  function cmdAvailable(cmd) {
+    try {
+      execSyncInfo(`which ${cmd}`, { stdio: "ignore" });
+      return true;
+    } catch {
+      return false;
+    }
+  }
   console.log(`
-${chalk2.bold(skill.displayName)}`);
+${chalk2.bold(skill.displayName)}${skill.source === "custom" ? chalk2.yellow(" [custom]") : ""}`);
   console.log(`${skill.description}`);
   console.log(`${chalk2.dim("Category:")} ${skill.category}`);
   console.log(`${chalk2.dim("Tags:")} ${skill.tags.join(", ")}`);
@@ -37359,10 +37838,18 @@ ${chalk2.bold(skill.displayName)}`);
     console.log(`${chalk2.dim("CLI:")} ${reqs.cliCommand}`);
   }
   if (reqs?.envVars.length) {
-    console.log(`${chalk2.dim("Env vars:")} ${reqs.envVars.join(", ")}`);
+    console.log(`${chalk2.dim("Env vars:")}`);
+    for (const v of reqs.envVars) {
+      const set3 = !!process.env[v];
+      console.log(`  ${set3 ? chalk2.green("\u2713") : chalk2.red("\u2717")} ${v}${set3 ? "" : chalk2.dim(" (not set)")}`);
+    }
   }
   if (reqs?.systemDeps.length) {
-    console.log(`${chalk2.dim("System deps:")} ${reqs.systemDeps.join(", ")}`);
+    console.log(`${chalk2.dim("System deps:")}`);
+    for (const d of reqs.systemDeps) {
+      const avail = cmdAvailable(d);
+      console.log(`  ${avail ? chalk2.green("\u2713") : chalk2.red("\u2717")} ${d}${avail ? "" : chalk2.dim(" (not found)")}`);
+    }
   }
   console.log(`${chalk2.dim("Install:")} skills install ${skill.name}`);
 });
@@ -37466,7 +37953,7 @@ program2.command("run").argument("<skill>", "Skill name").argument("[args...]",
   }
   process.exitCode = result.exitCode;
 });
-program2.command("init").option("--json", "Output as JSON", false).option("--for <agent>", "Detect project type and install recommended skills for agent: claude, codex, gemini, or all").option("--scope <scope>", "Install scope: global or project", "global").description("Initialize project for installed skills (.env.example, .gitignore)").action((options) => {
+program2.command("init").option("--json", "Output as JSON", false).option("--for <agent>", "Detect project type and install recommended skills for agent: claude, codex, gemini, pi, opencode, or all").option("--scope <scope>", "Install scope: global or project", "global").description("Initialize project for installed skills (.env.example, .gitignore)").action((options) => {
   const cwd = process.cwd();
   if (options.for) {
     let agents;
@@ -37580,8 +38067,8 @@ Installing recommended skills for ${options.for} (${options.scope})...
     const envContent = lines.join(`
 `) + `
 `;
-    const envPath = join6(cwd, ".env.example");
-    writeFileSync3(envPath, envContent);
+    const envPath = join8(cwd, ".env.example");
+    writeFileSync4(envPath, envContent);
     envVarCount = envMap.size;
     if (!options.json) {
       console.log(chalk2.green(`\u2713 Generated .env.example (${envVarCount} variables from ${installed.length} skills)`));
@@ -37591,11 +38078,11 @@ Installing recommended skills for ${options.for} (${options.scope})...
       console.log(chalk2.dim("  No environment variables detected across installed skills"));
     }
   }
-  const gitignorePath = join6(cwd, ".gitignore");
+  const gitignorePath = join8(cwd, ".gitignore");
   const gitignoreEntry = ".skills/";
   let gitignoreContent = "";
-  if (existsSync6(gitignorePath)) {
-    gitignoreContent = readFileSync5(gitignorePath, "utf-8");
+  if (existsSync8(gitignorePath)) {
+    gitignoreContent = readFileSync7(gitignorePath, "utf-8");
   }
   let gitignoreUpdated = false;
   if (!gitignoreContent.includes(gitignoreEntry)) {
@@ -37641,7 +38128,7 @@ Initialized for ${installed.length} installed skill(s)`));
     }
   }
 });
-program2.command("remove").alias("rm").argument("<skill>", "Skill to remove").option("--verbose", "Enable verbose debug logging", false).option("--json", "Output as JSON", false).option("--for <agent>", "Remove from agent: claude, codex, gemini, or all").option("--scope <scope>", "Remove scope: global or project", "global").option("--dry-run", "Print what would happen without actually removing", false).option("-y, --yes", "Skip confirmation prompt", false).description("Remove an installed skill").action(async (skill, options) => {
+program2.command("remove").alias("rm").argument("<skill>", "Skill to remove").option("--verbose", "Enable verbose debug logging", false).option("--json", "Output as JSON", false).option("--for <agent>", "Remove from agent: claude, codex, gemini, pi, opencode, or all").option("--scope <scope>", "Remove scope: global or project", "global").option("--dry-run", "Print what would happen without actually removing", false).option("-y, --yes", "Skip confirmation prompt", false).description("Remove an installed skill").action(async (skill, options) => {
   debug(`remove: skill=${skill} for=${options.for ?? "none"} scope=${options.scope} dryRun=${options.dryRun}`);
   if (!options.yes && !options.dryRun && isTTY) {
     const skillName = normalizeSkillName(skill);
@@ -37724,10 +38211,10 @@ program2.command("update").argument("[skills...]", "Skills to update (default: a
   }
   function collectFiles(dir, base = "") {
     const files = new Set;
-    if (!existsSync6(dir))
+    if (!existsSync8(dir))
       return files;
-    for (const entry of readdirSync4(dir)) {
-      const full = join6(dir, entry);
+    for (const entry of readdirSync5(dir)) {
+      const full = join8(dir, entry);
       const rel = base ? `${base}/${entry}` : entry;
       if (statSync3(full).isDirectory()) {
         for (const f of collectFiles(full, rel))
@@ -37741,7 +38228,7 @@ program2.command("update").argument("[skills...]", "Skills to update (default: a
   const updateResults = [];
   for (const name of toUpdate) {
     const skillName = normalizeSkillName(name);
-    const destPath = join6(process.cwd(), ".skills", skillName);
+    const destPath = join8(process.cwd(), ".skills", skillName);
     const beforeFiles = collectFiles(destPath);
     const result = installSkill(name, { overwrite: true });
     const afterFiles = collectFiles(destPath);
@@ -37819,10 +38306,11 @@ Tags:
     console.log(`  ${chalk2.cyan(name)} (${count})`);
   }
 });
-program2.command("mcp").option("--register <agent>", "Register MCP server with agent: claude, codex, gemini, or all").description("Start MCP server (stdio) or register with an agent").action(async (options) => {
+program2.command("mcp").option("--register <agent>", "Register MCP server with agent: claude, codex, gemini, pi, opencode, or all").description("Start MCP server (stdio) or register with an agent").action(async (options) => {
   if (options.register) {
-    const agents = options.register === "all" ? ["claude", "codex", "gemini"] : [options.register];
-    const binPath = join6(import.meta.dir, "..", "mcp", "index.ts");
+    const agents = options.register === "all" ? [...AGENT_TARGETS] : [options.register];
+    const binPath = join8(import.meta.dir, "..", "mcp", "index.ts");
+    const { homedir: hd } = await import("os");
     for (const agent of agents) {
       if (agent === "claude") {
         try {
@@ -37836,8 +38324,7 @@ program2.command("mcp").option("--register <agent>", "Register MCP server with a
           console.log(chalk2.yellow(`Manual registration: claude mcp add skills -- bun run ${binPath}`));
         }
       } else if (agent === "codex") {
-        const { homedir: homedir4 } = await import("os");
-        const configPath = join6(homedir4(), ".codex", "config.toml");
+        const configPath = join8(hd(), ".codex", "config.toml");
         console.log(chalk2.bold(`
 Add to ${configPath}:`));
         console.log(chalk2.dim(`[mcp_servers.skills]
@@ -37845,16 +38332,25 @@ command = "bun"
 args = ["run", "${binPath}"]`));
         console.log(chalk2.green(`\u2713 Codex MCP config shown above`));
       } else if (agent === "gemini") {
-        const { homedir: homedir4 } = await import("os");
-        const configPath = join6(homedir4(), ".gemini", "settings.json");
+        const configPath = join8(hd(), ".gemini", "settings.json");
         console.log(chalk2.bold(`
 Add to ${configPath} mcpServers:`));
-        console.log(chalk2.dim(JSON.stringify({
-          skills: { command: "bun", args: ["run", binPath] }
-        }, null, 2)));
+        console.log(chalk2.dim(JSON.stringify({ skills: { command: "bun", args: ["run", binPath] } }, null, 2)));
         console.log(chalk2.green(`\u2713 Gemini MCP config shown above`));
+      } else if (agent === "pi") {
+        const configPath = join8(hd(), ".pi", "agent", "mcp.json");
+        console.log(chalk2.bold(`
+Add to ${configPath}:`));
+        console.log(chalk2.dim(JSON.stringify({ skills: { command: "bun", args: ["run", binPath] } }, null, 2)));
+        console.log(chalk2.green(`\u2713 pi.dev MCP config shown above`));
+      } else if (agent === "opencode") {
+        const configPath = join8(hd(), ".opencode", "config.json");
+        console.log(chalk2.bold(`
+Add to ${configPath} mcp section:`));
+        console.log(chalk2.dim(JSON.stringify({ skills: { command: "bun", args: ["run", binPath] } }, null, 2)));
+        console.log(chalk2.green(`\u2713 OpenCode MCP config shown above`));
       } else {
-        console.error(chalk2.red(`Unknown agent: ${agent}. Available: claude, codex, gemini, all`));
+        console.error(chalk2.red(`Unknown agent: ${agent}. Available: ${AGENT_TARGETS.join(", ")}, all`));
         process.exitCode = 1;
       }
     }
@@ -38040,18 +38536,18 @@ program2.command("export").option("--json", "Output as JSON (default behavior)",
   };
   console.log(JSON.stringify(payload, null, 2));
 });
-program2.command("import").argument("<file>", "JSON file to import (use - for stdin)").option("--json", "Output results as JSON", false).option("--for <agent>", "Install for agent: claude, codex, gemini, or all").option("--scope <scope>", "Install scope: global or project", "global").option("--dry-run", "Show what would be installed without actually installing", false).description("Import and install skills from a JSON export file").action(async (file2, options) => {
+program2.command("import").argument("<file>", "JSON file to import (use - for stdin)").option("--json", "Output results as JSON", false).option("--for <agent>", "Install for agent: claude, codex, gemini, pi, opencode, or all").option("--scope <scope>", "Install scope: global or project", "global").option("--dry-run", "Show what would be installed without actually installing", false).description("Import and install skills from a JSON export file").action(async (file2, options) => {
   let raw;
   try {
     if (file2 === "-") {
       raw = await new Response(process.stdin).text();
     } else {
-      if (!existsSync6(file2)) {
+      if (!existsSync8(file2)) {
         console.error(chalk2.red(`File not found: ${file2}`));
         process.exitCode = 1;
         return;
       }
-      raw = readFileSync5(file2, "utf-8");
+      raw = readFileSync7(file2, "utf-8");
     }
   } catch (err) {
     console.error(chalk2.red(`Failed to read file: ${err.message}`));
@@ -38142,7 +38638,8 @@ Imported ${succeeded}/${total} skill(s)${failed > 0 ? ` (${failed} failed)` : ""
     process.exitCode = 1;
   }
 });
-program2.command("doctor").option("--json", "Output as JSON", false).description("Check environment variables for installed skills").action((options) => {
+program2.command("doctor").option("--json", "Output as JSON", false).description("Check env vars, system deps, and install health for installed skills").action((options) => {
+  const { execSync } = __require("child_process");
   const installed = getInstalledSkills();
   if (installed.length === 0) {
     if (options.json) {
@@ -38152,37 +38649,53 @@ program2.command("doctor").option("--json", "Output as JSON", false).description
     }
     return;
   }
+  function isCommandAvailable(cmd) {
+    try {
+      execSync(`which ${cmd}`, { stdio: "ignore" });
+      return true;
+    } catch {
+      return false;
+    }
+  }
   const report = [];
   for (const name of installed) {
     const reqs = getSkillRequirements(name);
-    const envVars = (reqs?.envVars ?? []).map((v) => ({
-      name: v,
-      set: !!process.env[v]
-    }));
-    report.push({ skill: name, envVars });
+    const envVars = (reqs?.envVars ?? []).map((v) => ({ name: v, set: !!process.env[v] }));
+    const systemDeps = (reqs?.systemDeps ?? []).map((d) => ({ name: d, available: isCommandAvailable(d) }));
+    const healthy = envVars.every((v) => v.set) && systemDeps.every((d) => d.available);
+    report.push({ skill: name, envVars, systemDeps, healthy });
   }
   if (options.json) {
     console.log(JSON.stringify(report, null, 2));
     return;
   }
+  const issues = report.filter((r) => !r.healthy);
   console.log(chalk2.bold(`
-Skills Doctor (${installed.length} installed):
+Skills Doctor \u2014 ${installed.length} installed, ${issues.length} with issues:
 `));
   for (const entry of report) {
-    console.log(chalk2.bold(`  ${entry.skill}`));
-    if (entry.envVars.length === 0) {
-      console.log(chalk2.dim("    No environment variables required"));
-    } else {
-      for (const v of entry.envVars) {
-        const status = v.set ? chalk2.green("set") : chalk2.red("missing");
-        console.log(`    ${v.name} [${status}]`);
-      }
+    const icon = entry.healthy ? chalk2.green("\u2713") : chalk2.red("\u2717");
+    console.log(`  ${icon} ${chalk2.bold(entry.skill)}`);
+    for (const v of entry.envVars) {
+      const status = v.set ? chalk2.green("set") : chalk2.red("missing");
+      console.log(`      ${v.name} [${status}]`);
+    }
+    for (const d of entry.systemDeps) {
+      const status = d.available ? chalk2.green("available") : chalk2.red("not found");
+      console.log(`      ${d.name} [${status}]`);
     }
+    if (entry.envVars.length === 0 && entry.systemDeps.length === 0) {
+      console.log(chalk2.dim("      No requirements"));
+    }
+  }
+  if (issues.length === 0) {
+    console.log(chalk2.green(`
+  All skills healthy! \u2713`));
   }
 });
 program2.command("auth").argument("[skill]", "Skill name (omit to check all installed skills)").option("--set <assignment>", "Set an env var in .env file (format: KEY=VALUE)").option("--json", "Output as JSON", false).description("Show auth/env var status for a skill or all installed skills").action((name, options) => {
   const cwd = process.cwd();
-  const envFilePath = join6(cwd, ".env");
+  const envFilePath = join8(cwd, ".env");
   if (options.set) {
     const eqIdx = options.set.indexOf("=");
     if (eqIdx === -1) {
@@ -38198,8 +38711,8 @@ program2.command("auth").argument("[skill]", "Skill name (omit to check all inst
       return;
     }
     let existing = "";
-    if (existsSync6(envFilePath)) {
-      existing = readFileSync5(envFilePath, "utf-8");
+    if (existsSync8(envFilePath)) {
+      existing = readFileSync7(envFilePath, "utf-8");
     }
     const keyPattern = new RegExp(`^${key}=.*$`, "m");
     let updated;
@@ -38212,7 +38725,7 @@ program2.command("auth").argument("[skill]", "Skill name (omit to check all inst
 ${key}=${value}
 `;
     }
-    writeFileSync3(envFilePath, updated, "utf-8");
+    writeFileSync4(envFilePath, updated, "utf-8");
     console.log(chalk2.green(`Set ${key} in ${envFilePath}`));
     return;
   }
@@ -38282,21 +38795,20 @@ program2.command("whoami").option("--json", "Output as JSON", false).description
   const version2 = package_default.version;
   const cwd = process.cwd();
   const installed = getInstalledSkills();
-  const agentNames = ["claude", "codex", "gemini"];
   const agentConfigs = [];
-  for (const agent of agentNames) {
-    const agentSkillsPath = join6(homedir4(), `.${agent}`, "skills");
-    const exists = existsSync6(agentSkillsPath);
+  for (const agent of AGENT_TARGETS) {
+    const agentSkillsPath = getAgentSkillsDir(agent, "global");
+    const exists = existsSync8(agentSkillsPath);
     let skillCount = 0;
     if (exists) {
       try {
-        skillCount = readdirSync4(agentSkillsPath).filter((f) => {
-          const full = join6(agentSkillsPath, f);
+        skillCount = readdirSync5(agentSkillsPath).filter((f) => {
+          const full = join8(agentSkillsPath, f);
           return f.startsWith("skill-") && statSync3(full).isDirectory();
         }).length;
       } catch {}
     }
-    agentConfigs.push({ agent, path: agentSkillsPath, exists, skillCount });
+    agentConfigs.push({ agent, label: AGENT_LABELS[agent], path: agentSkillsPath, exists, skillCount });
   }
   const skillsDir = getSkillPath("image").replace(/[/\\][^/\\]*$/, "");
   if (options.json) {
@@ -38436,19 +38948,19 @@ program2.command("outdated").option("--json", "Output as JSON", false).descripti
   const upToDate = [];
   for (const name of installed) {
     const skillName = normalizeSkillName(name);
-    const installedPkgPath = join6(cwd, ".skills", skillName, "package.json");
+    const installedPkgPath = join8(cwd, ".skills", skillName, "package.json");
     let installedVersion = "unknown";
-    if (existsSync6(installedPkgPath)) {
+    if (existsSync8(installedPkgPath)) {
       try {
-        installedVersion = JSON.parse(readFileSync5(installedPkgPath, "utf-8")).version || "unknown";
+        installedVersion = JSON.parse(readFileSync7(installedPkgPath, "utf-8")).version || "unknown";
       } catch {}
     }
     const registryPath = getSkillPath(name);
-    const registryPkgPath = join6(registryPath, "package.json");
+    const registryPkgPath = join8(registryPath, "package.json");
     let registryVersion = "unknown";
-    if (existsSync6(registryPkgPath)) {
+    if (existsSync8(registryPkgPath)) {
       try {
-        registryVersion = JSON.parse(readFileSync5(registryPkgPath, "utf-8")).version || "unknown";
+        registryVersion = JSON.parse(readFileSync7(registryPkgPath, "utf-8")).version || "unknown";
       } catch {}
     }
     if (installedVersion !== registryVersion) {
@@ -38513,7 +39025,470 @@ configCmd.command("get <key>").description("Get a specific configuration value")
 configCmd.command("path").description("Show configuration file paths").action(() => {
   const globalPath = getConfigPath("global");
   const projectPath = getConfigPath("project");
-  console.log(`${chalk2.cyan("global")}:  ${globalPath}${existsSync6(globalPath) ? chalk2.green(" (exists)") : chalk2.dim(" (not found)")}`);
-  console.log(`${chalk2.cyan("project")}: ${projectPath}${existsSync6(projectPath) ? chalk2.green(" (exists)") : chalk2.dim(" (not found)")}`);
+  console.log(`${chalk2.cyan("global")}:  ${globalPath}${existsSync8(globalPath) ? chalk2.green(" (exists)") : chalk2.dim(" (not found)")}`);
+  console.log(`${chalk2.cyan("project")}: ${projectPath}${existsSync8(projectPath) ? chalk2.green(" (exists)") : chalk2.dim(" (not found)")}`);
+});
+program2.command("create").argument("<name>", "Skill name (e.g. my-tool)").option("--category <category>", "Skill category", "Development Tools").option("--description <description>", "Short description of what the skill does").option("--tags <tags>", "Comma-separated tags (e.g. api,testing,automation)").option("--global", "Create in ~/.skills/ instead of .skills/custom-skills/", false).option("--json", "Output result as JSON", false).description("Scaffold a new custom skill directory").action((name, options) => {
+  const { homedir: homedir4 } = __require("os");
+  const bare = name.replace(/^skill-/, "");
+  const dirName = `skill-${bare}`;
+  const baseDir = options.global ? join8(homedir4(), ".skills") : join8(process.cwd(), ".skills", "custom-skills");
+  const skillDir = join8(baseDir, dirName);
+  if (existsSync8(skillDir)) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: `Skill '${bare}' already exists at ${skillDir}` }));
+    } else {
+      console.error(chalk2.red(`Skill '${bare}' already exists at ${skillDir}`));
+    }
+    process.exitCode = 1;
+    return;
+  }
+  const description = options.description || `${bare} skill`;
+  const tags = options.tags ? options.tags.split(",").map((t) => t.trim()).filter(Boolean) : [bare];
+  const displayName = bare.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+  const category = options.category;
+  mkdirSync4(join8(skillDir, "src"), { recursive: true });
+  writeFileSync4(join8(skillDir, "SKILL.md"), [
+    "---",
+    `name: ${bare}`,
+    `description: ${description}`,
+    `displayName: ${displayName}`,
+    `category: ${category}`,
+    `tags: [${tags.join(", ")}]`,
+    "---",
+    "",
+    `# ${displayName}`,
+    "",
+    description,
+    "",
+    "## Usage",
+    "",
+    "```bash",
+    `${bare} --help`,
+    "```",
+    ""
+  ].join(`
+`));
+  writeFileSync4(join8(skillDir, "src", "index.ts"), [
+    `#!/usr/bin/env bun`,
+    `/**`,
+    ` * ${displayName} \u2014 ${description}`,
+    ` */`,
+    "",
+    `console.log("${displayName}");`,
+    ""
+  ].join(`
+`));
+  writeFileSync4(join8(skillDir, "package.json"), JSON.stringify({
+    name: `skill-${bare}`,
+    version: "0.1.0",
+    description,
+    bin: { [bare]: "./src/index.ts" },
+    scripts: { dev: `bun src/index.ts` },
+    dependencies: {}
+  }, null, 2) + `
+`);
+  writeFileSync4(join8(skillDir, "tsconfig.json"), JSON.stringify({
+    compilerOptions: {
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      strict: true,
+      outDir: "dist"
+    },
+    include: ["src/**/*.ts"]
+  }, null, 2) + `
+`);
+  clearRegistryCache();
+  if (options.json) {
+    console.log(JSON.stringify({ created: true, name: bare, path: skillDir, category, tags }));
+  } else {
+    console.log(chalk2.green(`\u2713 Created custom skill '${bare}' at ${skillDir}`));
+    console.log(chalk2.dim(`  Category: ${category}`));
+    console.log(chalk2.dim(`  Tags: ${tags.join(", ")}`));
+    console.log("");
+    console.log(`  ${chalk2.cyan("Edit:")} ${join8(skillDir, "src", "index.ts")}`);
+    console.log(`  ${chalk2.cyan("Run:")}  bun ${join8(skillDir, "src", "index.ts")}`);
+    console.log(`  ${chalk2.cyan("Docs:")} ${join8(skillDir, "SKILL.md")}`);
+  }
+});
+program2.command("sync").option("--to <agent>", "Push custom skills to agent: claude, codex, gemini, pi, opencode, or all").option("--from <agent>", "List agent skills and show which are unknown to the registry").option("--register", "With --from: copy unknown agent skills into ~/.skills/ to add them to the registry", false).option("--scope <scope>", "Agent install scope: global or project", "global").option("--json", "Output as JSON", false).description("Sync custom skills with agent directories (--to or --from)").action((options) => {
+  const { homedir: homedir4 } = __require("os");
+  if (!options.to && !options.from) {
+    console.error(chalk2.red("Specify --to <agent> or --from <agent>"));
+    process.exitCode = 1;
+    return;
+  }
+  if (options.from) {
+    const agentName = options.from;
+    if (!AGENT_TARGETS.includes(agentName)) {
+      console.error(chalk2.red(`Unknown agent: ${agentName}. Available: ${AGENT_TARGETS.join(", ")}`));
+      process.exitCode = 1;
+      return;
+    }
+    const agentDir = getAgentSkillsDir(agentName, options.scope);
+    if (!existsSync8(agentDir)) {
+      if (options.json) {
+        console.log(JSON.stringify({ agentDir, skills: [], message: "Directory not found" }));
+      } else {
+        console.log(chalk2.dim(`No skills directory found at ${agentDir}`));
+      }
+      return;
+    }
+    const registry2 = loadRegistry();
+    const registryNames = new Set(registry2.map((s) => s.name));
+    const found = [];
+    for (const entry of readdirSync5(agentDir, { withFileTypes: true })) {
+      if (!entry.isDirectory())
+        continue;
+      const bare = entry.name.replace(/^skill-/, "");
+      found.push({
+        name: bare,
+        path: join8(agentDir, entry.name),
+        inRegistry: registryNames.has(bare)
+      });
+    }
+    const unknown3 = found.filter((s) => !s.inRegistry);
+    if (options.register && unknown3.length > 0) {
+      const globalSkillsDir = join8(homedir4(), ".skills");
+      const registered = [];
+      for (const s of unknown3) {
+        const srcSkillMd = join8(s.path, "SKILL.md");
+        if (!existsSync8(srcSkillMd))
+          continue;
+        const destDir = join8(globalSkillsDir, `skill-${s.name}`);
+        if (!existsSync8(destDir)) {
+          mkdirSync4(destDir, { recursive: true });
+        }
+        writeFileSync4(join8(destDir, "SKILL.md"), readFileSync7(srcSkillMd, "utf-8"));
+        registered.push(s.name);
+      }
+      clearRegistryCache();
+      if (options.json) {
+        console.log(JSON.stringify({ agentDir, skills: found, registered }));
+      } else {
+        for (const name of registered) {
+          console.log(chalk2.green(`\u2713 Registered '${name}' into ~/.skills/ (global custom)`));
+        }
+        if (registered.length === 0)
+          console.log(chalk2.dim("No new skills to register (all SKILL.md files missing)"));
+      }
+      return;
+    }
+    if (options.json) {
+      console.log(JSON.stringify({ agentDir, skills: found }));
+    } else {
+      console.log(chalk2.bold(`
+Agent skills in ~/.${agentName}/skills/ (${found.length} found):
+`));
+      for (const s of found) {
+        const label = s.inRegistry ? chalk2.green("\u2713 in registry") : chalk2.yellow("\u2717 not in registry");
+        console.log(`  ${chalk2.cyan(s.name)} \u2014 ${label}`);
+      }
+      if (unknown3.length > 0) {
+        console.log("");
+        console.log(chalk2.dim(`Tip: ${unknown3.length} skill(s) not in registry. Run with --register to add them to ~/.skills/.`));
+      }
+    }
+    return;
+  }
+  if (options.to) {
+    let agents;
+    try {
+      agents = resolveAgents(options.to);
+    } catch (err) {
+      console.error(chalk2.red(err.message));
+      process.exitCode = 1;
+      return;
+    }
+    const registry2 = loadRegistry();
+    const customSkills = registry2.filter((s) => s.source === "custom");
+    if (customSkills.length === 0) {
+      if (options.json) {
+        console.log(JSON.stringify({ pushed: 0, message: "No custom skills found" }));
+      } else {
+        console.log(chalk2.dim("No custom skills found. Use 'skills create <name>' to scaffold one."));
+      }
+      return;
+    }
+    const results = [];
+    for (const skill of customSkills) {
+      for (const agent of agents) {
+        const result = installSkillForAgent(skill.name, {
+          agent,
+          scope: options.scope
+        }, generateSkillMd);
+        results.push({ skill: skill.name, agent, success: result.success, error: result.error });
+      }
+    }
+    if (options.json) {
+      console.log(JSON.stringify({ pushed: results.filter((r) => r.success).length, results }));
+    } else {
+      for (const r of results) {
+        if (r.success) {
+          console.log(chalk2.green(`\u2713 ${r.skill} \u2192 ${r.agent}`));
+        } else {
+          console.log(chalk2.red(`\u2717 ${r.skill} \u2192 ${r.agent}: ${r.error}`));
+        }
+      }
+    }
+  }
+});
+program2.command("validate").argument("<name>", "Skill name to validate").option("--json", "Output as JSON", false).description("Validate a skill's directory structure (SKILL.md, package.json, src/index.ts, tsconfig.json)").action((name, options) => {
+  const skillPath = getSkillPath(name);
+  const issues = [];
+  if (!existsSync8(skillPath)) {
+    if (options.json) {
+      console.log(JSON.stringify({ name, valid: false, issues: [`Skill directory not found: ${skillPath}`] }));
+    } else {
+      console.error(chalk2.red(`Skill '${name}' not found at ${skillPath}`));
+    }
+    process.exitCode = 1;
+    return;
+  }
+  if (!existsSync8(join8(skillPath, "SKILL.md")))
+    issues.push("Missing SKILL.md");
+  if (!existsSync8(join8(skillPath, "tsconfig.json")))
+    issues.push("Missing tsconfig.json");
+  const pkgPath = join8(skillPath, "package.json");
+  if (!existsSync8(pkgPath)) {
+    issues.push("Missing package.json");
+  } else {
+    try {
+      const pkg = JSON.parse(readFileSync7(pkgPath, "utf-8"));
+      if (!pkg.bin || Object.keys(pkg.bin).length === 0)
+        issues.push("package.json missing 'bin' entry");
+    } catch {
+      issues.push("package.json is invalid JSON");
+    }
+  }
+  if (!existsSync8(join8(skillPath, "src"))) {
+    issues.push("Missing src/ directory");
+  } else if (!existsSync8(join8(skillPath, "src", "index.ts"))) {
+    issues.push("Missing src/index.ts");
+  }
+  const valid = issues.length === 0;
+  if (options.json) {
+    console.log(JSON.stringify({ name, valid, path: skillPath, issues }));
+  } else if (valid) {
+    console.log(chalk2.green(`\u2713 ${name} \u2014 all checks passed`));
+  } else {
+    console.log(chalk2.red(`\u2717 ${name} \u2014 ${issues.length} issue(s):`));
+    for (const issue2 of issues)
+      console.log(chalk2.red(`  \u2022 ${issue2}`));
+    process.exitCode = 1;
+  }
+});
+program2.command("diff").argument("<name>", "Skill name to diff").option("--json", "Output as JSON", false).description("Show files that differ between installed version and source (preview before update)").action((name, options) => {
+  const bare = name.replace(/^skill-/, "");
+  const skillName = `skill-${bare}`;
+  const destPath = join8(process.cwd(), ".skills", skillName);
+  const sourcePath = getSkillPath(bare);
+  if (!existsSync8(sourcePath)) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: `Skill '${bare}' not found in registry` }));
+    } else {
+      skillNotFound(bare);
+    }
+    process.exitCode = 1;
+    return;
+  }
+  if (!existsSync8(destPath)) {
+    if (options.json) {
+      console.log(JSON.stringify({ installed: false, message: `'${bare}' is not installed locally` }));
+    } else {
+      console.log(chalk2.dim(`'${bare}' is not installed. Run: skills install ${bare}`));
+    }
+    return;
+  }
+  function collectFiles(dir, base = "") {
+    const files = new Map;
+    if (!existsSync8(dir))
+      return files;
+    for (const entry of readdirSync5(dir)) {
+      const full = join8(dir, entry);
+      const rel = base ? `${base}/${entry}` : entry;
+      if (statSync3(full).isDirectory()) {
+        for (const [k, v] of collectFiles(full, rel))
+          files.set(k, v);
+      } else {
+        try {
+          files.set(rel, readFileSync7(full, "utf-8"));
+        } catch {
+          files.set(rel, "");
+        }
+      }
+    }
+    return files;
+  }
+  const installed = collectFiles(destPath);
+  const source = collectFiles(sourcePath);
+  const changed = [];
+  const added = [];
+  const removed = [];
+  for (const [file2, content] of source) {
+    if (!installed.has(file2))
+      added.push(file2);
+    else if (installed.get(file2) !== content)
+      changed.push(file2);
+  }
+  for (const file2 of installed.keys()) {
+    if (!source.has(file2))
+      removed.push(file2);
+  }
+  if (options.json) {
+    console.log(JSON.stringify({ name: bare, changed, added, removed, upToDate: changed.length === 0 && added.length === 0 && removed.length === 0 }));
+    return;
+  }
+  if (changed.length === 0 && added.length === 0 && removed.length === 0) {
+    console.log(chalk2.green(`\u2713 ${bare} \u2014 up to date`));
+    return;
+  }
+  console.log(chalk2.bold(`
+Diff for '${bare}':
+`));
+  for (const f of changed)
+    console.log(chalk2.yellow(`  ~ ${f}`));
+  for (const f of added)
+    console.log(chalk2.green(`  + ${f}`));
+  for (const f of removed)
+    console.log(chalk2.red(`  - ${f}`));
+  console.log(`
+${chalk2.dim(`Run 'skills update ${bare}' to apply changes`)}`);
+});
+var scheduleCmd = program2.command("schedule").description("Manage scheduled skill runs (cron-based)");
+scheduleCmd.command("add").argument("<skill>", "Skill to schedule (bare name, e.g. image)").argument("<cron>", '5-field cron expression (e.g. "0 9 * * *" = daily at 9am)').option("--name <label>", "Human-readable label for this schedule").option("--args <args>", "Space-separated args to pass to the skill").option("--json", "Output as JSON", false).description("Add a cron schedule for a skill").action((skill, cron, options) => {
+  const args = options.args ? options.args.split(" ").filter(Boolean) : undefined;
+  const { schedule, error: error48 } = addSchedule(skill, cron, { name: options.name, args });
+  if (options.json) {
+    console.log(JSON.stringify(schedule ? { schedule } : { error: error48 }));
+    return;
+  }
+  if (error48 || !schedule) {
+    console.error(chalk2.red(`\u2717 ${error48 || "Failed to add schedule"}`));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(chalk2.green(`\u2713 Scheduled '${schedule.name}'`));
+  console.log(chalk2.dim(`  Cron: ${schedule.cron}`));
+  if (schedule.nextRun) {
+    console.log(chalk2.dim(`  Next run: ${new Date(schedule.nextRun).toLocaleString()}`));
+  }
+  console.log(chalk2.dim(`  ID: ${schedule.id}`));
+});
+scheduleCmd.command("list").option("--json", "Output as JSON", false).description("List all scheduled skills").action((options) => {
+  const schedules = listSchedules();
+  if (options.json) {
+    console.log(JSON.stringify(schedules));
+    return;
+  }
+  if (schedules.length === 0) {
+    console.log(chalk2.dim("No schedules. Run: skills schedule add <skill> <cron>"));
+    return;
+  }
+  console.log(chalk2.bold(`
+Scheduled skills (${schedules.length}):
+`));
+  for (const s of schedules) {
+    const status = s.enabled ? chalk2.green("enabled") : chalk2.dim("disabled");
+    const last = s.lastRun ? `last: ${new Date(s.lastRun).toLocaleString()} [${s.lastRunStatus ?? "?"}]` : "never run";
+    const next = s.nextRun ? `next: ${new Date(s.nextRun).toLocaleString()}` : "";
+    console.log(`  ${chalk2.cyan(s.name)} [${status}]`);
+    console.log(chalk2.dim(`    skill: ${s.skill}  cron: ${s.cron}  ${last}  ${next}`));
+  }
+});
+scheduleCmd.command("remove").argument("<id-or-name>", "Schedule ID or name to remove").option("--json", "Output as JSON", false).description("Remove a schedule").action((idOrName, options) => {
+  const removed = removeSchedule(idOrName);
+  if (options.json) {
+    console.log(JSON.stringify({ removed, idOrName }));
+    return;
+  }
+  if (removed) {
+    console.log(chalk2.green(`\u2713 Removed schedule '${idOrName}'`));
+  } else {
+    console.error(chalk2.red(`Schedule '${idOrName}' not found`));
+    process.exitCode = 1;
+  }
+});
+scheduleCmd.command("enable").argument("<id-or-name>", "Schedule ID or name").description("Enable a disabled schedule").action((idOrName) => {
+  const ok = setScheduleEnabled(idOrName, true);
+  if (ok)
+    console.log(chalk2.green(`\u2713 Enabled '${idOrName}'`));
+  else {
+    console.error(chalk2.red(`Schedule '${idOrName}' not found`));
+    process.exitCode = 1;
+  }
+});
+scheduleCmd.command("disable").argument("<id-or-name>", "Schedule ID or name").description("Disable a schedule without removing it").action((idOrName) => {
+  const ok = setScheduleEnabled(idOrName, false);
+  if (ok)
+    console.log(chalk2.green(`\u2713 Disabled '${idOrName}'`));
+  else {
+    console.error(chalk2.red(`Schedule '${idOrName}' not found`));
+    process.exitCode = 1;
+  }
+});
+scheduleCmd.command("run").option("--dry-run", "Show which schedules are due without running them", false).option("--json", "Output as JSON", false).description("Execute all due schedules now").action(async (options) => {
+  const due = getDueSchedules();
+  if (due.length === 0) {
+    if (options.json)
+      console.log(JSON.stringify({ ran: 0, schedules: [] }));
+    else
+      console.log(chalk2.dim("No schedules are due."));
+    return;
+  }
+  if (options.dryRun) {
+    if (options.json)
+      console.log(JSON.stringify({ due: due.map((s) => s.name) }));
+    else {
+      console.log(chalk2.bold(`${due.length} schedule(s) due:
+`));
+      for (const s of due)
+        console.log(`  ${chalk2.cyan(s.name)} \u2014 ${s.skill} (${s.cron})`);
+    }
+    return;
+  }
+  const results = [];
+  for (const s of due) {
+    try {
+      const { runSkill: runSkill2 } = await Promise.resolve().then(() => (init_skillinfo(), exports_skillinfo));
+      await runSkill2(s.skill, s.args ?? []);
+      recordScheduleRun(s.id, "success");
+      results.push({ name: s.name, skill: s.skill, status: "success" });
+    } catch (err) {
+      recordScheduleRun(s.id, "error");
+      results.push({ name: s.name, skill: s.skill, status: "error", error: err.message });
+    }
+  }
+  if (options.json) {
+    console.log(JSON.stringify({ ran: results.length, results }));
+  } else {
+    for (const r of results) {
+      const icon = r.status === "success" ? chalk2.green("\u2713") : chalk2.red("\u2717");
+      console.log(`${icon} ${r.name} (${r.skill})`);
+      if (r.error)
+        console.log(chalk2.dim(`  ${r.error}`));
+    }
+  }
+});
+scheduleCmd.command("validate").argument("<cron>", "Cron expression to validate").description("Validate a cron expression and show the next 5 run times").action((cron) => {
+  const { getNextRun: getNextRun2 } = (init_scheduler(), __toCommonJS(exports_scheduler));
+  const { valid, error: error48 } = validateCron(cron);
+  if (!valid) {
+    console.error(chalk2.red(`Invalid cron: ${error48}`));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(chalk2.green(`\u2713 Valid cron: "${cron}"`));
+  console.log(chalk2.dim(`
+Next 5 run times:`));
+  let d = new Date;
+  for (let i = 0;i < 5; i++) {
+    const next = getNextRun2(cron, d);
+    if (!next)
+      break;
+    console.log(`  ${next.toLocaleString()}`);
+    d = next;
+  }
 });
 program2.parse();