@hasnatools/skills 0.1.23 → 0.1.24

package/dist/index.js

@@ -23425,10 +23425,316 @@ async function doctorCommand() {
   console.log();
 }
 
+// src/commands/setup.ts
+var import_prompts4 = __toESM(require_prompts3(), 1);
+import { writeFileSync as writeFileSync7 } from "fs";
+import { join as join10 } from "path";
+var SKILLS_MD_MARKER2 = "<!-- skills.md:managed -->";
+async function getAIRecommendations(prompt, availableSkills) {
+  const apiKey = getApiKey();
+  const endpoint = getApiEndpoint();
+  const skillsContext = availableSkills.map((s) => ({
+    slug: s.slug,
+    name: s.name,
+    description: s.description,
+    category: s.category?.name || "Uncategorized",
+    isFree: !s.creditsPerExecution || s.creditsPerExecution === 0,
+    credits: s.creditsPerExecution || 0
+  }));
+  try {
+    const response = await fetch(`${endpoint}/ai/recommend-skills`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...apiKey ? { Authorization: `Bearer ${apiKey}` } : {}
+      },
+      body: JSON.stringify({
+        prompt,
+        skills: skillsContext
+      })
+    });
+    if (!response.ok) {
+      return null;
+    }
+    const data = await response.json();
+    return data;
+  } catch {
+    return null;
+  }
+}
+function getKeywordRecommendations(prompt, availableSkills) {
+  const keywords = prompt.toLowerCase();
+  const recommendations = [];
+  const categoryMappings = {
+    saas: ["generate-api-client", "api-documentation", "generate-readme", "ci-cd-pipeline", "docker-helper", "generate-env", "security-audit", "test-generator"],
+    frontend: ["generate-image", "generate-favicon", "color-palette-harmonizer", "generate-chart", "generate-diagram"],
+    backend: ["generate-api-client", "api-documentation", "docker-helper", "generate-dockerfile", "generate-env", "validate-config"],
+    mobile: ["generate-image", "generate-favicon", "generate-qrcode", "deep-research"],
+    data: ["analyze-data", "generate-chart", "generate-excel", "convert-data", "dataset-health-check"],
+    content: ["create-blog-article", "generate-image", "generate-audio", "generate-video", "generate-presentation"],
+    documentation: ["generate-readme", "generate-documentation", "api-documentation", "architecture-docs", "changelog-generator"],
+    testing: ["test-generator", "e2e-test-generator", "api-test-suite", "find-bug", "snapshot-testing"],
+    devops: ["ci-cd-pipeline", "docker-helper", "generate-dockerfile", "terraform-generator", "kubernetes-manifests"],
+    security: ["security-audit", "secrets-scanner", "sql-injection-scanner", "dependency-checker"],
+    marketing: ["generate-image", "email-campaign", "social-media-kit", "seo-brief-builder", "landing-page-copy"],
+    startup: ["generate-readme", "generate-pitch-deck", "persona-generator", "customer-journey-mapper", "generate-invoice"]
+  };
+  const matchedSlugs = new Set;
+  for (const [category, slugs] of Object.entries(categoryMappings)) {
+    if (keywords.includes(category)) {
+      slugs.forEach((slug) => matchedSlugs.add(slug));
+    }
+  }
+  if (matchedSlugs.size === 0) {
+    ["generate-readme", "generate-documentation", "find-bug", "code-review", "generate-diagram"].forEach((s) => matchedSlugs.add(s));
+  }
+  for (const slug of matchedSlugs) {
+    const skill = availableSkills.find((s) => s.slug === slug);
+    if (skill) {
+      recommendations.push({
+        slug: skill.slug,
+        name: skill.name,
+        reason: `Useful for ${skill.category?.name || "development"} workflows`,
+        priority: recommendations.length < 5 ? "essential" : "recommended",
+        creditsPerExecution: skill.creditsPerExecution || 0
+      });
+    }
+  }
+  const paidSkills = availableSkills.filter((s) => s.creditsPerExecution && s.creditsPerExecution > 0);
+  for (const skill of paidSkills.slice(0, 3)) {
+    if (!matchedSlugs.has(skill.slug)) {
+      recommendations.push({
+        slug: skill.slug,
+        name: skill.name,
+        reason: "Premium skill with advanced capabilities",
+        priority: "optional",
+        creditsPerExecution: skill.creditsPerExecution || 0
+      });
+    }
+  }
+  return {
+    skills: recommendations.slice(0, 15),
+    summary: `Based on your project needs, I've selected ${recommendations.length} skills that would be helpful.`
+  };
+}
+function displayRecommendations(recommendations) {
+  console.log();
+  console.log(colors.primary(recommendations.summary));
+  console.log();
+  const essential = recommendations.skills.filter((s) => s.priority === "essential");
+  const recommended = recommendations.skills.filter((s) => s.priority === "recommended");
+  const optional = recommendations.skills.filter((s) => s.priority === "optional");
+  if (essential.length > 0) {
+    console.log(colors.successBold("Essential Skills"));
+    console.log(colors.dim("─".repeat(50)));
+    essential.forEach((s, i) => {
+      const priceTag = s.creditsPerExecution > 0 ? colors.warning(` [${s.creditsPerExecution} credits]`) : colors.success(" [Free]");
+      console.log(`  ${colors.success(String(i + 1).padStart(2, " "))}. ${skillName(s.name)}${priceTag}`);
+      console.log(`      ${colors.dim(s.reason)}`);
+    });
+    console.log();
+  }
+  if (recommended.length > 0) {
+    console.log(colors.primaryBold("Recommended Skills"));
+    console.log(colors.dim("─".repeat(50)));
+    recommended.forEach((s, i) => {
+      const priceTag = s.creditsPerExecution > 0 ? colors.warning(` [${s.creditsPerExecution} credits]`) : colors.success(" [Free]");
+      console.log(`  ${colors.primary(String(essential.length + i + 1).padStart(2, " "))}. ${skillName(s.name)}${priceTag}`);
+      console.log(`      ${colors.dim(s.reason)}`);
+    });
+    console.log();
+  }
+  if (optional.length > 0) {
+    console.log(colors.dim("Optional Premium Skills"));
+    console.log(colors.dim("─".repeat(50)));
+    optional.forEach((s, i) => {
+      const priceTag = s.creditsPerExecution > 0 ? colors.warning(` [${s.creditsPerExecution} credits]`) : colors.success(" [Free]");
+      console.log(`  ${colors.dim(String(essential.length + recommended.length + i + 1).padStart(2, " "))}. ${skillName(s.name)}${priceTag}`);
+      console.log(`      ${colors.dim(s.reason)}`);
+    });
+    console.log();
+  }
+}
+function addSkillsMdMarker2(content) {
+  return `${content.trim()}
+
+${SKILLS_MD_MARKER2}
+`;
+}
+async function setupCommand(promptArg, options = {}) {
+  const isLocal = options.local ?? false;
+  const target = options.target ?? getDefaultTarget();
+  const apiKey = getApiKey();
+  banner("AI-Powered Skill Setup");
+  let installDir;
+  if (isLocal) {
+    if (!hasLocalConfig()) {
+      console.log(colors.warning("Not in a skills.md project"));
+      console.log(colors.dim("Run `skills init` first or use global installation"));
+      return;
+    }
+    installDir = target === "claude" ? getProjectClaudeSkillsDir() : getProjectCodexSkillsDir();
+  } else {
+    installDir = target === "claude" ? getClaudeSkillsDir() : getCodexSkillsDir();
+  }
+  console.log(keyValue("Target", colors.primaryBold(target)));
+  console.log(keyValue("Scope", colors.primaryBold(isLocal ? "project" : "global")));
+  console.log(keyValue("Directory", path6(installDir)));
+  console.log();
+  let projectPrompt = promptArg;
+  if (!projectPrompt) {
+    console.log(colors.dim("Describe your project and I'll recommend the best skills to install."));
+    console.log(colors.dim("Examples: 'SaaS application', 'Mobile app backend', 'Data analysis project'"));
+    console.log();
+    const response = await import_prompts4.default({
+      type: "text",
+      name: "prompt",
+      message: "What are you building?",
+      validate: (value) => value.length > 0 ? true : "Please describe your project"
+    });
+    if (!response.prompt) {
+      console.log(colors.dim("Setup cancelled"));
+      return;
+    }
+    projectPrompt = response.prompt;
+  }
+  const fetchSpinner = ora({
+    text: "Fetching available skills...",
+    color: "magenta"
+  }).start();
+  const skillsResult = await getAllMarketplaceSkills();
+  if (skillsResult.error || !skillsResult.data) {
+    fetchSpinner.fail(colors.error("Failed to fetch skills"));
+    console.error(colors.error(skillsResult.error || "Could not fetch skill catalog"));
+    return;
+  }
+  const availableSkills = skillsResult.data.skills;
+  fetchSpinner.succeed(colors.success(`Found ${count(availableSkills.length)} available skills`));
+  const aiSpinner = ora({
+    text: "Analyzing your project needs...",
+    color: "magenta"
+  }).start();
+  let recommendations = await getAIRecommendations(projectPrompt, availableSkills);
+  if (!recommendations) {
+    aiSpinner.text = "Using smart matching...";
+    recommendations = getKeywordRecommendations(projectPrompt, availableSkills);
+  }
+  aiSpinner.succeed(colors.success(`Selected ${count(recommendations.skills.length)} skills for your project`));
+  displayRecommendations(recommendations);
+  const freeSkills = recommendations.skills.filter((s) => s.creditsPerExecution === 0);
+  const paidSkills = recommendations.skills.filter((s) => s.creditsPerExecution > 0);
+  const totalCredits = paidSkills.reduce((sum, s) => sum + s.creditsPerExecution, 0);
+  console.log(colors.dim("─".repeat(50)));
+  console.log(keyValue("Free skills", colors.success(String(freeSkills.length))));
+  console.log(keyValue("Paid skills", colors.warning(String(paidSkills.length))));
+  if (totalCredits > 0) {
+    console.log(keyValue("Credits per full run", colors.warning(`${totalCredits} credits`)));
+  }
+  console.log();
+  const { installChoice } = await import_prompts4.default({
+    type: "select",
+    name: "installChoice",
+    message: "What would you like to install?",
+    choices: [
+      { title: `All ${recommendations.skills.length} recommended skills`, value: "all" },
+      { title: `Only free skills (${freeSkills.length})`, value: "free" },
+      { title: "Let me choose", value: "choose" },
+      { title: "Cancel", value: "cancel" }
+    ]
+  });
+  if (installChoice === "cancel" || !installChoice) {
+    console.log(colors.dim("Setup cancelled"));
+    return;
+  }
+  let skillsToInstall = [];
+  if (installChoice === "all") {
+    skillsToInstall = recommendations.skills;
+  } else if (installChoice === "free") {
+    skillsToInstall = freeSkills;
+  } else if (installChoice === "choose") {
+    const { selected } = await import_prompts4.default({
+      type: "multiselect",
+      name: "selected",
+      message: "Select skills to install",
+      choices: recommendations.skills.map((s) => ({
+        title: `${s.name}${s.creditsPerExecution > 0 ? ` [${s.creditsPerExecution} credits]` : " [Free]"}`,
+        value: s.slug,
+        selected: s.priority === "essential"
+      })),
+      hint: "- Space to select. Enter to confirm"
+    });
+    if (!selected || selected.length === 0) {
+      console.log(colors.dim("No skills selected"));
+      return;
+    }
+    skillsToInstall = recommendations.skills.filter((s) => selected.includes(s.slug));
+  }
+  if (skillsToInstall.length === 0) {
+    console.log(colors.dim("No skills to install"));
+    return;
+  }
+  console.log();
+  banner("Installing Skills");
+  const total = skillsToInstall.length;
+  const results = {
+    success: [],
+    failed: []
+  };
+  for (let i = 0;i < skillsToInstall.length; i++) {
+    const skill = skillsToInstall[i];
+    const current = i + 1;
+    const percent = Math.round(current / total * 100);
+    const padWidth = String(total).length;
+    const progress = `[${String(current).padStart(padWidth, " ")}/${total}]`;
+    process.stdout.write(`\r${colors.dim(progress)} ${progressBar(percent)} ${colors.dim(`${percent}%`)} Installing ${colors.primary(skill.name)}...`);
+    process.stdout.write("\x1B[K");
+    try {
+      const skillResult = await installSkill(skill.slug);
+      if (skillResult.error || !skillResult.data) {
+        results.failed.push({ slug: skill.slug, error: skillResult.error || "Not found" });
+        continue;
+      }
+      const skillData = skillResult.data;
+      const skillDir = join10(installDir, `skill-${skill.slug}`);
+      const exportsDir = join10(skillDir, "exports");
+      const logsDir = join10(skillDir, "logs");
+      ensureSkillsDir(skillDir);
+      ensureSkillsDir(exportsDir);
+      ensureSkillsDir(logsDir);
+      writeFileSync7(join10(skillDir, "SKILL.md"), addSkillsMdMarker2(skillData.skillMdContent));
+      if (apiKey) {
+        try {
+          await installSkillRemote(skill.slug);
+        } catch {}
+      }
+      results.success.push(skill.slug);
+    } catch (error) {
+      results.failed.push({
+        slug: skill.slug,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+    }
+  }
+  process.stdout.write("\r\x1B[K");
+  completionBanner("Setup Complete");
+  if (results.success.length > 0) {
+    console.log(successItem(`Installed: ${colors.successBold(String(results.success.length))} skills`));
+  }
+  if (results.failed.length > 0) {
+    console.log(errorItem(`Failed: ${colors.errorBold(String(results.failed.length))} skills`));
+  }
+  console.log();
+  console.log(colors.dim("Your skills are ready! Run any skill with:"));
+  console.log(`  ${command('skills run <skill-name> -- "your prompt"')}`);
+  console.log();
+  console.log(colors.dim("View installed skills:"));
+  console.log(`  ${command("skills list")}`);
+}
+
 // src/index.ts
 var indigo12 = colors.primary;
 var program2 = new Command;
-program2.name("skills").description("CLI for skills.md - AI Agent Skills Marketplace").version("0.1.23");
+program2.name("skills").description("CLI for skills.md - AI Agent Skills Marketplace").version("0.1.24");
 program2.command("init").description("Initialize skills.md in current project").option("-f, --force", "Force re-initialization (removes existing .skills/)").action((options) => {
   initCommand({ force: options.force });
 });
@@ -23460,6 +23766,9 @@ program2.command("uninstall [name]").alias("remove").description("Uninstall skil
     force: options.force
   });
 });
+program2.command("setup [prompt]").description("AI-powered skill setup wizard - recommends skills based on your project").option("-l, --local", "Install to current project instead of global").option("-t, --target <target>", "Target platform (claude, codex)").action((prompt, options) => {
+  setupCommand(prompt, { local: options.local, target: options.target });
+});
 program2.command("download <name>").alias("dl").description("Download a skill with full source code (if available)").option("-l, --local", "Download to current project instead of global").option("-t, --target <target>", "Target platform (claude, codex)").action((name, options) => {
   downloadCommand(name, {
     local: options.local,
@@ -23550,6 +23859,10 @@ ${indigo12.bold("Examples:")}
   ${source_default.dim("# Install globally for Claude Code")}
   $ skills install code-review -g -t claude
 
+  ${source_default.dim("# AI-powered setup wizard")}
+  $ skills setup
+  $ skills setup "SaaS application with API"
+
   ${source_default.dim("# List installed skills")}
   $ skills list
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasnatools/skills",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "CLI for skills.md - AI Agent Skills Marketplace",
   "type": "module",
   "bin": {