skillpack 0.1.0

package/README.md

@@ -0,0 +1,114 @@
+# skillpack
+
+A package manager for [skills.sh](https://skills.sh) that reads from a `skillpack.yaml` file and batch-installs skills to AI agents.
+
+## Installation
+
+```bash
+npm install -g skillpack
+```
+
+Or run directly with npx:
+
+```bash
+npx skillpack install
+```
+
+## Quick Start
+
+1. Create a `skillpack.yaml` in your project:
+
+```bash
+skillpack init
+```
+
+2. Edit the file to add your skills:
+
+```yaml
+agents:
+  - claude-code
+  - cursor
+
+skills:
+  vercel-labs/agent-skills:
+    - vercel-react-best-practices
+    - web-design-guidelines
+```
+
+3. Install all skills:
+
+```bash
+skillpack install
+```
+
+## Configuration
+
+### skillpack.yaml
+
+```yaml
+# Target agents to install skills to
+agents:
+  - claude-code
+  - cursor
+
+# Skills to install (owner/repo format)
+skills:
+  # Install specific skills from a repo
+  vercel-labs/agent-skills:
+    - vercel-react-best-practices
+    - web-design-guidelines
+
+  # Install all skills from a repo
+  another-org/repo: all
+
+  # Pin to a specific git ref (tag, branch, or commit)
+  pinned-org/skill-repo:
+    ref: v1.0.0
+    skills:
+      - specific-skill
+```
+
+### Lockfile
+
+Running `skillpack install` creates a `skillpack-lock.yaml` file that tracks installed versions. Commit this file to ensure reproducible installs across your team.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `skillpack install` | Install all skills from skillpack.yaml |
+| `skillpack init` | Create a skillpack.yaml template |
+
+### Flags
+
+```bash
+--dry-run       # Show what would be installed without installing
+--force         # Reinstall even if already present
+--verbose       # Detailed output
+--config <path> # Custom config file path
+--no-lock       # Ignore lockfile and install latest
+```
+
+## Examples
+
+Preview what will be installed:
+
+```bash
+skillpack install --dry-run
+```
+
+Force reinstall all skills:
+
+```bash
+skillpack install --force
+```
+
+Use a custom config file:
+
+```bash
+skillpack install --config ./configs/skills.yaml
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { installCommand } from "./commands/install.js";
+import { initCommand } from "./commands/init.js";
+const program = new Command();
+program
+    .name("skillpack")
+    .description("Package manager for skills.sh - batch install skills to AI agents")
+    .version("0.1.0");
+program
+    .command("install")
+    .description("Install all skills from skillpack.yaml")
+    .option("--dry-run", "Show what would be installed without installing", false)
+    .option("--force", "Reinstall even if already present", false)
+    .option("--verbose", "Detailed output", false)
+    .option("--config <path>", "Custom config file path")
+    .option("--no-lock", "Ignore lockfile and install latest")
+    .action(async (opts) => {
+    const options = {
+        dryRun: opts.dryRun,
+        force: opts.force,
+        verbose: opts.verbose,
+        config: opts.config,
+        noLock: !opts.lock, // commander converts --no-lock to lock: false
+    };
+    await installCommand(options);
+});
+program
+    .command("init")
+    .description("Create a skillpack.yaml template")
+    .option("--force", "Overwrite existing skillpack.yaml", false)
+    .action(async (opts) => {
+    const options = {
+        force: opts.force,
+    };
+    await initCommand(options);
+});
+// Default to install if no command specified
+program.action(async () => {
+    // Show help if no arguments
+    program.help();
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,mEAAmE,CAAC;KAChF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,wCAAwC,CAAC;KACrD,MAAM,CAAC,WAAW,EAAE,iDAAiD,EAAE,KAAK,CAAC;KAC7E,MAAM,CAAC,SAAS,EAAE,mCAAmC,EAAE,KAAK,CAAC;KAC7D,MAAM,CAAC,WAAW,EAAE,iBAAiB,EAAE,KAAK,CAAC;KAC7C,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;KACpD,MAAM,CAAC,WAAW,EAAE,oCAAoC,CAAC;KACzD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,OAAO,GAAmB;QAC9B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,8CAA8C;KACnE,CAAC;IACF,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kCAAkC,CAAC;KAC/C,MAAM,CAAC,SAAS,EAAE,mCAAmC,EAAE,KAAK,CAAC;KAC7D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,OAAO,GAAgB;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;IACF,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEL,6CAA6C;AAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IACxB,4BAA4B;IAC5B,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { InitOptions } from "../lib/types.js";
+export declare function initCommand(options: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AASnD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBrE"}

package/dist/commands/init.js

@@ -0,0 +1,57 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+import { logger } from "../utils/logger.js";
+const CONFIG_FILENAME = "skillpack.yaml";
+// Get template path relative to this file
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_PATH = join(__dirname, "../../templates/skillpack.yaml");
+export async function initCommand(options) {
+    const targetPath = join(process.cwd(), CONFIG_FILENAME);
+    // Check if file already exists
+    if (existsSync(targetPath) && !options.force) {
+        logger.warn(`${CONFIG_FILENAME} already exists. Use --force to overwrite.`);
+        process.exit(1);
+    }
+    // Read template and write to cwd
+    let template;
+    try {
+        template = await readFile(TEMPLATE_PATH, "utf-8");
+    }
+    catch {
+        // Fallback to inline template if file not found (e.g., during development)
+        template = getDefaultTemplate();
+    }
+    await writeFile(targetPath, template, "utf-8");
+    logger.success(`Created ${CONFIG_FILENAME}`);
+    logger.info("Edit the file to add your skills, then run: skillpack install");
+}
+function getDefaultTemplate() {
+    return `# skillpack.yaml - Package manager for skills.sh
+# Run \`skillpack install\` to install all skills below
+
+# Target agents to install skills to
+agents:
+  - claude-code
+  # - cursor
+
+# Skills to install (owner/repo format)
+skills:
+  # Install specific skills from a repo
+  vercel-labs/agent-skills:
+    - vercel-react-best-practices
+    - web-design-guidelines
+
+  # Install all skills from a repo
+  # another-org/repo: all
+
+  # Pin to a specific git ref (tag, branch, or commit)
+  # pinned-org/skill-repo:
+  #   ref: v1.0.0
+  #   skills:
+  #     - specific-skill
+`;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEzC,0CAA0C;AAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAoB;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IAExD,+BAA+B;IAC/B,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,4CAA4C,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,iCAAiC;IACjC,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,CAAC,WAAW,eAAe,EAAE,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBR,CAAC;AACF,CAAC"}

package/dist/commands/install.d.ts

@@ -0,0 +1,3 @@
+import type { InstallOptions } from "../lib/types.js";
+export declare function installCommand(options: InstallOptions): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,iBAAiB,CAAC;AAG/E,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2H3E"}

package/dist/commands/install.js

@@ -0,0 +1,108 @@
+import { findConfigPath, loadConfig, parseSkillsToInstall } from "../lib/config.js";
+import { getLockfilePath, readLockfile, createLockfile, updateLockfile, writeLockfile, isAlreadyInstalled, } from "../lib/lockfile.js";
+import { installSkillEntry, getRepoCommit } from "../lib/skills-cli.js";
+import { logger, createSpinner } from "../utils/logger.js";
+export async function installCommand(options) {
+    // 1. Find config file
+    const configPath = options.config || findConfigPath();
+    if (!configPath) {
+        logger.error("No skillpack.yaml found.");
+        logger.info("Run 'skillpack init' to create one.");
+        process.exit(1);
+    }
+    logger.debug(`Using config: ${configPath}`, options.verbose);
+    // 2. Parse and validate config
+    let config;
+    try {
+        config = await loadConfig(configPath);
+    }
+    catch (err) {
+        logger.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+    const skillsToInstall = parseSkillsToInstall(config);
+    if (skillsToInstall.length === 0) {
+        logger.warn("No skills defined in skillpack.yaml");
+        return;
+    }
+    logger.info(`Found ${skillsToInstall.length} skill source(s) for agents: ${config.agents.join(", ")}`);
+    // 3. Load lockfile (unless --no-lock)
+    const lockfilePath = getLockfilePath(configPath);
+    let lockfile = null;
+    if (!options.noLock) {
+        lockfile = await readLockfile(lockfilePath);
+        if (lockfile) {
+            logger.debug("Using existing lockfile", options.verbose);
+        }
+    }
+    // 4. Install each skill
+    const allResults = [];
+    let newLockfile = lockfile || createLockfile();
+    for (const skill of skillsToInstall) {
+        // Check if already installed (unless --force)
+        if (!options.force &&
+            isAlreadyInstalled(lockfile, skill.repo, skill.skills, skill.agents)) {
+            const skillNames = skill.skills === "all" ? "all skills" : skill.skills.join(", ");
+            logger.info(`Skipping ${skill.repo} (${skillNames}) - already installed`);
+            allResults.push({
+                repo: skill.repo,
+                skill: skillNames,
+                status: "skipped",
+                message: "already in lockfile",
+            });
+            continue;
+        }
+        const skillNames = skill.skills === "all" ? "all skills" : skill.skills.join(", ");
+        const spinner = createSpinner(`Installing ${skill.repo} (${skillNames})`);
+        if (!options.dryRun) {
+            spinner.start();
+        }
+        const results = await installSkillEntry(skill, {
+            dryRun: options.dryRun,
+            verbose: options.verbose,
+        });
+        allResults.push(...results);
+        // Update spinner based on results
+        const failed = results.filter((r) => r.status === "failed");
+        const installed = results.filter((r) => r.status === "installed");
+        if (!options.dryRun) {
+            if (failed.length > 0) {
+                spinner.fail(`Failed: ${skill.repo}`);
+                for (const f of failed) {
+                    logger.error(`  ${f.skill}: ${f.message}`);
+                }
+            }
+            else if (installed.length > 0) {
+                spinner.succeed(`Installed ${skill.repo}`);
+            }
+            else {
+                spinner.info(`Skipped ${skill.repo}`);
+            }
+        }
+        // Update lockfile with successful installations
+        if (!options.dryRun && installed.length > 0) {
+            const commit = await getRepoCommit(skill.repo);
+            newLockfile = updateLockfile(newLockfile, skill.repo, {
+                commit,
+                skills: skill.skills === "all" ? [] : skill.skills,
+                agents: skill.agents,
+                installedAt: new Date().toISOString(),
+            });
+        }
+    }
+    // 5. Write updated lockfile
+    if (!options.dryRun && !options.noLock) {
+        await writeLockfile(lockfilePath, newLockfile);
+        logger.debug(`Updated ${lockfilePath}`, options.verbose);
+    }
+    // 6. Print summary
+    const installed = allResults.filter((r) => r.status === "installed").length;
+    const skipped = allResults.filter((r) => r.status === "skipped").length;
+    const failed = allResults.filter((r) => r.status === "failed").length;
+    logger.summary(installed, skipped, failed);
+    // Exit with error if any failed
+    if (failed > 0) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/lib/config.d.ts

@@ -0,0 +1,18 @@
+import { type SkillpackConfig, type SkillToInstall } from "./types.js";
+/**
+ * Find skillpack.yaml by walking up from cwd
+ */
+export declare function findConfigPath(startDir?: string): string | null;
+/**
+ * Parse and validate skillpack.yaml
+ */
+export declare function loadConfig(configPath: string): Promise<SkillpackConfig>;
+/**
+ * Transform config into normalized list of skills to install
+ */
+export declare function parseSkillsToInstall(config: SkillpackConfig): SkillToInstall[];
+/**
+ * Validate repo format (owner/repo)
+ */
+export declare function isValidRepoFormat(repo: string): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAmB9E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAuB7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,EAAE,CAmB9E;AASD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/lib/config.js

@@ -0,0 +1,86 @@
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { ZodError } from "zod";
+import { SkillpackConfigSchema, } from "./types.js";
+const CONFIG_FILENAME = "skillpack.yaml";
+/**
+ * Find skillpack.yaml by walking up from cwd
+ */
+export function findConfigPath(startDir = process.cwd()) {
+    let dir = resolve(startDir);
+    const root = dirname(dir);
+    while (dir !== root) {
+        const configPath = join(dir, CONFIG_FILENAME);
+        if (existsSync(configPath)) {
+            return configPath;
+        }
+        dir = dirname(dir);
+    }
+    // Check root as well
+    const rootConfig = join(root, CONFIG_FILENAME);
+    if (existsSync(rootConfig)) {
+        return rootConfig;
+    }
+    return null;
+}
+/**
+ * Parse and validate skillpack.yaml
+ */
+export async function loadConfig(configPath) {
+    const content = await readFile(configPath, "utf-8");
+    let parsed;
+    try {
+        parsed = parseYaml(content);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to parse YAML: ${msg}`);
+    }
+    try {
+        return SkillpackConfigSchema.parse(parsed);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            const issues = err.issues.map((issue) => {
+                const path = issue.path.join(".");
+                return `  - ${path}: ${issue.message}`;
+            });
+            throw new Error(`Invalid skillpack.yaml:\n${issues.join("\n")}`);
+        }
+        throw err;
+    }
+}
+/**
+ * Transform config into normalized list of skills to install
+ */
+export function parseSkillsToInstall(config) {
+    const result = [];
+    for (const [repo, entry] of Object.entries(config.skills)) {
+        const item = {
+            repo,
+            skills: resolveSkillsList(entry),
+            agents: config.agents,
+        };
+        // Extract ref if present
+        if (typeof entry === "object" && entry !== null && "ref" in entry) {
+            item.ref = entry.ref;
+        }
+        result.push(item);
+    }
+    return result;
+}
+function resolveSkillsList(entry) {
+    if (entry === "all") {
+        return "all";
+    }
+    return entry.skills;
+}
+/**
+ * Validate repo format (owner/repo)
+ */
+export function isValidRepoFormat(repo) {
+    return /^[\w-]+\/[\w-]+$/.test(repo);
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}

package/dist/lib/lockfile.d.ts

@@ -0,0 +1,26 @@
+import { type Lockfile, type LockfileInstallation } from "./types.js";
+/**
+ * Get lockfile path relative to config path
+ */
+export declare function getLockfilePath(configPath: string): string;
+/**
+ * Read and parse existing lockfile, or return null if not found
+ */
+export declare function readLockfile(lockfilePath: string): Promise<Lockfile | null>;
+/**
+ * Create a new empty lockfile
+ */
+export declare function createLockfile(): Lockfile;
+/**
+ * Update lockfile with new installation
+ */
+export declare function updateLockfile(lockfile: Lockfile, repo: string, installation: LockfileInstallation): Lockfile;
+/**
+ * Write lockfile to disk
+ */
+export declare function writeLockfile(lockfilePath: string, lockfile: Lockfile): Promise<void>;
+/**
+ * Check if a repo+skills combo is already installed with same commit
+ */
+export declare function isAlreadyInstalled(lockfile: Lockfile | null, repo: string, skills: string[] | "all", agents: string[]): boolean;
+//# sourceMappingURL=lockfile.d.ts.map

package/dist/lib/lockfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../../src/lib/lockfile.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAItF;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAgBjF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAKzC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,oBAAoB,GACjC,QAAQ,CAQV;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EACxB,MAAM,EAAE,MAAM,EAAE,GACf,OAAO,CAmBT"}

package/dist/lib/lockfile.js

@@ -0,0 +1,85 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { LockfileSchema } from "./types.js";
+const LOCKFILE_NAME = "skillpack-lock.yaml";
+/**
+ * Get lockfile path relative to config path
+ */
+export function getLockfilePath(configPath) {
+    return join(dirname(configPath), LOCKFILE_NAME);
+}
+/**
+ * Read and parse existing lockfile, or return null if not found
+ */
+export async function readLockfile(lockfilePath) {
+    if (!existsSync(lockfilePath)) {
+        return null;
+    }
+    const content = await readFile(lockfilePath, "utf-8");
+    const parsed = parseYaml(content);
+    // Validate with schema
+    const result = LockfileSchema.safeParse(parsed);
+    if (!result.success) {
+        // Invalid lockfile, treat as if it doesn't exist
+        return null;
+    }
+    return result.data;
+}
+/**
+ * Create a new empty lockfile
+ */
+export function createLockfile() {
+    return {
+        generated: new Date().toISOString(),
+        installations: {},
+    };
+}
+/**
+ * Update lockfile with new installation
+ */
+export function updateLockfile(lockfile, repo, installation) {
+    return {
+        generated: new Date().toISOString(),
+        installations: {
+            ...lockfile.installations,
+            [repo]: installation,
+        },
+    };
+}
+/**
+ * Write lockfile to disk
+ */
+export async function writeLockfile(lockfilePath, lockfile) {
+    const header = "# Auto-generated by skillpack. Commit this file to git.\n\n";
+    const content = header + stringifyYaml(lockfile, {
+        lineWidth: 0, // Don't wrap lines
+        defaultStringType: "QUOTE_DOUBLE",
+        defaultKeyType: "PLAIN",
+    });
+    await writeFile(lockfilePath, content, "utf-8");
+}
+/**
+ * Check if a repo+skills combo is already installed with same commit
+ */
+export function isAlreadyInstalled(lockfile, repo, skills, agents) {
+    if (!lockfile)
+        return false;
+    const existing = lockfile.installations[repo];
+    if (!existing)
+        return false;
+    // Check if all agents are covered
+    const allAgentsCovered = agents.every((a) => existing.agents.includes(a));
+    if (!allAgentsCovered)
+        return false;
+    // If requesting "all", check if we installed "all" (we track this as empty array)
+    if (skills === "all") {
+        // We can't know for sure without re-fetching, so be conservative
+        return false;
+    }
+    // Check if all requested skills are installed
+    const allSkillsCovered = skills.every((s) => existing.skills.includes(s));
+    return allSkillsCovered;
+}
+//# sourceMappingURL=lockfile.js.map

package/dist/lib/lockfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../../src/lib/lockfile.ts"],"names":[],"mappings":"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"}

package/dist/lib/skills-cli.d.ts

@@ -0,0 +1,25 @@
+import type { SkillToInstall, InstallResult } from "./types.js";
+interface SkillsAddOptions {
+    dryRun: boolean;
+    verbose: boolean;
+}
+/**
+ * Build the npx skills add command arguments
+ */
+export declare function buildSkillsCommand(skill: SkillToInstall): string[];
+/**
+ * Execute a single skill installation
+ */
+export declare function installSkill(skill: SkillToInstall, specificSkill: string | null, // null means install all from the skill.skills list
+options: SkillsAddOptions): Promise<InstallResult>;
+/**
+ * Install all skills from a skill entry
+ */
+export declare function installSkillEntry(skill: SkillToInstall, options: SkillsAddOptions): Promise<InstallResult[]>;
+/**
+ * Get the current commit of a cloned repo (for lockfile)
+ * This would require fetching repo info; for now return a placeholder
+ */
+export declare function getRepoCommit(_repo: string): Promise<string>;
+export {};
+//# sourceMappingURL=skills-cli.d.ts.map

package/dist/lib/skills-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-cli.d.ts","sourceRoot":"","sources":["../../src/lib/skills-cli.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhE,UAAU,gBAAgB;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAgBlE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,GAAG,IAAI,EAAE,oDAAoD;AAClF,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,CAAC,CAiExB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CAgB1B;AAmBD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIlE"}

package/dist/lib/skills-cli.js

@@ -0,0 +1,124 @@
+import { execa } from "execa";
+import { logger } from "../utils/logger.js";
+const MAX_RETRIES = 1;
+/**
+ * Build the npx skills add command arguments
+ */
+export function buildSkillsCommand(skill) {
+    const args = ["skills", "add", skill.repo, "-y"];
+    // Add agents
+    for (const agent of skill.agents) {
+        args.push("-a", agent);
+    }
+    // Add specific skills (omit for "all")
+    if (skill.skills !== "all") {
+        for (const s of skill.skills) {
+            args.push("-s", s);
+        }
+    }
+    return args;
+}
+/**
+ * Execute a single skill installation
+ */
+export async function installSkill(skill, specificSkill, // null means install all from the skill.skills list
+options) {
+    const skillName = specificSkill ?? (skill.skills === "all" ? "all" : skill.skills.join(", "));
+    const repo = skill.repo;
+    // Build command for this specific skill or all
+    const baseArgs = ["skills", "add", repo, "-y"];
+    // Add agents
+    for (const agent of skill.agents) {
+        baseArgs.push("-a", agent);
+    }
+    // Add specific skill if provided
+    if (specificSkill) {
+        baseArgs.push("-s", specificSkill);
+    }
+    else if (skill.skills !== "all") {
+        // Multiple skills at once
+        for (const s of skill.skills) {
+            baseArgs.push("-s", s);
+        }
+    }
+    if (options.dryRun) {
+        logger.info(`Would run: npx ${baseArgs.join(" ")}`);
+        return { repo, skill: skillName, status: "skipped", message: "dry run" };
+    }
+    logger.debug(`Running: npx ${baseArgs.join(" ")}`, options.verbose);
+    // Execute with retry
+    let lastError;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            const execaOpts = {
+                reject: false,
+                timeout: 120_000, // 2 minute timeout
+            };
+            const result = await execa("npx", baseArgs, execaOpts);
+            if (result.exitCode === 0) {
+                return { repo, skill: skillName, status: "installed" };
+            }
+            // Check for "already installed" pattern
+            const stdout = String(result.stdout ?? "");
+            const stderr = String(result.stderr ?? "");
+            const output = stdout + stderr;
+            if (output.includes("already installed") || output.includes("Already installed")) {
+                return { repo, skill: skillName, status: "skipped", message: "already installed" };
+            }
+            lastError = stderr || stdout || `Exit code ${result.exitCode}`;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err.message : String(err);
+        }
+        // Retry on network errors
+        if (attempt < MAX_RETRIES && isRetryableError(lastError)) {
+            logger.debug(`Retrying ${skillName} (attempt ${attempt + 2})...`, options.verbose);
+            await sleep(1000);
+        }
+    }
+    return { repo, skill: skillName, status: "failed", message: lastError };
+}
+/**
+ * Install all skills from a skill entry
+ */
+export async function installSkillEntry(skill, options) {
+    // For "all" or when installing multiple skills at once,
+    // we run a single command and track it as one result
+    if (skill.skills === "all") {
+        const result = await installSkill(skill, null, options);
+        return [result];
+    }
+    // For multiple specific skills, we can run them together in one command
+    const result = await installSkill(skill, null, options);
+    // Return one result per skill for better granularity in the summary
+    return skill.skills.map((s) => ({
+        ...result,
+        skill: s,
+    }));
+}
+function isRetryableError(error) {
+    if (!error)
+        return false;
+    const retryablePatterns = [
+        "ECONNRESET",
+        "ETIMEDOUT",
+        "ENOTFOUND",
+        "network",
+        "timeout",
+        "fetch failed",
+    ];
+    return retryablePatterns.some((p) => error.toLowerCase().includes(p.toLowerCase()));
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Get the current commit of a cloned repo (for lockfile)
+ * This would require fetching repo info; for now return a placeholder
+ */
+export async function getRepoCommit(_repo) {
+    // TODO: In a full implementation, we'd fetch the actual commit SHA
+    // For now, use a timestamp-based identifier
+    return `installed-${Date.now()}`;
+}
+//# sourceMappingURL=skills-cli.js.map

package/dist/lib/skills-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-cli.js","sourceRoot":"","sources":["../../src/lib/skills-cli.ts"],"names":[],"mappings":"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"}

package/dist/lib/types.d.ts

@@ -0,0 +1,118 @@
+import { z } from "zod";
+declare const SkillEntrySchema: z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"all">, z.ZodObject<{
+    ref: z.ZodOptional<z.ZodString>;
+    skills: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    skills: string[];
+    ref?: string | undefined;
+}, {
+    skills: string[];
+    ref?: string | undefined;
+}>]>, "all" | {
+    skills: string[];
+    ref?: string | undefined;
+}, unknown>;
+export type SkillEntry = z.infer<typeof SkillEntrySchema>;
+export declare const SkillpackConfigSchema: z.ZodObject<{
+    agents: z.ZodArray<z.ZodString, "many">;
+    skills: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"all">, z.ZodObject<{
+        ref: z.ZodOptional<z.ZodString>;
+        skills: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        skills: string[];
+        ref?: string | undefined;
+    }, {
+        skills: string[];
+        ref?: string | undefined;
+    }>]>, "all" | {
+        skills: string[];
+        ref?: string | undefined;
+    }, unknown>>;
+}, "strip", z.ZodTypeAny, {
+    skills: Record<string, "all" | {
+        skills: string[];
+        ref?: string | undefined;
+    }>;
+    agents: string[];
+}, {
+    skills: Record<string, unknown>;
+    agents: string[];
+}>;
+export type SkillpackConfig = z.infer<typeof SkillpackConfigSchema>;
+declare const LockfileInstallationSchema: z.ZodObject<{
+    commit: z.ZodString;
+    skills: z.ZodArray<z.ZodString, "many">;
+    agents: z.ZodArray<z.ZodString, "many">;
+    installedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    skills: string[];
+    agents: string[];
+    commit: string;
+    installedAt?: string | undefined;
+}, {
+    skills: string[];
+    agents: string[];
+    commit: string;
+    installedAt?: string | undefined;
+}>;
+export type LockfileInstallation = z.infer<typeof LockfileInstallationSchema>;
+export declare const LockfileSchema: z.ZodObject<{
+    generated: z.ZodString;
+    installations: z.ZodRecord<z.ZodString, z.ZodObject<{
+        commit: z.ZodString;
+        skills: z.ZodArray<z.ZodString, "many">;
+        agents: z.ZodArray<z.ZodString, "many">;
+        installedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        skills: string[];
+        agents: string[];
+        commit: string;
+        installedAt?: string | undefined;
+    }, {
+        skills: string[];
+        agents: string[];
+        commit: string;
+        installedAt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    generated: string;
+    installations: Record<string, {
+        skills: string[];
+        agents: string[];
+        commit: string;
+        installedAt?: string | undefined;
+    }>;
+}, {
+    generated: string;
+    installations: Record<string, {
+        skills: string[];
+        agents: string[];
+        commit: string;
+        installedAt?: string | undefined;
+    }>;
+}>;
+export type Lockfile = z.infer<typeof LockfileSchema>;
+export interface SkillToInstall {
+    repo: string;
+    skills: string[] | "all";
+    ref?: string;
+    agents: string[];
+}
+export interface InstallResult {
+    repo: string;
+    skill: string;
+    status: "installed" | "skipped" | "failed";
+    message?: string;
+}
+export interface InstallOptions {
+    dryRun: boolean;
+    force: boolean;
+    verbose: boolean;
+    config: string;
+    noLock: boolean;
+}
+export interface InitOptions {
+    force: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,QAAA,MAAM,gBAAgB;;;;;;;;;;;;WAerB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAG1D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGpE,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAGtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAGD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;CAChB"}

package/dist/lib/types.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+// Schema for individual skill entry in config
+// Can be:
+// - "all" (install all skills from repo)
+// - ["skill1", "skill2"] (list of skill names)
+// - { ref: "v1.0.0", skills: ["skill1"] } (pinned version)
+const SkillEntrySchema = z.preprocess((val) => {
+    // Normalize array shorthand to object form
+    if (Array.isArray(val)) {
+        return { skills: val };
+    }
+    return val;
+}, z.union([
+    z.literal("all"),
+    z.object({
+        ref: z.string().optional(),
+        skills: z.array(z.string()).min(1),
+    }),
+]));
+// Main skillpack.yaml schema
+export const SkillpackConfigSchema = z.object({
+    agents: z.array(z.string()).min(1, "At least one agent must be specified"),
+    skills: z.record(z.string(), SkillEntrySchema),
+});
+// Lockfile schema for tracking installed versions
+const LockfileInstallationSchema = z.object({
+    commit: z.string(),
+    skills: z.array(z.string()),
+    agents: z.array(z.string()),
+    installedAt: z.string().optional(),
+});
+export const LockfileSchema = z.object({
+    generated: z.string(),
+    installations: z.record(z.string(), LockfileInstallationSchema),
+});
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8CAA8C;AAC9C,UAAU;AACV,yCAAyC;AACzC,+CAA+C;AAC/C,2DAA2D;AAC3D,MAAM,gBAAgB,GAAG,CAAC,CAAC,UAAU,CACnC,CAAC,GAAG,EAAE,EAAE;IACN,2CAA2C;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,EACD,CAAC,CAAC,KAAK,CAAC;IACN,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAChB,CAAC,CAAC,MAAM,CAAC;QACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC1B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KACnC,CAAC;CACH,CAAC,CACH,CAAC;AAIF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC;CAC/C,CAAC,CAAC;AAIH,kDAAkD;AAClD,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC;CAChE,CAAC,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,18 @@
+import { type Ora } from "ora";
+export declare const logger: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    debug: (msg: string, verbose: boolean) => void;
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    cyan: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    red: (text: string) => string;
+    summary: (installed: number, skipped: number, failed: number) => void;
+    blank: () => void;
+};
+export declare function createSpinner(text: string): Ora;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,eAAO,MAAM,MAAM;gBACL,MAAM;mBACH,MAAM;gBACT,MAAM;iBACL,MAAM;iBACN,MAAM,WAAW,OAAO;iBAKxB,MAAM;gBACP,MAAM;iBACL,MAAM;kBACL,MAAM;mBACL,MAAM;gBACT,MAAM;yBAGG,MAAM,WAAW,MAAM,UAAU,MAAM;;CAU7D,CAAC;AAGF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAE/C"}

package/dist/utils/logger.js

@@ -0,0 +1,37 @@
+import chalk from "chalk";
+import ora from "ora";
+export const logger = {
+    info: (msg) => console.log(chalk.blue("ℹ"), msg),
+    success: (msg) => console.log(chalk.green("✓"), msg),
+    warn: (msg) => console.log(chalk.yellow("⚠"), msg),
+    error: (msg) => console.error(chalk.red("✗"), msg),
+    debug: (msg, verbose) => {
+        if (verbose)
+            console.log(chalk.gray("  →"), chalk.gray(msg));
+    },
+    // Styled text helpers
+    bold: (text) => chalk.bold(text),
+    dim: (text) => chalk.dim(text),
+    cyan: (text) => chalk.cyan(text),
+    green: (text) => chalk.green(text),
+    yellow: (text) => chalk.yellow(text),
+    red: (text) => chalk.red(text),
+    // Summary formatting
+    summary: (installed, skipped, failed) => {
+        const parts = [];
+        if (installed > 0)
+            parts.push(chalk.green(`${installed} installed`));
+        if (skipped > 0)
+            parts.push(chalk.yellow(`${skipped} skipped`));
+        if (failed > 0)
+            parts.push(chalk.red(`${failed} failed`));
+        console.log("\n" + chalk.bold("Summary:"), parts.join(", "));
+    },
+    // Blank line
+    blank: () => console.log(),
+};
+// Spinner factory
+export function createSpinner(text) {
+    return ora({ text, color: "cyan" });
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAiB,MAAM,KAAK,CAAC;AAEpC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IACxD,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAC5D,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAC1D,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;IAC1D,KAAK,EAAE,CAAC,GAAW,EAAE,OAAgB,EAAE,EAAE;QACvC,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,sBAAsB;IACtB,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IACtC,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;IAC1C,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;IAC5C,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;IAEtC,qBAAqB;IACrB,OAAO,EAAE,CAAC,SAAiB,EAAE,OAAe,EAAE,MAAc,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,SAAS,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,YAAY,CAAC,CAAC,CAAC;QACrE,IAAI,OAAO,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC,CAAC;QAChE,IAAI,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,aAAa;IACb,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;CAC3B,CAAC;AAEF,kBAAkB;AAClB,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "skillpack",
+  "version": "0.1.0",
+  "description": "Package manager for skills.sh - batch install skills to AI agents",
+  "type": "module",
+  "bin": {
+    "skillpack": "./dist/cli.js"
+  },
+  "main": "./dist/cli.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joventuraz/skillpack.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "skills",
+    "ai",
+    "claude",
+    "cursor",
+    "package-manager",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "execa": "^9.5.2",
+    "ora": "^8.1.1",
+    "yaml": "^2.7.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "typescript": "^5.7.3",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/templates/skillpack.yaml

@@ -0,0 +1,23 @@
+# skillpack.yaml - Package manager for skills.sh
+# Run `skillpack install` to install all skills below
+
+# Target agents to install skills to
+agents:
+  - claude-code
+  # - cursor
+
+# Skills to install (owner/repo format)
+skills:
+  # Install specific skills from a repo
+  vercel-labs/agent-skills:
+    - vercel-react-best-practices
+    - web-design-guidelines
+
+  # Install all skills from a repo
+  # another-org/repo: all
+
+  # Pin to a specific git ref (tag, branch, or commit)
+  # pinned-org/skill-repo:
+  #   ref: v1.0.0
+  #   skills:
+  #     - specific-skill