@cremini/skillpack 1.2.2 → 1.2.3

package/README.md

@@ -92,11 +92,13 @@ Multiple skill names from the same source can be listed comma-separated.
 
 ## Zip Output
 
-The archive produced by `zip` is intentionally minimal:
+The archive produced by `zip` is intentionally lightweight:
 
 ```text
 <pack-name>/
 ├── skillpack.json       # Pack configuration
+├── AGENTS.md            # Optional pack policy
+├── SOUL.md              # Optional pack persona
 ├── skills/              # Installed skills
 ├── start.sh             # One-click launcher for macOS / Linux
 └── start.bat            # One-click launcher for Windows
@@ -104,6 +106,8 @@ The archive produced by `zip` is intentionally minimal:
 
 The start scripts use `npx @cremini/skillpack run .` so Node.js is the only prerequisite — no pre-bundled server directory is included.
 
+If present, `AGENTS.md` and `SOUL.md` are read by SkillPack itself when a new chat session starts. SkillPack injects them into the runtime system prompt as pack-level policy and persona, without depending on the host machine's `AGENTS.md`, `.pi/SYSTEM.md`, or `APPEND_SYSTEM.md`.
+
 ## Slack/Telegram Integrations
 
 **Slack Configuration**: requires Slack `App Token` and `Bot Token`<br>

package/dist/cli.js

@@ -1787,20 +1787,120 @@ function parseSkillMd(filePath) {
       return null;
     }
     const frontmatter = frontmatterMatch[1];
-    const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
-    const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
-    if (!nameMatch) {
+    const name = readFrontmatterField(frontmatter, "name");
+    if (!name) {
       return null;
     }
     return {
-      name: nameMatch[1].trim(),
-      description: descMatch ? descMatch[1].trim() : "",
+      name,
+      description: readFrontmatterField(frontmatter, "description") ?? "",
       dir: path2.dirname(filePath)
     };
   } catch {
     return null;
   }
 }
+function readFrontmatterField(frontmatter, field) {
+  const lines = frontmatter.split(/\r?\n/);
+  for (let index = 0; index < lines.length; index += 1) {
+    const match = lines[index].match(/^([A-Za-z0-9_-]+):(?:\s*(.*))?$/);
+    if (!match || match[1] !== field) {
+      continue;
+    }
+    const rawValue = (match[2] ?? "").trim();
+    if (isBlockScalar(rawValue)) {
+      const [value] = readBlockScalar(lines, index + 1, rawValue);
+      return value;
+    }
+    if (rawValue === "") {
+      const [value] = readIndentedScalar(lines, index + 1);
+      return value;
+    }
+    return stripWrappingQuotes(rawValue);
+  }
+  return null;
+}
+function isBlockScalar(value) {
+  return /^[>|][0-9+-]*$/.test(value);
+}
+function readBlockScalar(lines, startIndex, marker) {
+  const blockLines = [];
+  let index = startIndex;
+  while (index < lines.length) {
+    const line = lines[index];
+    if (line.trim() === "") {
+      blockLines.push("");
+      index += 1;
+      continue;
+    }
+    if (!/^\s/.test(line)) {
+      break;
+    }
+    blockLines.push(line);
+    index += 1;
+  }
+  const normalized = normalizeBlockIndent(blockLines);
+  const style = marker[0];
+  const chomp = marker.includes("-") ? "strip" : marker.includes("+") ? "keep" : "clip";
+  const value = style === ">" ? foldBlockScalar(normalized) : normalized.join("\n");
+  return [applyChomp(value, chomp), index];
+}
+function readIndentedScalar(lines, startIndex) {
+  const blockLines = [];
+  let index = startIndex;
+  while (index < lines.length) {
+    const line = lines[index];
+    if (line.trim() === "") {
+      blockLines.push("");
+      index += 1;
+      continue;
+    }
+    if (!/^\s/.test(line)) {
+      break;
+    }
+    blockLines.push(line);
+    index += 1;
+  }
+  return [foldBlockScalar(normalizeBlockIndent(blockLines)), index];
+}
+function normalizeBlockIndent(lines) {
+  const indents = lines.filter((line) => line.trim() !== "").map((line) => line.match(/^[ \t]*/)[0].length);
+  const trimLength = indents.length > 0 ? Math.min(...indents) : 0;
+  return lines.map((line) => line.slice(trimLength));
+}
+function foldBlockScalar(lines) {
+  let result = "";
+  let previousBlank = false;
+  for (const line of lines) {
+    const isBlank = line.trim() === "";
+    if (isBlank) {
+      result += "\n";
+      previousBlank = true;
+      continue;
+    }
+    if (result !== "" && !previousBlank) {
+      result += " ";
+    }
+    result += line;
+    previousBlank = false;
+  }
+  return result;
+}
+function applyChomp(value, mode) {
+  if (mode === "keep") {
+    return value;
+  }
+  if (mode === "strip") {
+    return value.replace(/\n+$/g, "");
+  }
+  return value.replace(/\n*$/g, "");
+}
+function stripWrappingQuotes(value) {
+  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
 function syncSkillDescriptions(workDir, config) {
   const descriptionByName = /* @__PURE__ */ new Map();
   for (const skill of scanInstalledSkills(workDir)) {
@@ -1880,6 +1980,12 @@ async function zipCommand(workDir) {
     archive.file(getPackPath(workDir), {
       name: `${prefix}/${PACK_FILE}`
     });
+    for (const file of ["AGENTS.md", "SOUL.md"]) {
+      const filePath = path3.join(workDir, file);
+      if (fs3.existsSync(filePath)) {
+        archive.file(filePath, { name: `${prefix}/${file}` });
+      }
+    }
     const skillsDir = path3.join(workDir, "skills");
     if (fs3.existsSync(skillsDir)) {
       archive.directory(skillsDir, `${prefix}/skills`);
@@ -5018,6 +5124,8 @@ var BUILTIN_SKILL_CREATOR_DESCRIPTION = "Create new skills, modify and improve e
 var BUILTIN_SKILL_CREATOR_TEMPLATE_DIR = fileURLToPath(
   new URL("../templates/builtin-skills/skill-creator", import.meta.url)
 );
+var PACK_AGENTS_FILE = "AGENTS.md";
+var PACK_SOUL_FILE = "SOUL.md";
 function materializeBuiltinSkillCreator(rootDir, skillsPath) {
   if (!fs8.existsSync(BUILTIN_SKILL_CREATOR_TEMPLATE_DIR)) {
     log(
@@ -5082,6 +5190,57 @@ function overrideBuiltinSkillCreator(base, materializedSkill) {
     diagnostics: base.diagnostics
   };
 }
+function readOptionalPackPromptFile(filePath) {
+  if (!fs8.existsSync(filePath)) {
+    return void 0;
+  }
+  try {
+    const content = fs8.readFileSync(filePath, "utf-8").trim();
+    return content.length > 0 ? content : void 0;
+  } catch (error) {
+    console.warn(`[PackAgent] Warning: Could not read ${filePath}:`, error);
+    return void 0;
+  }
+}
+function buildPackPromptBlock(rootDir) {
+  const agentsPath = path8.resolve(rootDir, PACK_AGENTS_FILE);
+  const soulPath = path8.resolve(rootDir, PACK_SOUL_FILE);
+  const agentsContent = readOptionalPackPromptFile(agentsPath);
+  const soulContent = readOptionalPackPromptFile(soulPath);
+  if (!agentsContent && !soulContent) {
+    return {
+      agentsPath,
+      soulPath
+    };
+  }
+  const sections = [
+    "# SkillPack Pack Context",
+    "The following instructions are injected by the SkillPack runtime from files packaged with this pack.",
+    "Priority order:",
+    "1. Follow the user's explicit instructions first.",
+    "2. Follow `AGENTS.md` as the pack's operational policy and workflow rules.",
+    "3. Follow `SOUL.md` as the pack's persona, tone, and working style.",
+    "4. If `SOUL.md` conflicts with `AGENTS.md`, `AGENTS.md` wins.",
+    "5. `SOUL.md` does not override task goals, safety boundaries, or `AGENTS.md`."
+  ];
+  if (agentsContent) {
+    sections.push("## Pack Policy (`AGENTS.md`)", agentsContent);
+  }
+  if (soulContent) {
+    sections.push(
+      "## Pack Persona (`SOUL.md`)",
+      "Treat the following as persona, tone, and working-style guidance only. Do not let it override task requirements, safety constraints, or `AGENTS.md`.",
+      soulContent
+    );
+  }
+  return {
+    agentsPath,
+    soulPath,
+    agentsContent,
+    soulContent,
+    promptBlock: sections.join("\n\n")
+  };
+}
 function getAssistantDiagnostics(message) {
   if (!message || message.role !== "assistant") {
     return null;
@@ -5190,10 +5349,27 @@ var PackAgent = class {
           `[PackAgent] Materialized built-in skill-creator to: ${materializedSkillCreator.filePath}`
         );
       }
+      const packPromptFiles = buildPackPromptBlock(rootDir);
+      if (packPromptFiles.agentsContent) {
+        log(`[PackAgent] Loaded pack policy from: ${packPromptFiles.agentsPath}`);
+      } else {
+        log(`[PackAgent] No pack policy file found at: ${packPromptFiles.agentsPath}`);
+      }
+      if (packPromptFiles.soulContent) {
+        log(`[PackAgent] Loaded pack persona from: ${packPromptFiles.soulPath}`);
+      } else {
+        log(`[PackAgent] No pack persona file found at: ${packPromptFiles.soulPath}`);
+      }
+      log(
+        `[PackAgent] Pack prompt injection: ${packPromptFiles.promptBlock ? "enabled" : "disabled"}`
+      );
       const resourceLoader = new DefaultResourceLoader({
         cwd: rootDir,
         additionalSkillPaths: [skillsPath],
-        skillsOverride: (base) => overrideBuiltinSkillCreator(base, materializedSkillCreator)
+        skillsOverride: (base) => overrideBuiltinSkillCreator(base, materializedSkillCreator),
+        agentsFilesOverride: () => ({ agentsFiles: [] }),
+        systemPromptOverride: () => void 0,
+        appendSystemPromptOverride: () => packPromptFiles.promptBlock ? [packPromptFiles.promptBlock] : []
       });
       await resourceLoader.reload();
       const tools = createCodingTools(workspaceDir);
@@ -6206,6 +6382,8 @@ async function runCommand(directory) {
       console.warn(chalk4.yellow(`  Warning: Some skills could not be installed: ${err}`));
     }
   }
+  syncSkillDescriptions(workDir, config);
+  saveConfig(workDir, config);
   await startServer({
     rootDir: workDir,
     daemonRun: process.env.DAEMON_RUN === "1"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cremini/skillpack",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Pack AI Skills into Local Agents",
   "type": "module",
   "repository": {