@cremini/skillpack 1.0.2 → 1.0.4

package/README.md

@@ -1,4 +1,4 @@
-# SkillPack - Pack AI Skills into Standalone Apps
+# SkillPack.sh - Pack AI Skills into Standalone Apps
 
 Go to [skillpack.sh](https://skillpack.sh) to pack skills and try existing skill packs.
 
@@ -27,6 +27,15 @@ Step-by-Step
 3. Add prompts to orchestrate and organize skills you added to accomplish tasks
 4. (Optional) bundle the result as a zip
 
+### Initialize from an Existing Config
+
+```bash
+npx @cremini/skillpack init --config ./skillpack.json
+npx @cremini/skillpack init output --config https://example.com/skillpack.json
+```
+
+This loads a local or remote config, writes `skillpack.json` into the target directory, installs any pending skills, and skips zip packaging unless you pass `--bundle`.
+
 ### Step-by-Step Commands
 
 ```bash
@@ -47,6 +56,7 @@ npx @cremini/skillpack build
 | Command                  | Description                           |
 | ------------------------ | ------------------------------------- |
 | `create`                 | Create a skill pack interactively     |
+| `init`                   | Initialize from a config path or URL  |
 | `skills add <source>`    | Add a skill                           |
 | `skills remove <name>`   | Remove a skill                        |
 | `skills list`            | List installed skills                 |
@@ -61,7 +71,7 @@ The extracted archive looks like this:
 
 ```text
 skillpack/
-├── app.json             # App configuration
+├── skillpack.json       # Pack configuration
 ├── skills/              # Collected SKILL.md files
 ├── server/              # Express backend
 ├── web/                 # Web chat UI

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { Command } from "commander";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 
 // src/commands/create.ts
 import inquirer from "inquirer";
@@ -11,7 +11,7 @@ import chalk3 from "chalk";
 // src/core/pack-config.ts
 import fs from "fs";
 import path from "path";
-var PACK_FILE = "app.json";
+var PACK_FILE = "skillpack.json";
 function getPackPath(workDir) {
   return path.join(workDir, PACK_FILE);
 }
@@ -28,7 +28,7 @@ function loadConfig(workDir) {
   const filePath = getPackPath(workDir);
   if (!fs.existsSync(filePath)) {
     throw new Error(
-      `Could not find ${PACK_FILE}. Run npx @cremini/skillpack create first or work in a directory that contains app.json`
+      `Could not find ${PACK_FILE}. Run npx @cremini/skillpack create first or work in a directory that contains ${PACK_FILE}`
     );
   }
   const raw = fs.readFileSync(filePath, "utf-8");
@@ -154,6 +154,7 @@ function getRuntimeDir() {
 }
 async function bundle(workDir) {
   const config = loadConfig(workDir);
+  saveConfig(workDir, config);
   const zipName = `${config.name}.zip`;
   const zipPath = path3.join(workDir, zipName);
   const runtimeDir = getRuntimeDir();
@@ -176,8 +177,8 @@ async function bundle(workDir) {
     archive.on("error", (err) => reject(err));
     archive.pipe(output);
     const prefix = config.name;
-    archive.file(path3.join(workDir, "app.json"), {
-      name: `${prefix}/app.json`
+    archive.file(getPackPath(workDir), {
+      name: `${prefix}/${PACK_FILE}`
     });
     const skillsDir = path3.join(workDir, "skills");
     if (fs3.existsSync(skillsDir)) {
@@ -233,7 +234,7 @@ async function createCommand(directory) {
       {
         type: "confirm",
         name: "overwrite",
-        message: "An app.json file already exists in this directory. Overwrite it?",
+        message: `Overwrite the existing ${PACK_FILE}?`,
         default: false
       }
     ]);
@@ -343,7 +344,9 @@ async function createCommand(directory) {
     promptIndex++;
   }
   saveConfig(workDir, config);
-  console.log(chalk3.green("\n  app.json saved\n"));
+  console.log(chalk3.green(`
+  ${PACK_FILE} saved
+`));
   const { shouldBundle } = await inquirer.prompt([
     {
       type: "confirm",
@@ -363,8 +366,97 @@ async function createCommand(directory) {
   }
 }
 
-// src/commands/skills-cmd.ts
+// src/commands/init.ts
+import fs5 from "fs";
+import path5 from "path";
+import inquirer2 from "inquirer";
 import chalk4 from "chalk";
+function isHttpUrl(value) {
+  try {
+    const url = new URL(value);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function validateConfigShape(value, source) {
+  if (!value || typeof value !== "object") {
+    throw new Error(`Invalid config from ${source}: expected a JSON object`);
+  }
+  const config = value;
+  if (typeof config.name !== "string" || !config.name.trim()) {
+    throw new Error(`Invalid config from ${source}: "name" is required`);
+  }
+  if (typeof config.description !== "string") {
+    throw new Error(`Invalid config from ${source}: "description" must be a string`);
+  }
+  if (typeof config.version !== "string") {
+    throw new Error(`Invalid config from ${source}: "version" must be a string`);
+  }
+  if (!Array.isArray(config.prompts) || !config.prompts.every((p) => typeof p === "string")) {
+    throw new Error(`Invalid config from ${source}: "prompts" must be a string array`);
+  }
+  if (!Array.isArray(config.skills)) {
+    throw new Error(`Invalid config from ${source}: "skills" must be an array`);
+  }
+}
+async function readConfigSource(source) {
+  let raw = "";
+  if (isHttpUrl(source)) {
+    const response = await fetch(source);
+    if (!response.ok) {
+      throw new Error(`Failed to download config: ${response.status} ${response.statusText}`);
+    }
+    raw = await response.text();
+  } else {
+    const filePath = path5.resolve(source);
+    raw = fs5.readFileSync(filePath, "utf-8");
+  }
+  const parsed = JSON.parse(raw);
+  validateConfigShape(parsed, source);
+  return parsed;
+}
+async function initCommand(directory, options) {
+  const workDir = directory ? path5.resolve(directory) : process.cwd();
+  if (directory) {
+    fs5.mkdirSync(workDir, { recursive: true });
+  }
+  if (configExists(workDir)) {
+    const { overwrite } = await inquirer2.prompt([
+      {
+        type: "confirm",
+        name: "overwrite",
+        message: `A ${PACK_FILE} file already exists in this directory. Overwrite it?`,
+        default: false
+      }
+    ]);
+    if (!overwrite) {
+      console.log(chalk4.yellow("Cancelled"));
+      return;
+    }
+  }
+  const config = await readConfigSource(options.config);
+  saveConfig(workDir, config);
+  console.log(chalk4.blue(`
+  Initialize ${config.name} from ${options.config}
+`));
+  await installPendingSkills(workDir, config);
+  if (options.bundle) {
+    await bundle(workDir);
+  }
+  console.log(chalk4.green(`
+  ${PACK_FILE} saved
+`));
+  console.log(chalk4.green("  Initialization complete.\n"));
+  if (!options.bundle) {
+    console.log(
+      chalk4.dim("  Run npx @cremini/skillpack build to create the zip when needed\n")
+    );
+  }
+}
+
+// src/commands/skills-cmd.ts
+import chalk5 from "chalk";
 function registerSkillsCommand(program2) {
   const skills = program2.command("skills").description("Manage skills in the app");
   skills.command("add <source>").description("Add a skill from a git repo, URL, or local path").option("-s, --skill <names...>", "Specify skill name(s)").action(async (source, opts) => {
@@ -379,7 +471,7 @@ function registerSkillsCommand(program2) {
     });
     saveConfig(workDir, config);
     console.log(
-      chalk4.green(
+      chalk5.green(
         `Skill list updated (${config.skills.length} total). Skills will be installed during build.`
       )
     );
@@ -390,16 +482,16 @@ function registerSkillsCommand(program2) {
   skills.command("list").description("List installed skills").action(() => {
     const config = loadConfig(process.cwd());
     if (config.skills.length === 0) {
-      console.log(chalk4.dim("  No skills installed"));
+      console.log(chalk5.dim("  No skills installed"));
       return;
     }
-    console.log(chalk4.blue(`
+    console.log(chalk5.blue(`
   ${config.name} Skills:
 `));
     for (const skill of config.skills) {
-      console.log(`  ${chalk4.green("\u25CF")} ${chalk4.bold(skill.name)}`);
+      console.log(`  ${chalk5.green("\u25CF")} ${chalk5.bold(skill.name)}`);
       if (skill.description) {
-        console.log(`    ${chalk4.dim(skill.description)}`);
+        console.log(`    ${chalk5.dim(skill.description)}`);
       }
     }
     console.log();
@@ -407,29 +499,29 @@ function registerSkillsCommand(program2) {
 }
 
 // src/commands/prompts-cmd.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 
 // src/core/prompts.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 function addPrompt(workDir, text) {
   const config = loadConfig(workDir);
   config.prompts.push(text);
   saveConfig(workDir, config);
-  console.log(chalk5.green(`Added Prompt #${config.prompts.length}`));
+  console.log(chalk6.green(`Added Prompt #${config.prompts.length}`));
 }
 function removePrompt(workDir, index) {
   const config = loadConfig(workDir);
   const idx = index - 1;
   if (idx < 0 || idx >= config.prompts.length) {
     console.log(
-      chalk5.yellow(`Invalid index: ${index} (${config.prompts.length} total)`)
+      chalk6.yellow(`Invalid index: ${index} (${config.prompts.length} total)`)
     );
     return false;
   }
   const removed = config.prompts.splice(idx, 1)[0];
   saveConfig(workDir, config);
   console.log(
-    chalk5.green(`Removed Prompt #${index}: "${removed.substring(0, 50)}..."`)
+    chalk6.green(`Removed Prompt #${index}: "${removed.substring(0, 50)}..."`)
   );
   return true;
 }
@@ -447,7 +539,7 @@ function registerPromptsCommand(program2) {
   prompts.command("remove <index>").description("Remove a prompt by number, starting from 1").action((index) => {
     const num = parseInt(index, 10);
     if (isNaN(num)) {
-      console.log(chalk6.red("Enter a valid numeric index"));
+      console.log(chalk7.red("Enter a valid numeric index"));
       return;
     }
     removePrompt(process.cwd(), num);
@@ -455,13 +547,13 @@ function registerPromptsCommand(program2) {
   prompts.command("list").description("List all prompts").action(() => {
     const prompts2 = listPrompts(process.cwd());
     if (prompts2.length === 0) {
-      console.log(chalk6.dim("  No prompts yet"));
+      console.log(chalk7.dim("  No prompts yet"));
       return;
     }
-    console.log(chalk6.blue("\n  Prompts:\n"));
+    console.log(chalk7.blue("\n  Prompts:\n"));
     prompts2.forEach((u, i) => {
-      const marker = i === 0 ? chalk6.green("\u2605") : chalk6.dim("\u25CF");
-      const label = i === 0 ? chalk6.dim(" (default)") : "";
+      const marker = i === 0 ? chalk7.green("\u2605") : chalk7.dim("\u25CF");
+      const label = i === 0 ? chalk7.dim(" (default)") : "";
       const display = u.length > 80 ? u.substring(0, 80) + "..." : u;
       console.log(`  ${marker} #${i + 1}${label} ${display}`);
     });
@@ -470,22 +562,27 @@ function registerPromptsCommand(program2) {
 }
 
 // src/cli.ts
-import fs5 from "fs";
+import fs6 from "fs";
 var packageJson = JSON.parse(
-  fs5.readFileSync(new URL("../package.json", import.meta.url), "utf-8")
+  fs6.readFileSync(new URL("../package.json", import.meta.url), "utf-8")
 );
 var program = new Command();
 program.name("skillpack").description("Assemble, package, and run Agent Skills packs").version(packageJson.version);
 program.command("create [directory]").description("Create a skills pack interactively").action(async (directory) => {
   await createCommand(directory);
 });
+program.command("init [directory]").description("Initialize a skills pack from a local config file or URL").requiredOption("--config <path-or-url>", "Path or URL to a skillpack.json file").option("--bundle", "Bundle as a zip after initialization").action(
+  async (directory, options) => {
+    await initCommand(directory, options);
+  }
+);
 registerSkillsCommand(program);
 registerPromptsCommand(program);
 program.command("build").description("Package the current pack as a zip file").action(async () => {
   try {
     await bundle(process.cwd());
   } catch (err) {
-    console.error(chalk7.red(`Packaging failed: ${err}`));
+    console.error(chalk8.red(`Packaging failed: ${err}`));
     process.exit(1);
   }
 });

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@cremini/skillpack",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Turn Skills into a Standalone App with UI",
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/FinpeakInc/skillpack.git"
+    "url": "git+https://github.com/CreminiAI/skillpack.git"
   },
   "bugs": {
-    "url": "https://github.com/FinpeakInc/skillpack/issues"
+    "url": "https://github.com/CreminiAI/skillpack/issues"
   },
-  "homepage": "https://github.com/FinpeakInc/skillpack#readme",
+  "homepage": "https://github.com/CreminiAI/skillpack#readme",
   "bin": {
     "skillpack": "dist/cli.js"
   },

package/runtime/scripts/start.sh

@@ -3,8 +3,8 @@ cd "$(dirname "$0")"
 
 # Read the pack name
 PACK_NAME="Skills Pack"
-if [ -f "app.json" ] && command -v node &> /dev/null; then
-  PACK_NAME=$(node -e "console.log(JSON.parse(require('fs').readFileSync('app.json','utf-8')).name)" 2>/dev/null || echo "Skills Pack")
+if [ -f "skillpack.json" ] && command -v node &> /dev/null; then
+  PACK_NAME=$(node -e "console.log(JSON.parse(require('fs').readFileSync('skillpack.json','utf-8')).name)" 2>/dev/null || echo "Skills Pack")
 fi
 
 echo ""

package/runtime/server/index.js

@@ -28,21 +28,25 @@ registerRoutes(app, server, rootDir);
 const HOST = process.env.HOST || "127.0.0.1";
 const DEFAULT_PORT = 26313;
 
+server.once("listening", () => {
+  const address = server.address();
+  const actualPort = typeof address === "string" ? address : address.port;
+  const url = `http://${HOST}:${actualPort}`;
+  console.log(`\n  Skills Pack Server`);
+  console.log(`  Running at ${url}\n`);
+
+  // Open the browser automatically
+  const cmd =
+    process.platform === "darwin"
+      ? `open ${url}`
+      : process.platform === "win32"
+        ? `start ${url}`
+        : `xdg-open ${url}`;
+  exec(cmd, () => {});
+});
+
 function tryListen(port) {
-  server.listen(port, HOST, () => {
-    const url = `http://${HOST}:${port}`;
-    console.log(`\n  Skills Pack Server`);
-    console.log(`  Running at ${url}\n`);
-
-    // Open the browser automatically
-    const cmd =
-      process.platform === "darwin"
-        ? `open ${url}`
-        : process.platform === "win32"
-          ? `start ${url}`
-          : `xdg-open ${url}`;
-    exec(cmd, () => {});
-  });
+  server.listen(port, HOST);
 
   server.once("error", (err) => {
     if (err.code === "EADDRINUSE") {

package/runtime/server/routes.js

@@ -5,11 +5,11 @@ import { WebSocketServer } from "ws";
 import { handleWsConnection } from "./chat-proxy.js";
 
 /**
- * Read the app.json config.
+ * Read the skillpack.json config.
  * @param {string} rootDir
  */
 function getPackConfig(rootDir) {
-  const raw = fs.readFileSync(path.join(rootDir, "app.json"), "utf-8");
+  const raw = fs.readFileSync(path.join(rootDir, "skillpack.json"), "utf-8");
   return JSON.parse(raw);
 }
 
@@ -17,7 +17,7 @@ function getPackConfig(rootDir) {
  * Register all API routes.
  * @param {import("express").Express} app
  * @param {import("node:http").Server} server
- * @param {string} rootDir - Root directory containing app.json and skills/
+ * @param {string} rootDir - Root directory containing skillpack.json and skills/
  */
 export function registerRoutes(app, server, rootDir) {
   // API key and provider are stored in runtime memory