skill-tree 0.1.4 → 0.1.5

package/dist/cli/index.mjs

@@ -2,15 +2,17 @@
 import {
   CachedStorageAdapter,
   GitSyncAdapter,
+  Materializer,
   SkillBank,
   SkillGraphServer,
   VERSION,
   createDefaultSyncConfig
-} from "../chunk-OYHYXKXO.mjs";
-import "../chunk-PDPN7FW7.mjs";
+} from "../chunk-TEUB6DZR.mjs";
+import "../chunk-TWPEHDW4.mjs";
+import "../chunk-F3YEUQAP.mjs";
 
 // src/cli/index.ts
-import { Command as Command36 } from "commander";
+import { Command as Command38 } from "commander";
 
 // src/config/types.ts
 var DEFAULT_CONFIG = {
@@ -35,6 +37,14 @@ var DEFAULT_CONFIG = {
     output_format: "table",
     color: true,
     quiet: false
+  },
+  materialization: {
+    enabled: false,
+    mode: "symlink",
+    symlink_paths: [],
+    agents_md_path: "",
+    agents_md_format: "xml",
+    debounce_ms: 500
   }
 };
 
@@ -90,8 +100,8 @@ function substituteEnvVarsInObject(obj) {
   }
   return obj;
 }
-function setNestedProperty(obj, path7, value) {
-  const parts = path7.split(".");
+function setNestedProperty(obj, path8, value) {
+  const parts = path8.split(".");
   let current = obj;
   for (let i = 0; i < parts.length - 1; i++) {
     const part = parts[i];
@@ -250,8 +260,8 @@ var ConfigLoader = class {
   /**
    * Get a specific config value by path
    */
-  get(path7) {
-    const parts = path7.split(".");
+  get(path8) {
+    const parts = path8.split(".");
     let current = this.getConfig();
     for (const part of parts) {
       if (current === null || typeof current !== "object") {
@@ -304,6 +314,20 @@ cli:
   output_format: table
   color: true
   quiet: false
+
+materialization:
+  # Enable automatic materialization to agent-discoverable paths
+  enabled: false
+  # Mode: 'symlink' (default) or 'copy'
+  mode: symlink
+  # Directories to expose skills in (e.g. .claude/skills, .agent/skills)
+  symlink_paths: []
+  # Path to auto-generate AGENTS.md (empty = disabled)
+  agents_md_path: ""
+  # Format for AGENTS.md: xml, markdown, json
+  agents_md_format: xml
+  # Debounce interval in ms for batch updates
+  debounce_ms: 500
 `;
     fs.writeFileSync(expandPath(this.configPath), configContent);
   }
@@ -373,6 +397,19 @@ function ensureDir(dir) {
 }
 
 // src/cli/utils/skillbank.ts
+function getMaterializationConfig() {
+  const config2 = loadConfig();
+  const mat = config2.materialization;
+  if (!mat?.enabled) return void 0;
+  return {
+    enabled: true,
+    mode: mat.mode ?? "symlink",
+    symlinkPaths: mat.symlink_paths?.length ? mat.symlink_paths : void 0,
+    agentsMdPath: mat.agents_md_path || void 0,
+    agentsMdFormat: mat.agents_md_format ?? "xml",
+    debounceMs: mat.debounce_ms ?? 500
+  };
+}
 async function createSkillBankFromOptions(options) {
   const skillPath = resolveSkillPath(options.path);
   ensureDir(skillPath);
@@ -380,7 +417,8 @@ async function createSkillBankFromOptions(options) {
     storage: {
       basePath: skillPath,
       openSkillsCompatible: true
-    }
+    },
+    materialization: getMaterializationConfig()
   });
   await skillBank.initialize();
   return skillBank;
@@ -438,33 +476,10 @@ function formatSkillDetail(skill) {
   lines.push(chalk.dim("\u2500".repeat(50)));
   lines.push(skill.description);
   lines.push("");
-  lines.push(chalk.dim("Problem"));
-  lines.push(chalk.dim("\u2500".repeat(50)));
-  lines.push(skill.problem);
-  lines.push("");
-  if (skill.triggerConditions.length > 0) {
-    lines.push(chalk.dim("Trigger Conditions"));
-    lines.push(chalk.dim("\u2500".repeat(50)));
-    for (const trigger of skill.triggerConditions) {
-      const desc = trigger.description ? ` - ${trigger.description}` : "";
-      lines.push(`  ${chalk.cyan(trigger.type)}: ${trigger.value}${chalk.dim(desc)}`);
-    }
-    lines.push("");
-  }
-  lines.push(chalk.dim("Solution"));
-  lines.push(chalk.dim("\u2500".repeat(50)));
-  lines.push(skill.solution);
-  lines.push("");
-  if (skill.verification) {
-    lines.push(chalk.dim("Verification"));
+  if (skill.instructions) {
+    lines.push(chalk.dim("Instructions"));
     lines.push(chalk.dim("\u2500".repeat(50)));
-    lines.push(skill.verification);
-    lines.push("");
-  }
-  if (skill.notes) {
-    lines.push(chalk.dim("Notes"));
-    lines.push(chalk.dim("\u2500".repeat(50)));
-    lines.push(skill.notes);
+    lines.push(skill.instructions);
   }
   return lines.join("\n");
 }
@@ -859,225 +874,13 @@ import { Command as Command13 } from "commander";
 import * as fs4 from "fs";
 
 // src/import/converter.ts
-var DEFAULT_SECTION_PATTERNS = {
-  problem: [
-    /^#+\s*(?:problem|issue|what\s+problem|the\s+problem)/i,
-    /^#+\s*(?:why|motivation|background)/i
-  ],
-  solution: [
-    /^#+\s*(?:solution|how\s+to|implementation|approach)/i,
-    /^#+\s*(?:usage|instructions|steps)/i
-  ],
-  verification: [
-    /^#+\s*(?:verification|verify|testing|test|validate)/i,
-    /^#+\s*(?:how\s+to\s+verify|checking)/i
-  ],
-  examples: [
-    /^#+\s*(?:examples?|sample|demo)/i,
-    /^#+\s*(?:use\s+cases?|scenarios?)/i
-  ],
-  notes: [
-    /^#+\s*(?:notes?|caveats?|warnings?|tips?)/i,
-    /^#+\s*(?:additional|edge\s+cases?|considerations?)/i
-  ],
-  triggers: [
-    /^#+\s*(?:triggers?|when\s+to\s+use|conditions?)/i,
-    /^#+\s*(?:activation|applies\s+when)/i
-  ]
-};
-function parseMarkdownSections(content) {
-  const lines = content.split("\n");
-  const sections = {
-    remainingContent: ""
-  };
-  let currentSection = "remaining";
-  let currentContent = [];
-  const flushSection = () => {
-    const text = currentContent.join("\n").trim();
-    if (!text) return;
-    switch (currentSection) {
-      case "problem":
-        sections.problem = text;
-        break;
-      case "solution":
-        sections.solution = text;
-        break;
-      case "verification":
-        sections.verification = text;
-        break;
-      case "examples":
-        sections.examples = parseExamples(text);
-        break;
-      case "notes":
-        sections.notes = text;
-        break;
-      case "triggers":
-        sections.triggers = parseTriggerList(text);
-        break;
-      case "remaining":
-        sections.remainingContent += (sections.remainingContent ? "\n\n" : "") + text;
-        break;
-    }
-    currentContent = [];
-  };
-  for (const line of lines) {
-    let matchedSection = null;
-    for (const [section, sectionPatterns] of Object.entries(DEFAULT_SECTION_PATTERNS)) {
-      for (const pattern of sectionPatterns) {
-        if (pattern.test(line)) {
-          matchedSection = section;
-          break;
-        }
-      }
-      if (matchedSection) break;
-    }
-    if (matchedSection) {
-      flushSection();
-      currentSection = matchedSection;
-    } else {
-      currentContent.push(line);
-    }
-  }
-  flushSection();
-  return sections;
-}
-function parseExamples(text) {
-  const examples = [];
-  const exampleBlocks = text.split(/^###\s+/m).filter(Boolean);
-  for (const block of exampleBlocks) {
-    const lines = block.split("\n");
-    const scenario = lines[0]?.trim() || "Example";
-    const content = lines.slice(1).join("\n");
-    const beforeMatch = content.match(/(?:before|input|given)[:\s]*\n?([\s\S]*?)(?=(?:after|output|then|result)|$)/i);
-    const afterMatch = content.match(/(?:after|output|then|result)[:\s]*\n?([\s\S]*?)$/i);
-    if (beforeMatch || afterMatch) {
-      examples.push({
-        scenario,
-        before: beforeMatch?.[1]?.trim() || "",
-        after: afterMatch?.[1]?.trim() || content.trim()
-      });
-    } else {
-      examples.push({
-        scenario,
-        before: "",
-        after: content.trim()
-      });
-    }
-  }
-  if (examples.length === 0 && text.trim()) {
-    examples.push({
-      scenario: "Example usage",
-      before: "",
-      after: text.trim()
-    });
-  }
-  return examples;
-}
-function parseTriggerList(text) {
-  const triggers = [];
-  const listItems = text.match(/^[\s]*[-*•]\s*(.+)$/gm) || text.match(/^[\s]*\d+\.\s*(.+)$/gm);
-  if (listItems) {
-    for (const item of listItems) {
-      const cleaned = item.replace(/^[\s]*[-*•\d.]+\s*/, "").trim();
-      if (cleaned) triggers.push(cleaned);
-    }
-  } else {
-    triggers.push(...text.split("\n").map((t) => t.trim()).filter(Boolean));
-  }
-  return triggers;
-}
-function inferTriggerType(text) {
-  const lower = text.toLowerCase();
-  if (lower.includes("error") || lower.includes("exception") || lower.includes("fail")) {
-    return { type: "error", value: text, description: "Triggered by error conditions" };
-  }
-  if (lower.includes("pattern") || lower.includes("regex") || lower.includes("match")) {
-    return { type: "pattern", value: text };
-  }
-  if (lower.includes("when") || lower.includes("context") || lower.includes("if ")) {
-    return { type: "context", value: text };
-  }
-  return { type: "keyword", value: text };
-}
-function extractKeywordsFromDescription(description) {
-  const keywords = [];
-  const techPatterns = [
-    /\b(react|vue|angular|svelte|next\.?js|nuxt)\b/gi,
-    /\b(node\.?js|deno|bun|python|rust|go|java|typescript|javascript)\b/gi,
-    /\b(docker|kubernetes|k8s|aws|gcp|azure)\b/gi,
-    /\b(git|github|gitlab|npm|yarn|pnpm)\b/gi,
-    /\b(sql|postgres|mysql|mongodb|redis)\b/gi,
-    /\b(api|rest|graphql|grpc)\b/gi,
-    /\b(test|testing|jest|vitest|pytest)\b/gi
-  ];
-  for (const pattern of techPatterns) {
-    const matches = description.match(pattern);
-    if (matches) {
-      keywords.push(...matches.map((m) => m.toLowerCase()));
-    }
-  }
-  return [...new Set(keywords)];
-}
-function extractTriggerConditions(skill, sections) {
-  const conditions = [];
-  if (sections?.triggers) {
-    for (const trigger of sections.triggers) {
-      conditions.push(inferTriggerType(trigger));
-    }
-  }
-  const keywords = extractKeywordsFromDescription(skill.description);
-  for (const keyword of keywords) {
-    if (!conditions.some((c) => c.value.toLowerCase() === keyword.toLowerCase())) {
-      conditions.push({
-        type: "keyword",
-        value: keyword,
-        description: "Keyword from description"
-      });
-    }
-  }
-  if (skill.tags) {
-    for (const tag of skill.tags.slice(0, 5)) {
-      if (!conditions.some((c) => c.value.toLowerCase() === tag.toLowerCase())) {
-        conditions.push({
-          type: "keyword",
-          value: tag,
-          description: "Tag from classification"
-        });
-      }
-    }
-  }
-  if (conditions.length === 0) {
-    conditions.push({
-      type: "context",
-      value: skill.description.substring(0, 100),
-      description: "Generated from skill description"
-    });
-  }
-  return conditions;
-}
 function convertIndexerSkill(indexerSkill) {
   const warnings = [];
-  const sections = parseMarkdownSections(indexerSkill.content);
-  const hasStructuredContent = !!(sections.problem || sections.solution || sections.verification || sections.examples?.length);
+  const instructions = indexerSkill.content || "";
+  const hasStructuredContent = instructions.trim().length > 0;
   if (!hasStructuredContent) {
-    warnings.push("No structured content sections found, using raw content");
-  }
-  const triggerConditions = extractTriggerConditions(indexerSkill, sections);
-  let examples = sections.examples || [];
-  if (examples.length === 0) {
-    examples = [{
-      scenario: "Usage example",
-      before: "",
-      after: indexerSkill.content.substring(0, 500)
-    }];
-    warnings.push("No examples found, created placeholder");
-  }
-  const problem = sections.problem || indexerSkill.description;
-  const solution = sections.solution || indexerSkill.content;
-  const verification = sections.verification || "Verify the skill output meets expectations";
-  if (!sections.problem) warnings.push("No problem section found, using description");
-  if (!sections.solution) warnings.push("No solution section found, using full content");
-  if (!sections.verification) warnings.push("No verification section found, using default");
+    warnings.push("No content found, instructions will be empty");
+  }
   const tags = [...indexerSkill.tags || []];
   if (indexerSkill.sourceRepo) {
     const repoName = indexerSkill.sourceRepo.split("/").pop();
@@ -1086,26 +889,12 @@ function convertIndexerSkill(indexerSkill) {
     }
   }
   const status = indexerSkill.status === "indexed" ? "active" : indexerSkill.status === "raw" ? "draft" : "draft";
-  let notes = sections.notes || void 0;
-  if (indexerSkill.classificationReasoning) {
-    const classificationNote = `
-
----
-Classification: ${indexerSkill.primaryPath?.join(" > ") || "uncategorized"}
-Reasoning: ${indexerSkill.classificationReasoning}`;
-    notes = (notes || "") + classificationNote;
-  }
   const skill = {
     id: indexerSkill.slug,
     name: indexerSkill.displayName || indexerSkill.name,
     version: indexerSkill.version,
     description: indexerSkill.description,
-    problem,
-    triggerConditions,
-    solution,
-    verification,
-    examples,
-    notes,
+    instructions,
     author: indexerSkill.author,
     tags,
     createdAt: new Date(indexerSkill.scrapedAt),
@@ -1176,7 +965,7 @@ function parseIndexerExport(content) {
 function isSkillTreeSkill(obj) {
   if (typeof obj !== "object" || obj === null) return false;
   const skill = obj;
-  return typeof skill.id === "string" && typeof skill.name === "string" && typeof skill.version === "string" && typeof skill.problem === "string" && typeof skill.solution === "string" && Array.isArray(skill.triggerConditions) && typeof skill.metrics === "object";
+  return typeof skill.id === "string" && typeof skill.name === "string" && typeof skill.version === "string" && typeof skill.instructions === "string" && typeof skill.metrics === "object";
 }
 function isIndexerSkill(obj) {
   if (typeof obj !== "object" || obj === null) return false;
@@ -1590,7 +1379,7 @@ var IndexerService = class {
   detectSkillRelationships(skill, allSkills) {
     const relationships = [];
     const skillId = skill.id || skill.slug;
-    const skillContent = `${skill.name} ${skill.description} ${skill.problem || ""} ${skill.solution || ""} ${skill.content || ""}`.toLowerCase();
+    const skillContent = `${skill.name} ${skill.description} ${skill.instructions || ""} ${skill.content || ""}`.toLowerCase();
     for (const other of allSkills) {
       const otherId = other.id || other.slug;
       if (otherId === skillId) continue;
@@ -3439,18 +3228,142 @@ function resolveCommand() {
   });
 }
 
+// src/cli/commands/read.ts
+import { Command as Command23 } from "commander";
+import * as path6 from "path";
+function serializeSkillMd(skill) {
+  const lines = [];
+  lines.push("---");
+  lines.push(`name: ${skill.name}`);
+  lines.push(`description: |`);
+  lines.push(`  ${skill.description}`);
+  lines.push(`version: ${skill.version}`);
+  if (skill.tags.length > 0) {
+    lines.push(`tags:`);
+    for (const tag of skill.tags) {
+      lines.push(`  - ${tag}`);
+    }
+  }
+  lines.push("---");
+  lines.push("");
+  lines.push(skill.instructions);
+  return lines.join("\n");
+}
+async function resolveSkill(bank, query) {
+  const exact = await bank.getSkill(query);
+  if (exact) return { skill: exact, fuzzy: false };
+  const results = await bank.searchSkills(query);
+  if (results.length > 0) {
+    return { skill: results[0], fuzzy: true };
+  }
+  return null;
+}
+var readCommand = new Command23("read").description("Read skill(s) to stdout (for agent activation)").argument("<names>", "Skill name(s), comma-separated").action(async (names, _options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const skillBank = await createSkillBankFromOptions(globalOpts);
+    const basePath = getSkillPath(globalOpts);
+    const nameList = names.split(",").map((n) => n.trim()).filter(Boolean);
+    for (const name of nameList) {
+      const result = await resolveSkill(skillBank, name);
+      if (!result) {
+        printError(`Skill not found: ${name}`);
+        process.exit(1);
+      }
+      const { skill, fuzzy } = result;
+      if (fuzzy) {
+        console.log(`Reading: ${skill.name} (matched: ${skill.id})`);
+      } else {
+        console.log(`Reading: ${skill.name}`);
+      }
+      const skillDir = path6.join(basePath, ".skilltree", "skills", skill.id);
+      console.log(`Base directory: ${skillDir}`);
+      console.log("");
+      console.log(serializeSkillMd(skill));
+      console.log("");
+      console.log(`Skill read: ${skill.name}`);
+      if (nameList.length > 1 && name !== nameList[nameList.length - 1]) {
+        console.log("---");
+      }
+    }
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
+// src/cli/commands/materialize.ts
+import { Command as Command24 } from "commander";
+var materializeCommand = new Command24("materialize").description("Materialize skills to agent-discoverable paths").option("--paths <dirs>", "Comma-separated target directories (e.g. .claude/skills,.agent/skills)").option("--agents-md <path>", "Path to write AGENTS.md").option("--format <format>", "AGENTS.md format: xml, markdown, json", "xml").option("--mode <mode>", "Materialization mode: symlink or copy", "symlink").option("-w, --watch", "Watch for changes and re-materialize").action(async (options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    if (!options.paths && !options.agentsMd) {
+      printError("Specify at least --paths or --agents-md");
+      console.log("");
+      printInfo("Examples:");
+      console.log("  skill-tree materialize --paths .claude/skills,.agent/skills");
+      console.log("  skill-tree materialize --agents-md ./AGENTS.md");
+      console.log("  skill-tree materialize --paths .claude/skills --agents-md ./AGENTS.md --mode copy");
+      process.exit(1);
+    }
+    const skillBank = await createSkillBankFromOptions(globalOpts);
+    const storage = skillBank.getStorage();
+    const basePath = getSkillPath(globalOpts);
+    const symlinkPaths = options.paths ? options.paths.split(",").map((p) => p.trim()).filter(Boolean) : [];
+    const config2 = {
+      enabled: true,
+      mode: options.mode ?? "symlink",
+      symlinkPaths,
+      agentsMdPath: options.agentsMd,
+      agentsMdFormat: options.format ?? "xml",
+      debounceMs: 500
+    };
+    const materializer = new Materializer(storage, basePath, config2);
+    await materializer.initialize();
+    const skills = await storage.listSkills();
+    printSuccess(`Materialized ${skills.length} skill(s)`);
+    if (symlinkPaths.length > 0) {
+      const modeLabel = config2.mode === "copy" ? "Copied" : "Symlinked";
+      for (const p of symlinkPaths) {
+        printInfo(`${modeLabel} to: ${p}`);
+      }
+    }
+    if (options.agentsMd) {
+      printInfo(`AGENTS.md written to: ${options.agentsMd}`);
+    }
+    if (options.watch) {
+      printInfo("Watching for changes... (Ctrl+C to stop)");
+      printWarning(
+        "Note: Only detects changes to .skilltree/skills/. Changes via the SkillBank API are handled automatically when materialization is enabled in config."
+      );
+      materializer.watch();
+      await new Promise((resolve3) => {
+        process.on("SIGINT", () => {
+          materializer.shutdown();
+          resolve3();
+        });
+      });
+    } else {
+      materializer.shutdown();
+    }
+  } catch (error) {
+    printError(error.message);
+    process.exit(1);
+  }
+});
+
 // src/cli/commands/loadout/index.ts
-import { Command as Command35 } from "commander";
+import { Command as Command37 } from "commander";
 
 // src/cli/commands/loadout/list.ts
-import { Command as Command23 } from "commander";
+import { Command as Command25 } from "commander";
 
 // src/serving/state-persistence.ts
 import * as fs9 from "fs";
-import * as path6 from "path";
+import * as path7 from "path";
 var STATE_FILENAME = ".loadout-state.json";
 function loadState(skillPath) {
-  const filePath = path6.join(skillPath, STATE_FILENAME);
+  const filePath = path7.join(skillPath, STATE_FILENAME);
   try {
     const raw = fs9.readFileSync(filePath, "utf-8");
     const data = JSON.parse(raw);
@@ -3466,7 +3379,7 @@ function loadState(skillPath) {
   }
 }
 function saveState(skillPath, state) {
-  const filePath = path6.join(skillPath, STATE_FILENAME);
+  const filePath = path7.join(skillPath, STATE_FILENAME);
   const data = {
     available: Array.from(state.available.entries()),
     expanded: Array.from(state.expanded),
@@ -3477,7 +3390,7 @@ function saveState(skillPath, state) {
   fs9.writeFileSync(filePath, JSON.stringify(data, null, 2));
 }
 function clearState(skillPath) {
-  const filePath = path6.join(skillPath, STATE_FILENAME);
+  const filePath = path7.join(skillPath, STATE_FILENAME);
   try {
     fs9.unlinkSync(filePath);
     return true;
@@ -3509,7 +3422,7 @@ async function createLoadoutServer(options) {
 }
 
 // src/cli/commands/loadout/list.ts
-var listSubcommand = new Command23("list").description("List skills in the current loadout").option("-f, --filter <filter>", "Filter: all, expanded, available, pending", "all").action(async (options, command) => {
+var listSubcommand = new Command25("list").description("List skills in the current loadout").option("-f, --filter <filter>", "Filter: all, expanded, available, pending", "all").action(async (options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server } = await createLoadoutServer(globalOpts);
@@ -3553,8 +3466,8 @@ var listSubcommand = new Command23("list").description("List skills in the curre
 });
 
 // src/cli/commands/loadout/search.ts
-import { Command as Command24 } from "commander";
-var searchSubcommand = new Command24("search").description("Search for skills to add to the loadout").argument("<query>", "Search query").option("-l, --limit <n>", "Maximum results", "10").action(async (query, options, command) => {
+import { Command as Command26 } from "commander";
+var searchSubcommand = new Command26("search").description("Search for skills to add to the loadout").argument("<query>", "Search query").option("-l, --limit <n>", "Maximum results", "10").action(async (query, options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server } = await createLoadoutServer(globalOpts);
@@ -3584,8 +3497,8 @@ var searchSubcommand = new Command24("search").description("Search for skills to
 });
 
 // src/cli/commands/loadout/add.ts
-import { Command as Command25 } from "commander";
-var addSubcommand = new Command25("add").description("Add skills to the loadout").argument("<ids...>", "Skill IDs to add").action(async (ids, _options, command) => {
+import { Command as Command27 } from "commander";
+var addSubcommand = new Command27("add").description("Add skills to the loadout").argument("<ids...>", "Skill IDs to add").action(async (ids, _options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server, save } = await createLoadoutServer(globalOpts);
@@ -3603,8 +3516,8 @@ var addSubcommand = new Command25("add").description("Add skills to the loadout"
 });
 
 // src/cli/commands/loadout/remove.ts
-import { Command as Command26 } from "commander";
-var removeSubcommand = new Command26("remove").description("Remove skills from the loadout").argument("<ids...>", "Skill IDs to remove").action(async (ids, _options, command) => {
+import { Command as Command28 } from "commander";
+var removeSubcommand = new Command28("remove").description("Remove skills from the loadout").argument("<ids...>", "Skill IDs to remove").action(async (ids, _options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server, save } = await createLoadoutServer(globalOpts);
@@ -3622,8 +3535,8 @@ var removeSubcommand = new Command26("remove").description("Remove skills from t
 });
 
 // src/cli/commands/loadout/profile.ts
-import { Command as Command27 } from "commander";
-var profileSubcommand = new Command27("profile").description("Switch to a named skill profile").argument("[name]", "Profile name (e.g. debugging, security, code-review)").option("--list", "List available profiles").action(async (name, options, command) => {
+import { Command as Command29 } from "commander";
+var profileSubcommand = new Command29("profile").description("Switch to a named skill profile").argument("[name]", "Profile name (e.g. debugging, security, code-review)").option("--list", "List available profiles").action(async (name, options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server, save } = await createLoadoutServer(globalOpts);
@@ -3654,8 +3567,8 @@ var profileSubcommand = new Command27("profile").description("Switch to a named
 });
 
 // src/cli/commands/loadout/set.ts
-import { Command as Command28 } from "commander";
-var setSubcommand = new Command28("set").description("Set loadout from criteria (tags, task description, etc.)").option("--tags <tags>", "Comma-separated tags to match").option("--task <description>", "Task description for semantic matching").option("--max-skills <n>", "Maximum number of skills").action(async (options, command) => {
+import { Command as Command30 } from "commander";
+var setSubcommand = new Command30("set").description("Set loadout from criteria (tags, task description, etc.)").option("--tags <tags>", "Comma-separated tags to match").option("--task <description>", "Task description for semantic matching").option("--max-skills <n>", "Maximum number of skills").action(async (options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server, save } = await createLoadoutServer(globalOpts);
@@ -3684,8 +3597,8 @@ var setSubcommand = new Command28("set").description("Set loadout from criteria
 });
 
 // src/cli/commands/loadout/expand.ts
-import { Command as Command29 } from "commander";
-var expandSubcommand = new Command29("expand").description("Expand a skill to see its full content").argument("<id>", "Skill ID to expand").action(async (id, _options, command) => {
+import { Command as Command31 } from "commander";
+var expandSubcommand = new Command31("expand").description("Expand a skill to see its full content").argument("<id>", "Skill ID to expand").action(async (id, _options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server, save } = await createLoadoutServer(globalOpts);
@@ -3710,8 +3623,8 @@ var expandSubcommand = new Command29("expand").description("Expand a skill to se
 });
 
 // src/cli/commands/loadout/collapse.ts
-import { Command as Command30 } from "commander";
-var collapseSubcommand = new Command30("collapse").description("Collapse an expanded skill back to summary").argument("<id>", "Skill ID to collapse").action(async (id, _options, command) => {
+import { Command as Command32 } from "commander";
+var collapseSubcommand = new Command32("collapse").description("Collapse an expanded skill back to summary").argument("<id>", "Skill ID to collapse").action(async (id, _options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server, save } = await createLoadoutServer(globalOpts);
@@ -3733,8 +3646,8 @@ var collapseSubcommand = new Command30("collapse").description("Collapse an expa
 });
 
 // src/cli/commands/loadout/use.ts
-import { Command as Command31 } from "commander";
-var useSubcommand = new Command31("use").description("Mark a skill as being used (auto-expands and records usage)").argument("<id>", "Skill ID to use").action(async (id, _options, command) => {
+import { Command as Command33 } from "commander";
+var useSubcommand = new Command33("use").description("Mark a skill as being used (auto-expands and records usage)").argument("<id>", "Skill ID to use").action(async (id, _options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server, save } = await createLoadoutServer(globalOpts);
@@ -3760,8 +3673,8 @@ var useSubcommand = new Command31("use").description("Mark a skill as being used
 });
 
 // src/cli/commands/loadout/get.ts
-import { Command as Command32 } from "commander";
-var getSubcommand = new Command32("get").description("Get details about a skill in the loadout").argument("<id>", "Skill ID").action(async (id, _options, command) => {
+import { Command as Command34 } from "commander";
+var getSubcommand = new Command34("get").description("Get details about a skill in the loadout").argument("<id>", "Skill ID").action(async (id, _options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server } = await createLoadoutServer(globalOpts);
@@ -3783,8 +3696,8 @@ var getSubcommand = new Command32("get").description("Get details about a skill
 });
 
 // src/cli/commands/loadout/render.ts
-import { Command as Command33 } from "commander";
-var renderSubcommand = new Command33("render").description("Render the current loadout as a system prompt (XML or Markdown)").option("--format <format>", "Output format: xml or markdown", "xml").action(async (options, command) => {
+import { Command as Command35 } from "commander";
+var renderSubcommand = new Command35("render").description("Render the current loadout as a system prompt (XML or Markdown)").option("--format <format>", "Output format: xml or markdown", "xml").action(async (options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server } = await createLoadoutServer(globalOpts);
@@ -3802,8 +3715,8 @@ var renderSubcommand = new Command33("render").description("Render the current l
 });
 
 // src/cli/commands/loadout/clear.ts
-import { Command as Command34 } from "commander";
-var clearSubcommand = new Command34("clear").description("Clear the current loadout state").action(async (_options, command) => {
+import { Command as Command36 } from "commander";
+var clearSubcommand = new Command36("clear").description("Clear the current loadout state").action(async (_options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const skillPath = resolveSkillPath(globalOpts.path);
@@ -3824,10 +3737,10 @@ var clearSubcommand = new Command34("clear").description("Clear the current load
 });
 
 // src/cli/commands/loadout/index.ts
-var loadoutCommand = new Command35("loadout").description("Manage skill loadouts for agent sessions").addCommand(listSubcommand).addCommand(searchSubcommand).addCommand(addSubcommand).addCommand(removeSubcommand).addCommand(profileSubcommand).addCommand(setSubcommand).addCommand(expandSubcommand).addCommand(collapseSubcommand).addCommand(useSubcommand).addCommand(getSubcommand).addCommand(renderSubcommand).addCommand(clearSubcommand);
+var loadoutCommand = new Command37("loadout").description("Manage skill loadouts for agent sessions").addCommand(listSubcommand).addCommand(searchSubcommand).addCommand(addSubcommand).addCommand(removeSubcommand).addCommand(profileSubcommand).addCommand(setSubcommand).addCommand(expandSubcommand).addCommand(collapseSubcommand).addCommand(useSubcommand).addCommand(getSubcommand).addCommand(renderSubcommand).addCommand(clearSubcommand);
 
 // src/cli/index.ts
-var program = new Command36();
+var program = new Command38();
 var config = loadConfig();
 program.name("skill-tree").description("Management CLI for agent skills").version(VERSION).option("-p, --path <dir>", "Skills directory path", config.storage.path).option("-c, --config <file>", "Config file path", getConfigPath()).option("--json", "Output as JSON", config.cli.output_format === "json").option("-q, --quiet", "Suppress non-essential output", config.cli.quiet).option("--no-color", "Disable colored output", !config.cli.color);
 program.addCommand(listCommand);
@@ -3846,5 +3759,7 @@ program.addCommand(importCommand);
 program.addCommand(indexerCommand);
 program.addCommand(configCommand);
 program.addCommand(syncCommand2);
+program.addCommand(readCommand);
+program.addCommand(materializeCommand);
 program.addCommand(loadoutCommand);
 program.parse();