@skillkit/cli 1.7.9 → 1.7.10

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@skillkit/cli.svg)](https://www.npmjs.com/package/@skillkit/cli)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 17 AI coding agents.
+**Command-line interface for SkillKit** - install, manage, translate, and sync skills across 32 AI coding agents.
 
 ## Installation
 
@@ -243,7 +243,7 @@ const recs = await recommendCommand({
 | Gemini CLI | SKILL.md |
 | Windsurf | Markdown |
 | GitHub Copilot | Markdown |
-| + 11 more | SKILL.md |
+| + 26 more | SKILL.md |
 
 ## Documentation
 

package/dist/index.d.ts

@@ -821,6 +821,25 @@ declare class ManifestGenerateCommand extends Command {
     execute(): Promise<number>;
 }
 
+declare class PrimerCommand extends Command {
+    static paths: string[][];
+    static usage: clipanion.Usage;
+    agent: string | undefined;
+    allAgents: boolean;
+    output: string | undefined;
+    dryRun: boolean;
+    analyzeOnly: boolean;
+    verbose: boolean;
+    includeExamples: boolean;
+    json: boolean;
+    directory: string | undefined;
+    execute(): Promise<number>;
+    private runAnalysis;
+    private runGenerate;
+    private parseAgents;
+    private printAnalysis;
+}
+
 declare const loadSkillMetadata: typeof loadSkillMetadata$1;
 declare const saveSkillMetadata: typeof saveSkillMetadata$1;
 declare function getSearchDirs(agentType?: AgentType): string[];
@@ -828,4 +847,4 @@ declare function getInstallDir(global?: boolean, agentType?: AgentType): string;
 declare function getAgentConfigPath(agentType?: AgentType): string;
 declare function initProject(agentType?: AgentType): Promise<void>;
 
-export { AICommand, AgentCommand, AgentCreateCommand, AgentListCommand, AgentShowCommand, AgentSyncCommand, AgentTranslateCommand, AgentValidateCommand, AuditCommand, CICDCommand, CheckCommand, CommandCmd, ContextCommand, CreateCommand, DisableCommand, EnableCommand, FindCommand, FixCommand, HookCommand, InitCommand, InstallCommand, ListCommand, ManifestAddCommand, ManifestCommand, ManifestGenerateCommand, ManifestInitCommand, ManifestInstallCommand, ManifestRemoveCommand, MarketplaceCommand, MemoryCommand, MethodologyCommand, PauseCommand, PlanCommand, PluginCommand, PublishCommand, ReadCommand, RecommendCommand, RemoveCommand, ResumeCommand, RunCommand, SettingsCommand, StatusCommand, SyncCommand, TeamCommand, TestCommand, TranslateCommand, UICommand, UpdateCommand, ValidateCommand, WorkflowCreateCommand, WorkflowListCommand, WorkflowRunCommand, getAgentConfigPath, getInstallDir, getSearchDirs, initProject, loadSkillMetadata, saveSkillMetadata };
+export { AICommand, AgentCommand, AgentCreateCommand, AgentListCommand, AgentShowCommand, AgentSyncCommand, AgentTranslateCommand, AgentValidateCommand, AuditCommand, CICDCommand, CheckCommand, CommandCmd, ContextCommand, CreateCommand, DisableCommand, EnableCommand, FindCommand, FixCommand, HookCommand, InitCommand, InstallCommand, ListCommand, ManifestAddCommand, ManifestCommand, ManifestGenerateCommand, ManifestInitCommand, ManifestInstallCommand, ManifestRemoveCommand, MarketplaceCommand, MemoryCommand, MethodologyCommand, PauseCommand, PlanCommand, PluginCommand, PrimerCommand, PublishCommand, ReadCommand, RecommendCommand, RemoveCommand, ResumeCommand, RunCommand, SettingsCommand, StatusCommand, SyncCommand, TeamCommand, TestCommand, TranslateCommand, UICommand, UpdateCommand, ValidateCommand, WorkflowCreateCommand, WorkflowListCommand, WorkflowRunCommand, getAgentConfigPath, getInstallDir, getSearchDirs, initProject, loadSkillMetadata, saveSkillMetadata };

package/dist/index.js

@@ -711,7 +711,7 @@ var init_onboarding = __esm({
     init_summary();
     init_preferences();
     VERSION = "1.7.6";
-    AGENT_COUNT = 17;
+    AGENT_COUNT = 32;
   }
 });
 
@@ -2568,7 +2568,7 @@ var UICommand = class extends Command12 {
       
       Features:
       - Browse and discover skills from the marketplace
-      - Manage installed skills across 17+ AI coding agents
+      - Manage installed skills across 32 AI coding agents
       - Sync skills between agents
       - AI-powered recommendations
       - Team collaboration
@@ -5413,8 +5413,8 @@ ${learning.title}
       return 1;
     }
     const { existsSync: existsSync20, readFileSync: readFileSync10 } = await import("fs");
-    const { resolve: resolve18 } = await import("path");
-    const fullPath = resolve18(inputPath);
+    const { resolve: resolve19 } = await import("path");
+    const fullPath = resolve19(inputPath);
     if (!existsSync20(fullPath)) {
       console.error(chalk17.red(`File not found: ${fullPath}`));
       return 1;
@@ -135651,6 +135651,315 @@ var ManifestGenerateCommand = class extends Command40 {
   }
 };
 
+// src/commands/primer.ts
+import { Command as Command41, Option as Option40 } from "clipanion";
+import { resolve as resolve18 } from "path";
+import chalk28 from "chalk";
+import {
+  AgentType as AgentTypeSchema,
+  generatePrimer,
+  analyzePrimer,
+  AGENT_CONFIG
+} from "@skillkit/core";
+var PrimerCommand = class extends Command41 {
+  static paths = [["primer"]];
+  static usage = Command41.Usage({
+    description: "Analyze codebase and generate AI instruction files for agents",
+    details: `
+      The primer command analyzes your codebase to detect languages, frameworks,
+      patterns, and conventions, then generates customized instruction files
+      for AI coding agents.
+
+      By default, it generates instructions for detected agents in your project.
+      Use --all-agents to generate for all 32 supported agents.
+
+      Inspired by github.com/pierceboggan/primer but extended for all SkillKit agents.
+    `,
+    examples: [
+      ["Generate for detected agents", "$0 primer"],
+      ["Generate for all 32 agents", "$0 primer --all-agents"],
+      ["Generate for specific agents", "$0 primer --agent claude-code,cursor,github-copilot"],
+      ["Custom output directory", "$0 primer --output ./instructions"],
+      ["Preview without writing files", "$0 primer --dry-run"],
+      ["Only show analysis", "$0 primer --analyze-only"],
+      ["Verbose output", "$0 primer --verbose"]
+    ]
+  });
+  agent = Option40.String("--agent,-a", {
+    description: "Comma-separated list of agents to generate for"
+  });
+  allAgents = Option40.Boolean("--all-agents,-A", false, {
+    description: "Generate for all 32 supported agents"
+  });
+  output = Option40.String("--output,-o", {
+    description: "Output directory for generated files"
+  });
+  dryRun = Option40.Boolean("--dry-run,-n", false, {
+    description: "Preview what would be generated without writing files"
+  });
+  analyzeOnly = Option40.Boolean("--analyze-only", false, {
+    description: "Only show codebase analysis, do not generate files"
+  });
+  verbose = Option40.Boolean("--verbose,-v", false, {
+    description: "Show detailed output"
+  });
+  includeExamples = Option40.Boolean("--examples", false, {
+    description: "Include code examples in generated instructions"
+  });
+  json = Option40.Boolean("--json,-j", false, {
+    description: "Output analysis in JSON format"
+  });
+  directory = Option40.String("--dir,-d", {
+    description: "Project directory to analyze (default: current directory)"
+  });
+  async execute() {
+    const projectPath = resolve18(this.directory || process.cwd());
+    if (this.analyzeOnly) {
+      return this.runAnalysis(projectPath);
+    }
+    return this.runGenerate(projectPath);
+  }
+  async runAnalysis(projectPath) {
+    console.log(chalk28.cyan("Analyzing codebase...\n"));
+    try {
+      const analysis = analyzePrimer(projectPath);
+      if (this.json) {
+        console.log(JSON.stringify(analysis, null, 2));
+        return 0;
+      }
+      this.printAnalysis(analysis);
+      return 0;
+    } catch (error2) {
+      console.error(chalk28.red("Analysis failed:"), error2 instanceof Error ? error2.message : error2);
+      return 1;
+    }
+  }
+  async runGenerate(projectPath) {
+    const agents = this.parseAgents();
+    console.log(chalk28.cyan("Analyzing codebase and generating AI instructions...\n"));
+    try {
+      const result = generatePrimer(projectPath, {
+        agents,
+        allAgents: this.allAgents,
+        outputDir: this.output ? resolve18(this.output) : void 0,
+        dryRun: this.dryRun,
+        verbose: this.verbose,
+        includeExamples: this.includeExamples
+      });
+      if (this.verbose) {
+        this.printAnalysis(result.analysis);
+        console.log();
+      }
+      if (result.generated.length === 0) {
+        console.log(chalk28.yellow("No instruction files generated."));
+        if (result.errors.length > 0) {
+          for (const error2 of result.errors) {
+            console.log(chalk28.red(`  Error: ${error2}`));
+          }
+        }
+        return 1;
+      }
+      console.log(chalk28.bold("Generated Instruction Files:\n"));
+      for (const instruction of result.generated) {
+        const status = this.dryRun ? chalk28.yellow("(dry-run)") : chalk28.green("created");
+        console.log(`  ${chalk28.green("\u25CF")} ${chalk28.bold(instruction.agent)}`);
+        console.log(`    ${chalk28.gray(instruction.filepath)} ${status}`);
+      }
+      console.log();
+      if (result.warnings.length > 0) {
+        console.log(chalk28.yellow("Warnings:"));
+        for (const warning of result.warnings) {
+          console.log(`  ${chalk28.yellow("\u26A0")} ${warning}`);
+        }
+        console.log();
+      }
+      if (result.errors.length > 0) {
+        console.log(chalk28.red("Errors:"));
+        for (const error2 of result.errors) {
+          console.log(`  ${chalk28.red("\u2717")} ${error2}`);
+        }
+        console.log();
+      }
+      const summary = this.dryRun ? `Would generate ${result.generated.length} instruction file(s)` : `Generated ${result.generated.length} instruction file(s)`;
+      console.log(chalk28.bold(summary));
+      if (this.dryRun) {
+        console.log(chalk28.gray("\n(Dry run - no files were written)"));
+      }
+      return result.success ? 0 : 1;
+    } catch (error2) {
+      console.error(chalk28.red("Generation failed:"), error2 instanceof Error ? error2.message : error2);
+      return 1;
+    }
+  }
+  parseAgents() {
+    if (!this.agent) return void 0;
+    const agents = [];
+    const parts = this.agent.split(",").map((s) => s.trim());
+    for (const part of parts) {
+      const result = AgentTypeSchema.safeParse(part);
+      if (result.success) {
+        agents.push(result.data);
+      } else {
+        console.warn(chalk28.yellow(`Unknown agent: ${part}`));
+      }
+    }
+    return agents.length > 0 ? agents : void 0;
+  }
+  printAnalysis(analysis) {
+    const { project, languages, packageManagers, stack, structure, conventions, ci, docker, buildCommands, importantFiles } = analysis;
+    console.log(chalk28.bold("Project Information"));
+    console.log(`  Name: ${chalk28.cyan(project.name)}`);
+    if (project.description) {
+      console.log(`  Description: ${project.description}`);
+    }
+    if (project.type) {
+      console.log(`  Type: ${project.type}`);
+    }
+    if (project.version) {
+      console.log(`  Version: ${project.version}`);
+    }
+    console.log();
+    if (languages.length > 0) {
+      console.log(chalk28.bold("Languages"));
+      for (const lang of languages) {
+        const version = lang.version ? ` (${lang.version})` : "";
+        console.log(`  ${chalk28.green("\u25CF")} ${lang.name}${version}`);
+      }
+      console.log();
+    }
+    if (packageManagers.length > 0) {
+      console.log(chalk28.bold("Package Managers"));
+      console.log(`  ${chalk28.cyan(packageManagers.join(", "))}`);
+      console.log();
+    }
+    if (stack.frameworks.length > 0) {
+      console.log(chalk28.bold("Frameworks"));
+      for (const fw of stack.frameworks) {
+        const version = fw.version ? ` (${fw.version})` : "";
+        console.log(`  ${chalk28.green("\u25CF")} ${fw.name}${version}`);
+      }
+      console.log();
+    }
+    if (stack.libraries.length > 0) {
+      console.log(chalk28.bold("Libraries"));
+      for (const lib of stack.libraries.slice(0, 10)) {
+        const version = lib.version ? ` (${lib.version})` : "";
+        console.log(`  ${chalk28.green("\u25CF")} ${lib.name}${version}`);
+      }
+      if (stack.libraries.length > 10) {
+        console.log(`  ${chalk28.gray(`...and ${stack.libraries.length - 10} more`)}`);
+      }
+      console.log();
+    }
+    if (stack.styling.length > 0) {
+      console.log(chalk28.bold("Styling"));
+      for (const style of stack.styling) {
+        console.log(`  ${chalk28.green("\u25CF")} ${style.name}`);
+      }
+      console.log();
+    }
+    if (stack.testing.length > 0) {
+      console.log(chalk28.bold("Testing"));
+      for (const test of stack.testing) {
+        console.log(`  ${chalk28.green("\u25CF")} ${test.name}`);
+      }
+      console.log();
+    }
+    if (stack.databases.length > 0) {
+      console.log(chalk28.bold("Databases"));
+      for (const db of stack.databases) {
+        console.log(`  ${chalk28.green("\u25CF")} ${db.name}`);
+      }
+      console.log();
+    }
+    if (structure) {
+      console.log(chalk28.bold("Project Structure"));
+      if (structure.type) {
+        console.log(`  Type: ${structure.type}`);
+      }
+      if (structure.srcDir) {
+        console.log(`  Source: ${structure.srcDir}/`);
+      }
+      if (structure.testDir) {
+        console.log(`  Tests: ${structure.testDir}/`);
+      }
+      if (structure.hasWorkspaces) {
+        console.log(`  Monorepo: Yes`);
+        if (structure.workspaces) {
+          console.log(`  Workspaces: ${structure.workspaces.join(", ")}`);
+        }
+      }
+      console.log();
+    }
+    if (conventions && Object.keys(conventions).some((k) => conventions[k] !== void 0)) {
+      console.log(chalk28.bold("Code Conventions"));
+      if (conventions.indentation) {
+        console.log(`  Indentation: ${conventions.indentation}`);
+      }
+      if (conventions.quotes) {
+        console.log(`  Quotes: ${conventions.quotes}`);
+      }
+      if (conventions.semicolons !== void 0) {
+        console.log(`  Semicolons: ${conventions.semicolons ? "yes" : "no"}`);
+      }
+      if (conventions.trailingCommas) {
+        console.log(`  Trailing Commas: ${conventions.trailingCommas}`);
+      }
+      console.log();
+    }
+    if (ci && ci.hasCI) {
+      console.log(chalk28.bold("CI/CD"));
+      console.log(`  Provider: ${ci.provider}`);
+      if (ci.hasCD) {
+        console.log(`  Deployment: Yes`);
+      }
+      console.log();
+    }
+    if (docker && (docker.hasDockerfile || docker.hasCompose)) {
+      console.log(chalk28.bold("Docker"));
+      if (docker.hasDockerfile) {
+        console.log(`  Dockerfile: Yes`);
+        if (docker.baseImage) {
+          console.log(`  Base Image: ${docker.baseImage}`);
+        }
+      }
+      if (docker.hasCompose) {
+        console.log(`  Docker Compose: Yes`);
+      }
+      console.log();
+    }
+    if (buildCommands && Object.keys(buildCommands).some((k) => buildCommands[k])) {
+      console.log(chalk28.bold("Build Commands"));
+      if (buildCommands.install) {
+        console.log(`  Install: ${chalk28.gray(buildCommands.install)}`);
+      }
+      if (buildCommands.dev) {
+        console.log(`  Dev: ${chalk28.gray(buildCommands.dev)}`);
+      }
+      if (buildCommands.build) {
+        console.log(`  Build: ${chalk28.gray(buildCommands.build)}`);
+      }
+      if (buildCommands.test) {
+        console.log(`  Test: ${chalk28.gray(buildCommands.test)}`);
+      }
+      console.log();
+    }
+    if (importantFiles.length > 0 && this.verbose) {
+      console.log(chalk28.bold("Important Files"));
+      for (const file of importantFiles.slice(0, 15)) {
+        console.log(`  ${chalk28.gray(file)}`);
+      }
+      if (importantFiles.length > 15) {
+        console.log(`  ${chalk28.gray(`...and ${importantFiles.length - 15} more`)}`);
+      }
+      console.log();
+    }
+    console.log(chalk28.bold("Available Agents"));
+    console.log(chalk28.gray(`  Use --all-agents to generate for all ${Object.keys(AGENT_CONFIG).length} agents`));
+    console.log(chalk28.gray(`  Use --agent <name> to generate for specific agents`));
+  }
+};
+
 // src/index.ts
 init_helpers();
 export {
@@ -135688,6 +135997,7 @@ export {
   PauseCommand,
   PlanCommand,
   PluginCommand,
+  PrimerCommand,
   PublishCommand,
   ReadCommand,
   RecommendCommand,