@hasna/skills 0.1.14 → 0.1.15

package/bin/mcp.js

@@ -44,6 +44,7 @@ var __export = (target, all) => {
       set: __exportSetter.bind(all, name)
     });
 };
+var __require = import.meta.require;
 
 // node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS((exports) => {
@@ -28560,13 +28561,12 @@ class StdioServerTransport {
 }
 
 // src/mcp/index.ts
-import { existsSync as existsSync3, readdirSync as readdirSync3, statSync as statSync2 } from "fs";
-import { join as join3 } from "path";
-import { homedir as homedir2 } from "os";
+import { existsSync as existsSync5, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
+import { join as join5 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.14",
+  version: "0.1.15",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -28650,6 +28650,9 @@ var package_default = {
 };
 
 // src/lib/registry.ts
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
 var CATEGORIES = [
   "Development Tools",
   "Business & Marketing",
@@ -29686,6 +29689,20 @@ var SKILLS = [
     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",
@@ -30086,8 +30103,87 @@ var SKILLS = [
     tags: ["seating", "chart", "events", "venues"]
   }
 ];
+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;
+}
+var _registryCache = null;
+var _registryCacheTime = 0;
+var REGISTRY_CACHE_TTL = 5000;
+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 getSkillsByCategory(category) {
-  return SKILLS.filter((s) => s.category === category);
+  return loadRegistry().filter((s) => s.category === category);
 }
 function editDistance(a, b) {
   if (a === b)
@@ -30133,7 +30229,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();
@@ -30169,7 +30265,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;
@@ -30183,14 +30279,14 @@ 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);
 }
 
 // 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";
 
 // src/lib/utils.ts
@@ -30203,33 +30299,33 @@ var __dirname2 = dirname(fileURLToPath(import.meta.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");
 }
 var SKILLS_DIR = findSkillsDir();
 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,
@@ -30238,10 +30334,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, {
@@ -30277,10 +30373,10 @@ function installSkill(name, options = {}) {
   }
 }
 function updateSkillsIndex(skillsDir) {
-  const indexPath = join(skillsDir, "index.ts");
+  const indexPath = join2(skillsDir, "index.ts");
   const meta3 = loadMeta(skillsDir);
   const disabledSet = new Set(meta3.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';`;
@@ -30296,13 +30392,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: {} };
@@ -30315,9 +30411,9 @@ function recordInstall(skillsDir, name) {
   const skillName = normalizeSkillName(name);
   let version2 = "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"));
       version2 = pkg.version || "unknown";
     }
   } catch {}
@@ -30330,20 +30426,20 @@ function recordRemove(skillsDir, name) {
   saveMeta(skillsDir, meta3);
 }
 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 });
@@ -30351,7 +30447,14 @@ function removeSkill(name, targetDir = process.cwd()) {
   recordRemove(skillsDir, name);
   return true;
 }
-var AGENT_TARGETS = ["claude", "codex", "gemini"];
+var AGENT_TARGETS = ["claude", "codex", "gemini", "pi", "opencode"];
+var AGENT_LABELS = {
+  claude: "Claude Code",
+  codex: "Codex CLI",
+  gemini: "Gemini CLI",
+  pi: "pi.dev",
+  opencode: "OpenCode"
+};
 function resolveAgents(agentArg) {
   if (agentArg === "all")
     return [...AGENT_TARGETS];
@@ -30362,27 +30465,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);
   }
@@ -30391,17 +30498,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 {
@@ -30416,7 +30518,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 (error48) {
     return {
@@ -30429,7 +30531,7 @@ 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 });
@@ -30437,16 +30539,16 @@ function removeSkillForAgent(name, options) {
 }
 
 // src/lib/skillinfo.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync as readdirSync2 } from "fs";
-import { join as join2 } from "path";
+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) {
@@ -30457,11 +30559,11 @@ function getSkillBestDoc(name) {
 }
 function getSkillRequirements(name) {
   const skillPath = getSkillPath(name);
-  if (!existsSync2(skillPath))
+  if (!existsSync3(skillPath))
     return null;
   const texts = [];
   for (const file2 of ["SKILL.md", "README.md", "CLAUDE.md", ".env.example", ".env.local.example"]) {
-    const content = readIfExists(join2(skillPath, file2));
+    const content = readIfExists(join3(skillPath, file2));
     if (content)
       texts.push(content);
   }
@@ -30488,10 +30590,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)
@@ -30511,25 +30613,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];
@@ -30543,12 +30645,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",
@@ -30565,12 +30667,99 @@ async function runSkill(name, args, options = {}) {
   const exitCode = await proc.exited;
   return { exitCode };
 }
+function detectProjectSkills(cwd = process.cwd()) {
+  const pkgPath = join3(cwd, "package.json");
+  if (!existsSync3(pkgPath)) {
+    const alwaysRecommend = ["implementation-plan", "write", "deepresearch"];
+    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(readFileSync3(pkgPath, "utf-8"));
+  } catch {
+    const alwaysRecommend = ["implementation-plan", "write", "deepresearch"];
+    const recommended2 = alwaysRecommend.map((name) => loadRegistry().find((s) => s.name === name)).filter((s) => s !== undefined);
+    return { detected: [], recommended: recommended2 };
+  }
+  const allDeps = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies
+  };
+  const depNames = Object.keys(allDeps);
+  const detected = [];
+  const recommendedNames = new Set;
+  for (const name of ["implementation-plan", "write", "deepresearch"]) {
+    recommendedNames.add(name);
+  }
+  const frontendDeps = ["next", "react", "vue", "svelte", "nuxt", "@nuxtjs/nuxt"];
+  for (const dep of frontendDeps) {
+    if (depNames.some((d) => d === dep || d.startsWith(`${dep}/`))) {
+      detected.push(dep);
+      for (const name of ["image", "generate-favicon", "seo-brief-builder"]) {
+        recommendedNames.add(name);
+      }
+      break;
+    }
+  }
+  const backendDeps = ["express", "fastify", "hono", "koa", "@hono/hono"];
+  for (const dep of backendDeps) {
+    if (depNames.some((d) => d === dep || d.startsWith(`${dep}/`))) {
+      detected.push(dep);
+      for (const name of ["api-test-suite", "apidocs"]) {
+        recommendedNames.add(name);
+      }
+      break;
+    }
+  }
+  const aiDeps = ["@anthropic-ai/sdk", "openai", "@openai/openai", "anthropic"];
+  for (const dep of aiDeps) {
+    if (depNames.includes(dep)) {
+      detected.push(dep);
+      for (const name of ["deepresearch", "webcrawling"]) {
+        recommendedNames.add(name);
+      }
+      break;
+    }
+  }
+  if (depNames.includes("stripe")) {
+    detected.push("stripe");
+    recommendedNames.add("invoice");
+  }
+  const emailDeps = ["nodemailer", "@sendgrid/mail", "@sendgrid/client"];
+  for (const dep of emailDeps) {
+    if (depNames.includes(dep)) {
+      detected.push(dep);
+      for (const name of ["gmail", "email-campaign"]) {
+        recommendedNames.add(name);
+      }
+      break;
+    }
+  }
+  const testDeps = ["vitest", "jest", "mocha", "@jest/core"];
+  for (const dep of testDeps) {
+    if (depNames.includes(dep)) {
+      detected.push(dep);
+      recommendedNames.add("api-test-suite");
+      break;
+    }
+  }
+  if (depNames.includes("typescript")) {
+    detected.push("typescript");
+    for (const name of ["scaffold-project", "deploy"]) {
+      recommendedNames.add(name);
+    }
+  }
+  const uniqueDetected = Array.from(new Set(detected));
+  const recommended = Array.from(recommendedNames).map((name) => loadRegistry().find((s) => s.name === name)).filter((s) => s !== undefined);
+  return { detected: uniqueDetected, recommended };
+}
 function generateSkillMd(name) {
   const meta3 = getSkill(name);
   if (!meta3)
     return null;
   const skillPath = getSkillPath(name);
-  if (!existsSync2(skillPath))
+  if (!existsSync3(skillPath))
     return null;
   const frontmatter = [
     "---",
@@ -30579,13 +30768,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)
@@ -30660,13 +30849,141 @@ 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;
 }
 
+// src/lib/scheduler.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { join as join4 } from "path";
+function getSchedulesPath(targetDir = process.cwd()) {
+  return join4(targetDir, ".skills", "schedules.json");
+}
+function loadSchedules(targetDir = process.cwd()) {
+  const path = getSchedulesPath(targetDir);
+  if (existsSync4(path)) {
+    try {
+      return JSON.parse(readFileSync4(path, "utf-8"));
+    } catch {}
+  }
+  return { version: 1, schedules: [] };
+}
+function saveSchedules(data, targetDir = process.cwd()) {
+  const path = getSchedulesPath(targetDir);
+  const dir = join4(targetDir, ".skills");
+  if (!existsSync4(dir))
+    mkdirSync2(dir, { recursive: true });
+  writeFileSync2(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: error48 } = validateCron(cron);
+  if (!valid)
+    return { schedule: null, error: error48 };
+  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;
+}
+
 // src/mcp/index.ts
 var server = new McpServer({
   name: "skills",
@@ -30710,7 +31027,7 @@ server.registerTool("list_skills", {
     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;
@@ -30795,7 +31112,7 @@ server.registerTool("get_skill_docs", {
 });
 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(),
@@ -30807,7 +31124,7 @@ server.registerTool("install_skill", {
     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 {
@@ -30845,7 +31162,7 @@ server.registerTool("install_category", {
     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) {
@@ -30879,7 +31196,7 @@ server.registerTool("remove_skill", {
     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,
@@ -30912,7 +31229,7 @@ server.registerTool("list_tags", {
   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);
     }
@@ -30986,7 +31303,7 @@ server.registerTool("import_skills", {
     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));
@@ -31014,21 +31331,20 @@ server.registerTool("whoami", {
   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 = join3(homedir2(), `.${agent}`, "skills");
-    const exists = existsSync3(agentSkillsPath);
+  for (const agent of AGENT_TARGETS) {
+    const agentSkillsPath = getAgentSkillsDir(agent, "global");
+    const exists = existsSync5(agentSkillsPath);
     let skillCount = 0;
     if (exists) {
       try {
-        skillCount = readdirSync3(agentSkillsPath).filter((f) => {
-          const full = join3(agentSkillsPath, f);
+        skillCount = readdirSync4(agentSkillsPath).filter((f) => {
+          const full = join5(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 = {
@@ -31041,12 +31357,107 @@ server.registerTool("whoami", {
   };
   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 (!existsSync5(skillPath)) {
+    return {
+      content: [{ type: "text", text: JSON.stringify({ name, valid: false, issues: [`Skill directory not found: ${skillPath}`] }) }]
+    };
+  }
+  if (!existsSync5(join5(skillPath, "SKILL.md")))
+    issues.push("Missing SKILL.md");
+  if (!existsSync5(join5(skillPath, "tsconfig.json")))
+    issues.push("Missing tsconfig.json");
+  const pkgPath = join5(skillPath, "package.json");
+  if (!existsSync5(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 = join5(skillPath, "src");
+  if (!existsSync5(srcDir)) {
+    issues.push("Missing src/ directory");
+  } else if (!existsSync5(join5(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"
   }]
 }));