fix(openclaw): serve bundled resource paths in skill commands; clear stale generated dirs

Two follow-ups for multi-file skill support:

- commands/skills.ts served only SKILL.md text, so bundled commands for
  multi-file skills directed the assistant to references/ files it was
  never given. Each command now appends a 'Bundled resource files'
  section mapping every relative resource path to its absolute installed
  location, so the assistant can read them with its own file tools.
  Single-file skills are unchanged (no section emitted); evals/ is
  excluded as test fixtures.

- fetch-skills.ts merged into existing output dirs on rerun, so files
  deleted or renamed in a source skill survived as stale artifacts in
  the published package. The generated skill dir is now removed before
  copying.

Verified: fetcher rerun clears planted stale files; mock-API command
registration shows the /onboarding text mapping all four references
with evals excluded, and single-file skills emitting no section.

Signed-off-by: Cody Faust <cody@luminarysol.com>

Author: cfaust990

integrations/openclaw/commands/skills.ts

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync } from "node:fs"
+import { existsSync, readFileSync, readdirSync } from "node:fs"
 import { dirname, resolve } from "node:path"
 import { fileURLToPath } from "node:url"
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry"
@@ -39,13 +39,62 @@ function loadSkill(skillsDir: string, dir: string): string {
   return readFileSync(resolve(skillsDir, dir, "SKILL.md"), "utf-8")
 }
 
+/**
+ * List a skill's bundled resource files (references/, assets/, ...) so the
+ * command can tell the assistant where they live on disk. SKILL.md workflows
+ * reference these by relative path; without the mapping, bundled commands
+ * would direct the assistant to files it was never given. evals/ is excluded
+ * as test fixtures.
+ */
+function listResourceFiles(skillsDir: string, dir: string): string[] {
+  const root = resolve(skillsDir, dir)
+  const files: string[] = []
+  const walk = (rel: string) => {
+    for (const entry of readdirSync(resolve(root, rel), {
+      withFileTypes: true,
+    })) {
+      const relPath = rel ? `${rel}/${entry.name}` : entry.name
+      if (entry.isDirectory()) {
+        if (relPath !== "evals") walk(relPath)
+      } else if (relPath !== "SKILL.md") {
+        files.push(relPath)
+      }
+    }
+  }
+  walk("")
+  return files.sort()
+}
+
+function resourceSection(
+  skillsDir: string,
+  dir: string,
+  files: string[],
+): string {
+  if (files.length === 0) return ""
+  const lines = files
+    .map((f) => `- \`${f}\` → ${resolve(skillsDir, dir, f)}`)
+    .join("\n")
+  return (
+    "\n\n## Bundled resource files\n\n" +
+    "This skill references companion files by relative path. They are installed at:\n\n" +
+    `${lines}\n\n` +
+    "When the workflow directs you to read one of these files, read it from the absolute path listed above."
+  )
+}
+
 export function registerSkillCommands(api: OpenClawPluginApi): void {
   const skillsDir = resolveSkillsDir(api)
   const manifest = loadManifest(skillsDir)
 
   for (const entry of manifest) {
     const commandName = entry.dir.replace(/^memory-/, "")
-    const content = loadSkill(skillsDir, entry.dir)
+    const content =
+      loadSkill(skillsDir, entry.dir) +
+      resourceSection(
+        skillsDir,
+        entry.dir,
+        listResourceFiles(skillsDir, entry.dir),
+      )
 
     api.registerCommand({
       name: commandName,

integrations/openclaw/scripts/fetch-skills.ts

@@ -12,6 +12,7 @@ import {
   mkdirSync,
   readdirSync,
   readFileSync,
+  rmSync,
   writeFileSync,
 } from "node:fs"
 import { dirname, resolve } from "node:path"
@@ -82,6 +83,9 @@ function main() {
     const meta = parseFrontmatter(content)
 
     const outDir = resolve(SKILLS_DIR, dir)
+    // Clear any previously generated copy so files deleted or renamed in
+    // the source skill don't survive as stale artifacts in the package.
+    rmSync(outDir, { recursive: true, force: true })
     mkdirSync(outDir, { recursive: true })
     writeFileSync(resolve(outDir, "SKILL.md"), content)