create-cascade-skill 0.1.6 → 0.1.7

package/index.js

@@ -1,44 +1,42 @@
 #!/usr/bin/env node
-
-import { existsSync, mkdirSync, writeFileSync } from "node:fs"
-import { resolve, join } from "node:path"
-import process from "node:process"
-import { spawnSync } from "node:child_process"
-import { createInterface } from "node:readline/promises"
-import { emitKeypressEvents } from "node:readline"
-
-const ANSI_RESET = "\x1b[0m"
-const ANSI_BOLD = "\x1b[1m"
-const ANSI_DIM = "\x1b[2m"
-const ANSI_CYAN = "\x1b[36m"
-const ANSI_GREEN = "\x1b[32m"
-const ANSI_YELLOW = "\x1b[33m"
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { resolve, join } from "node:path";
+import process from "node:process";
+import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+import { emitKeypressEvents } from "node:readline";
+
+const ANSI_RESET = "\x1b[0m";
+const ANSI_BOLD = "\x1b[1m";
+const ANSI_DIM = "\x1b[2m";
+const ANSI_CYAN = "\x1b[36m";
+const ANSI_GREEN = "\x1b[32m";
+const ANSI_YELLOW = "\x1b[33m";
 
 function getHomeDirectory() {
-  return process.env.HOME || process.env.USERPROFILE || process.cwd()
+  return process.env.HOME || process.env.USERPROFILE || process.cwd();
 }
 
 function commandExists(command) {
-  const lookup = process.platform === "win32" ? "where" : "which"
-  const result = spawnSync(lookup, [command], { stdio: "ignore" })
-  return result.status === 0
+  const lookup = process.platform === "win32" ? "where" : "which";
+  const result = spawnSync(lookup, [command], { stdio: "ignore" });
+  return result.status === 0;
 }
 
 function parseAgentsArg(value) {
   return value
     .split(",")
     .map((part) => part.trim().toLowerCase())
-    .filter((part) => part.length > 0)
+    .filter((part) => part.length > 0);
 }
 
 function unique(items) {
-  return [...new Set(items)]
+  return [...new Set(items)];
 }
 
 function getAgents() {
-  const home = getHomeDirectory()
-  const appData = process.env.APPDATA || join(home, "AppData", "Roaming")
-
+  const home = getHomeDirectory();
+  const appData = process.env.APPDATA || join(home, "AppData", "Roaming");
   return [
     {
       id: "codex",
@@ -73,7 +71,14 @@ function getAgents() {
       description: "Install in ~/.codeium/windsurf/skills/cascadetui/SKILL.md",
       commands: ["windsurf"],
       detectPaths: [join(home, ".codeium"), join(appData, "Codeium")],
-      installPath: join(home, ".codeium", "windsurf", "skills", "cascadetui", "SKILL.md"),
+      installPath: join(
+        home,
+        ".codeium",
+        "windsurf",
+        "skills",
+        "cascadetui",
+        "SKILL.md"
+      ),
       flavor: "generic",
     },
     {
@@ -136,7 +141,14 @@ function getAgents() {
       description: "Install in ~/.config/goose/skills/cascadetui/SKILL.md",
       commands: ["goose"],
       detectPaths: [join(home, ".config", "goose"), join(appData, "goose")],
-      installPath: join(home, ".config", "goose", "skills", "cascadetui", "SKILL.md"),
+      installPath: join(
+        home,
+        ".config",
+        "goose",
+        "skills",
+        "cascadetui",
+        "SKILL.md"
+      ),
       flavor: "generic",
     },
     {
@@ -148,414 +160,489 @@ function getAgents() {
       installPath: join(home, ".ami", "skills", "cascadetui", "SKILL.md"),
       flavor: "generic",
     },
-  ]
+  ];
 }
 
 function parseArgs(argv) {
-  const args = argv.slice(2)
+  const args = argv.slice(2);
   const options = {
     agents: [],
     allDetected: false,
     list: false,
     dryRun: false,
     help: false,
-  }
-
+  };
   for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i]
-
+    const arg = args[i];
     if (arg === "--agents" || arg === "-a") {
-      options.agents.push(...parseAgentsArg(args[i + 1] || ""))
-      i += 1
-      continue
+      options.agents.push(...parseAgentsArg(args[i + 1] || ""));
+      i += 1;
+      continue;
     }
     if (arg.startsWith("--agents=")) {
-      options.agents.push(...parseAgentsArg(arg.slice("--agents=".length)))
-      continue
+      options.agents.push(...parseAgentsArg(arg.slice("--agents=".length)));
+      continue;
     }
     if (arg === "--all-detected") {
-      options.allDetected = true
-      continue
+      options.allDetected = true;
+      continue;
     }
     if (arg === "--list") {
-      options.list = true
-      continue
+      options.list = true;
+      continue;
     }
     if (arg === "--dry-run") {
-      options.dryRun = true
-      continue
+      options.dryRun = true;
+      continue;
     }
     if (arg === "--help" || arg === "-h") {
-      options.help = true
-      continue
+      options.help = true;
+      continue;
     }
-    throw new Error(`Unknown argument: ${arg}`)
+    throw new Error(`Unknown argument: ${arg}`);
   }
-
-  options.agents = unique(options.agents)
-  return options
+  options.agents = unique(options.agents);
+  return options;
 }
 
 function printHelp() {
-  console.log("Usage: npx create-cascade-skill [options]")
-  console.log("")
-  console.log("Options:")
-  console.log("  -a, --agents <ids>    Comma-separated agent IDs to install")
-  console.log("  --all-detected        Install for all detected agents")
-  console.log("  --list                Print supported and detected agents")
-  console.log("  --dry-run             Preview files without writing")
-  console.log("  -h, --help            Show help")
-  console.log("")
-  console.log("Examples:")
-  console.log("  npx create-cascade-skill")
-  console.log("  npx create-cascade-skill --all-detected")
-  console.log("  npx create-cascade-skill --agents codex,cursor,cline")
-  console.log("  npx create-cascade-skill --agents codex --dry-run")
+  console.log("Usage: npx create-cascade-skill [options]");
+  console.log("");
+  console.log("Options:");
+  console.log("  -a, --agents <ids>    Comma-separated agent IDs to install");
+  console.log("  --all-detected        Install for all detected agents");
+  console.log("  --list                Print supported and detected agents");
+  console.log("  --dry-run             Preview files without writing");
+  console.log("  -h, --help            Show help");
+  console.log("");
+  console.log("Examples:");
+  console.log("  npx create-cascade-skill");
+  console.log("  npx create-cascade-skill --all-detected");
+  console.log("  npx create-cascade-skill --agents codex,cursor,cline");
+  console.log("  npx create-cascade-skill --agents codex --dry-run");
 }
 
 function detectAgents(agents) {
   return agents.map((agent) => {
-    const commandHit = agent.commands.some((command) => commandExists(command))
-    const pathHit = agent.detectPaths.some((path) => existsSync(path))
-    return { ...agent, detected: commandHit || pathHit }
-  })
+    const commandHit = agent.commands.some((command) => commandExists(command));
+    const pathHit = agent.detectPaths.some((path) => existsSync(path));
+    return { ...agent, detected: commandHit || pathHit };
+  });
 }
 
 function printList(agents) {
-  console.log(`${ANSI_BOLD}Supported agents${ANSI_RESET}`)
+  console.log(`${ANSI_BOLD}Supported agents${ANSI_RESET}`);
   for (const agent of agents) {
-    const marker = agent.detected ? `${ANSI_GREEN}detected${ANSI_RESET}` : `${ANSI_YELLOW}not detected${ANSI_RESET}`
-    console.log(`- ${agent.id.padEnd(12)} ${marker}  ${agent.label}`)
+    const marker = agent.detected
+      ? `${ANSI_GREEN}detected${ANSI_RESET}`
+      : `${ANSI_YELLOW}not detected${ANSI_RESET}`;
+    console.log(`- ${agent.id.padEnd(12)} ${marker}  ${agent.label}`);
   }
-
-  const detected = agents.filter((agent) => agent.detected).map((agent) => agent.id)
-  console.log("")
+  const detected = agents
+    .filter((agent) => agent.detected)
+    .map((agent) => agent.id);
+  console.log("");
   if (detected.length > 0) {
-    console.log(`Detected IDs: ${detected.join(", ")}`)
-    console.log(`Install all detected: npx create-cascade-skill --agents ${detected.join(",")}`)
+    console.log(`Detected IDs: ${detected.join(", ")}`);
+    console.log(
+      `Install all detected: npx create-cascade-skill --agents ${detected.join(
+        ","
+      )}`
+    );
   } else {
-    console.log("Detected IDs: none")
+    console.log("Detected IDs: none");
   }
 }
 
 function validateAgentIds(selected, agents) {
-  const allowed = new Set(agents.map((agent) => agent.id))
+  const allowed = new Set(agents.map((agent) => agent.id));
   for (const id of selected) {
     if (!allowed.has(id)) {
-      throw new Error(`Unknown agent id: ${id}`)
+      throw new Error(`Unknown agent id: ${id}`);
     }
   }
 }
 
 function promptLine(rl, label) {
-  return rl.question(label)
+  return rl.question(label);
 }
 
 function toSelectableOptions(agents) {
   return agents.map((agent) => ({
     id: agent.id,
     label: agent.label,
-    description: `${agent.description}${agent.detected ? " [detected]" : ""}`,
-  }))
+    description: `${agent.description}${agent.detected ? " [detected]" : ""
+      }`,
+  }));
 }
 
 async function selectMany(rl, label, options, preselectedIds) {
   if (!process.stdin.isTTY) {
-    return preselectedIds
+    return preselectedIds;
   }
-
-  const stdin = process.stdin
-  const stdout = process.stdout
-  let selectedIndex = 0
-  let selected = new Set(preselectedIds)
-  const totalLines = options.length + 3
-  let renderedOnce = false
-
+  const stdin = process.stdin;
+  const stdout = process.stdout;
+  let selectedIndex = 0;
+  let selected = new Set(preselectedIds);
+  const totalLines = options.length + 3;
+  let renderedOnce = false;
   const render = () => {
     if (renderedOnce) {
-      stdout.write(`\x1b[${totalLines}F`)
+      stdout.write(`\x1b[${totalLines}F`);
     } else {
-      stdout.write("\n")
+      stdout.write("\n");
     }
-
-    stdout.write(`${ANSI_BOLD}${label}${ANSI_RESET}\n`)
+    stdout.write(`${ANSI_BOLD}${label}${ANSI_RESET}\n`);
     for (let i = 0; i < options.length; i += 1) {
-      const option = options[i]
-      const isCursor = i === selectedIndex
-      const isSelected = selected.has(option.id)
-      const cursor = isCursor ? `${ANSI_BOLD}${ANSI_CYAN}>${ANSI_RESET}` : " "
-      const mark = isSelected ? `${ANSI_GREEN}[x]${ANSI_RESET}` : "[ ]"
-      const styleStart = isCursor ? `${ANSI_BOLD}${ANSI_CYAN}` : ""
-      const styleEnd = isCursor ? ANSI_RESET : ""
-      stdout.write(`${cursor} ${mark} ${styleStart}${option.label}${styleEnd} ${ANSI_DIM}(${option.id}) - ${option.description}${ANSI_RESET}\n`)
+      const option = options[i];
+      const isCursor = i === selectedIndex;
+      const isSelected = selected.has(option.id);
+      const cursor = isCursor
+        ? `${ANSI_BOLD}${ANSI_CYAN}>${ANSI_RESET}`
+        : " ";
+      const mark = isSelected
+        ? `${ANSI_GREEN}[x]${ANSI_RESET}`
+        : "[ ]";
+      const styleStart = isCursor ? `${ANSI_BOLD}${ANSI_CYAN}` : "";
+      const styleEnd = isCursor ? ANSI_RESET : "";
+      stdout.write(
+        `${cursor} ${mark} ${styleStart}${option.label}${styleEnd} ${ANSI_DIM}(${option.id}) - ${option.description}${ANSI_RESET}\n`
+      );
     }
-    stdout.write(`${ANSI_DIM}Use Up/Down, Space to toggle, A to toggle all, Enter to confirm${ANSI_RESET}\n`)
-    renderedOnce = true
-  }
-
+    stdout.write(
+      `${ANSI_DIM}Use Up/Down, Space to toggle, A to toggle all, Enter to confirm${ANSI_RESET}\n`
+    );
+    renderedOnce = true;
+  };
   return new Promise((resolvePromise, rejectPromise) => {
     const cleanup = () => {
-      stdin.off("keypress", onKeyPress)
+      stdin.off("keypress", onKeyPress);
       if (stdin.isTTY) {
-        stdin.setRawMode(false)
+        stdin.setRawMode(false);
       }
-      stdout.write("\n")
-    }
-
+      stdout.write("\n");
+    };
     const onKeyPress = (_, key) => {
       if (!key) {
-        return
+        return;
       }
-
       if (key.ctrl && key.name === "c") {
-        cleanup()
-        rejectPromise(new Error("Operation cancelled"))
-        return
+        cleanup();
+        rejectPromise(new Error("Operation cancelled"));
+        return;
       }
-
       if (key.name === "up") {
-        selectedIndex = selectedIndex === 0 ? options.length - 1 : selectedIndex - 1
-        render()
-        return
+        selectedIndex =
+          selectedIndex === 0 ? options.length - 1 : selectedIndex - 1;
+        render();
+        return;
       }
-
       if (key.name === "down") {
-        selectedIndex = selectedIndex === options.length - 1 ? 0 : selectedIndex + 1
-        render()
-        return
+        selectedIndex =
+          selectedIndex === options.length - 1 ? 0 : selectedIndex + 1;
+        render();
+        return;
       }
-
       if (key.name === "space") {
-        const id = options[selectedIndex].id
+        const id = options[selectedIndex].id;
         if (selected.has(id)) {
-          selected.delete(id)
+          selected.delete(id);
         } else {
-          selected.add(id)
+          selected.add(id);
         }
-        render()
-        return
+        render();
+        return;
       }
-
       if (key.name === "a") {
         if (selected.size === options.length) {
-          selected = new Set()
+          selected = new Set();
         } else {
-          selected = new Set(options.map((option) => option.id))
+          selected = new Set(options.map((option) => option.id));
         }
-        render()
-        return
+        render();
+        return;
       }
-
       if (key.name === "return") {
-        cleanup()
-        resolvePromise([...selected])
+        cleanup();
+        resolvePromise([...selected]);
       }
-    }
-
-    emitKeypressEvents(stdin)
-    stdin.setRawMode(true)
-    stdin.resume()
-    stdin.on("keypress", onKeyPress)
-    render()
-  })
+    };
+    emitKeypressEvents(stdin);
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.on("keypress", onKeyPress);
+    render();
+  });
 }
 
-function getBaseSkillFrontmatter() {
-  return `---
-name: cascadetui
-description: Build and maintain terminal UIs with CascadeTUI. Use when creating components, layouts, renderables, keyboard interactions, and debugging terminal UI behavior in Cascade-based projects.
-compatibility: Requires Bun and TypeScript. Designed for agents that support Agent Skills and SKILL.md frontmatter.
-metadata:
-  author: cascadetui
-  version: "1.0"
----`
+function getSkillFrontmatter(agent) {
+  const baseName = "cascadetui";
+  const description =
+    "Build terminal user interfaces with CascadeTUI. Use this skill when building, debugging, or refactoring Cascade-based TUIs. Triggers: Cascade, TUI, terminal UI, keyboard navigation, component layout.";
+  let compatibility = "Requires Bun and TypeScript.";
+  if (agent.flavor === "claude") {
+    compatibility += " Designed for Claude Code.";
+  } else if (agent.flavor === "cursor") {
+    compatibility += " Designed for Cursor.";
+  } else if (agent.flavor === "codex") {
+    compatibility += " Designed for OpenAI Codex.";
+  } else {
+    compatibility += ` Designed for ${agent.label}.`;
+  }
+  const allowedTools = "Bash(bun:*) Bash(npm:*) Bash(node:*)";
+  return (
+    `---\n` +
+    `name: ${baseName}\n` +
+    `description: ${description}\n` +
+    `compatibility: ${compatibility}\n` +
+    `allowed-tools: ${allowedTools}\n` +
+    `metadata:\n` +
+    `  author: cascadetui\n` +
+    `  version: "1.1"\n` +
+    `---`
+  );
 }
 
-function getBaseSkillBody() {
-  return `# CascadeTUI Skill
-
-## When To Use
-- Use this skill when the user is building or debugging a terminal UI with CascadeTUI.
-- Use this skill for component layout, rendering behavior, keyboard handling, and interaction logic.
-- Use this skill for scaffold and setup guidance in Cascade projects.
-
-## Instructions
-1. Prefer Bun commands and APIs.
-2. Prefer \`@cascadetui/core\` for low-level renderables unless the user explicitly asks for React or Solid.
-3. Use \`@cascadetui/react\` or \`@cascadetui/solid\` only when requested.
-4. Keep code minimal, typed, deterministic, and production-ready.
-5. Reproduce rendering bugs with a minimal reproducible test case before applying fixes.
-6. Validate keyboard, focus, and resize behavior for interactive components.
-
-## Scaffolding
-- \`bun create cascade my-app\`
-- \`cd my-app\`
-- \`bun install\`
-- \`bun run dev\`
-
-## Notes
-- Favor clear state transitions and predictable rendering.
-- Avoid adding dependencies that duplicate Bun runtime capabilities.
-`
+function getSkillBody() {
+  return `# Building Terminal UIs with CascadeTUI
+
+## When to Activate
+
+- Use this skill when asked to build, debug, or refactor a text-based user interface using the CascadeTUI library.
+- Trigger this skill if the user mentions "Cascade", "TUI", "terminal UI", "keyboard navigation", or "component layout".
+- Use when scaffolding new projects or customizing existing ones.
+
+## Key Principles
+
+- **Bun first**: Use the Bun runtime and its native package manager for running scripts and managing dependencies. Avoid using Node-specific commands or features unless absolutely required.
+- **Core Library**: The \`@cascadetui/core\` package provides the primitives for rendering, layout, and input handling. Use it for basic applications. Only reach for the React (\`@cascadetui/react\`) or Solid (\`@cascadetui/solid\`) wrappers when explicitly requested.
+- **Typed and deterministic**: Write TypeScript code with explicit types. Avoid dynamic evaluation and unpredictable side effects.
+- **Minimal reproducible examples**: When diagnosing issues, start by isolating the problem in a tiny script or component that reproduces the bug. Only after reproducing should you propose fixes.
+- **Interactive validation**: Test keyboard navigation, focus management, and resize events across multiple terminal sizes. Ensure accessible shortcuts and fallback navigation.
+
+## Typical Workflow
+
+1. **Scaffold a project**  
+   Use Bun's project generator to create a new CascadeTUI app:
+   \`\`\`bash
+   bun create cascade my-app
+   cd my-app
+   bun install
+   bun run dev
+   \`\`\`
+
+2. **Develop components**  
+   - Keep components pure and functions side-effect free where possible.  
+   - Compose layouts using containers (horizontal, vertical, grid) and ensure consistent spacing.  
+   - Use dedicated input handlers rather than global listeners.
+
+3. **Debug rendering**  
+   - If a component fails to render or update, add logging and ensure the state drives the UI deterministically.  
+   - Recreate the failing state in isolation.  
+   - Check for improper asynchronous updates.
+
+4. **Keyboard & interaction**  
+   - Provide intuitive key bindings with documentation.  
+   - Implement focus rings or highlight states.  
+   - Handle edge cases like simultaneous key presses, terminal resize, and loss of focus.
+
+5. **Performance considerations**  
+   - Avoid expensive re-renders inside tight loops.  
+   - Batch state updates where possible.  
+   - Profile for memory leaks or event listener accumulation.
+
+## Best Practices
+
+- **State management**: Use a predictable state container or simple \`useState\`-like patterns. Avoid hidden state.
+- **Testing**: Write unit tests for components and integration tests for complex flows. Use snapshot tests carefully.
+- **Documentation**: Document all public-facing components with usage examples and list supported props.
+- **Clean-up**: Remove unused dependencies and scripts. Keep the codebase tidy for readability.
+
+## Additional Resources
+
+- Official CascadeTUI documentation (if available).
+- Bun runtime documentation: https://bun.sh/docs for details on Bun-specific APIs.
+- Example projects in the CascadeTUI GitHub repository (if available).
+`;
 }
 
-function getClaudeAppendix() {
+function getImprovedClaudeAppendix() {
   return `## Documentation Index
-Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
-Use this file to discover all available pages before exploring further.
+
+Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt. Use this file to discover all available pages before exploring further.
 
 ## Claude Code Skill Notes
-- Keep this skill in a global location: \`~/.claude/skills/cascadetui/SKILL.md\`.
-- Skills can be auto-invoked by Claude when relevant, or manually via \`/cascadetui\`.
-- Keep the skill content concise and place optional supporting files beside \`SKILL.md\` when needed.
-`
-}
 
-function getCursorFrontmatter() {
-  return `---
-name: cascadetui
-description: Build and maintain terminal UIs with CascadeTUI. Use when creating components, layouts, renderables, keyboard interactions, and debugging terminal UI behavior in Cascade-based projects.
-compatibility: Cursor Agent Skills format with global installation under ~/.cursor/skills.
-metadata:
-  author: cascadetui
-  version: "1.0"
----`
+- Place this skill in a global location: \`~/.claude/skills/cascadetui/SKILL.md\`. Do not nest additional directories deeper than one level.
+- Claude automatically loads skills whose \`name\` and \`description\` fields match the user's request; keep them descriptive and concise.
+- Follow the naming conventions from the Agent Skills specification: lowercase alphanumeric and hyphens only, no reserved words (anthropic, claude).
+- Use progressive disclosure: keep \`SKILL.md\` under 500 lines and move lengthy instructions to \`references/\` files.
+- Ask clarifying questions when requirements are ambiguous or when multiple interpretations exist.
+- Keep scripts deterministic and self-contained; avoid side effects that require external network access unless absolutely necessary.
+`;
 }
 
-function getCursorAppendix() {
+function getImprovedCursorAppendix() {
   return `## Cursor Skill Notes
-- Use global installation first: \`~/.cursor/skills/cascadetui/SKILL.md\`.
-- This skill follows the Agent Skills standard with YAML frontmatter.
-- Ask clarification questions when requirements are ambiguous.
-- Keep supporting material in \`references/\`, \`scripts/\`, and \`assets/\` only if needed.
-`
+
+- Install this skill globally under \`~/.cursor/skills/cascadetui/SKILL.md\`.
+- Cursor uses the open Agent Skills format with YAML frontmatter; ensure the \`name\` and \`description\` fields align with your directory name and skill triggers.
+- Ask clarifying questions when user requests lack details.
+- Keep supporting materials in \`references/\`, \`scripts/\`, and \`assets/\` for progressive disclosure.
+- Avoid referencing frameworks (React, Solid) unless specifically requested by the user.
+- Use determinism and idempotent commands; Cursor may re-run instructions if the output is ambiguous.
+`;
 }
 
-function getSkillContent(agent) {
-  if (agent.flavor === "claude") {
-    return `${getBaseSkillFrontmatter()}
+function getGenericAppendix(agent) {
+  return `## ${agent.label} Skill Notes
 
-${getBaseSkillBody()}
+- Install this skill globally under the agent's skills directory (for example, \`${agent.installPath}\`).
+- This agent supports the open Agent Skills format; ensure the \`name\` and \`description\` fields match the directory name and capture when to trigger this skill.
+- Use progressive disclosure: place detailed guides, examples, or scripts in \`references/\` and \`scripts/\` directories to minimise the size of \`SKILL.md\`.
+- Ask for clarification when the user's request is ambiguous.
+- Follow the principles outlined in this skill for minimal, typed, and deterministic code.`;
+}
 
-${getClaudeAppendix()}
-`
+function getSkillContent(agent) {
+  const frontmatter = getSkillFrontmatter(agent);
+  const body = getSkillBody();
+  if (agent.flavor === "claude") {
+    return (
+      frontmatter +
+      "\n\n" +
+      body +
+      "\n\n" +
+      getImprovedClaudeAppendix()
+    );
   }
-
   if (agent.flavor === "cursor") {
-    return `${getCursorFrontmatter()}
-
-${getBaseSkillBody()}
-
-${getCursorAppendix()}
-`
+    return (
+      frontmatter + "\n\n" + body + "\n\n" + getImprovedCursorAppendix()
+    );
   }
-
-  return `${getBaseSkillFrontmatter()}
-
-${getBaseSkillBody()}
-`
+  return (
+    frontmatter + "\n\n" + body + "\n\n" + getGenericAppendix(agent)
+  );
 }
 
 function installSkill(agent, dryRun) {
-  const content = getSkillContent(agent)
-  const targetFile = agent.installPath
-  const targetDir = resolve(targetFile, "..")
-
+  const content = getSkillContent(agent);
+  const targetFile = agent.installPath;
+  const targetDir = resolve(targetFile, "..");
   if (dryRun) {
-    return { agent: agent.id, path: targetFile, written: false }
+    return { agent: agent.id, path: targetFile, written: false };
   }
-
-  mkdirSync(targetDir, { recursive: true })
-  writeFileSync(targetFile, content)
-  return { agent: agent.id, path: targetFile, written: true }
+  mkdirSync(targetDir, { recursive: true });
+  writeFileSync(targetFile, content);
+  return { agent: agent.id, path: targetFile, written: true };
 }
 
 async function resolveAgentsToInstall(rl, detectedAgents, options) {
   if (options.agents.length > 0) {
-    validateAgentIds(options.agents, detectedAgents)
-    return options.agents
+    validateAgentIds(options.agents, detectedAgents);
+    return options.agents;
   }
-
-  const detectedIds = detectedAgents.filter((agent) => agent.detected).map((agent) => agent.id)
+  const detectedIds = detectedAgents
+    .filter((agent) => agent.detected)
+    .map((agent) => agent.id);
   if (options.allDetected) {
-    return detectedIds
+    return detectedIds;
   }
-
   if (!process.stdin.isTTY) {
-    return detectedIds
+    return detectedIds;
   }
-
-  const selectable = toSelectableOptions(detectedAgents)
-  const preselected = detectedIds.length > 0 ? detectedIds : detectedAgents.slice(0, 1).map((agent) => agent.id)
-
-  console.log("")
+  const selectable = toSelectableOptions(detectedAgents);
+  const preselected =
+    detectedIds.length > 0
+      ? detectedIds
+      : detectedAgents.slice(0, 1).map((agent) => agent.id);
+  console.log("");
   if (detectedIds.length > 0) {
-    console.log(`Detected agents: ${detectedIds.join(", ")}`)
-    console.log(`Quick install command: npx create-cascade-skill --agents ${detectedIds.join(",")}`)
+    console.log(`Detected agents: ${detectedIds.join(", ")}`);
+    console.log(
+      `Quick install command: npx create-cascade-skill --agents ${detectedIds.join(
+        ","
+      )}`
+    );
   } else {
-    console.log("No agent was auto-detected. Select manually.")
+    console.log("No agent was auto-detected. Select manually.");
   }
-
-  const selected = await selectMany(rl, "Choose agent targets for CascadeTUI skill:", selectable, preselected)
+  const selected = await selectMany(
+    rl,
+    "Choose agent targets for CascadeTUI skill:",
+    selectable,
+    preselected
+  );
   if (selected.length > 0) {
-    return selected
+    return selected;
   }
-
-  const fallback = (await promptLine(rl, "No agent selected. Enter comma-separated IDs (or leave empty to cancel): ")).trim()
+  const fallback = (
+    await promptLine(
+      rl,
+      "No agent selected. Enter comma-separated IDs (or leave empty to cancel): "
+    )
+  )
+    .trim();
   if (!fallback) {
-    return []
+    return [];
   }
-
-  const parsed = unique(parseAgentsArg(fallback))
-  validateAgentIds(parsed, detectedAgents)
-  return parsed
+  const parsed = unique(parseAgentsArg(fallback));
+  validateAgentIds(parsed, detectedAgents);
+  return parsed;
 }
 
 async function main() {
-  const options = parseArgs(process.argv)
+  const options = parseArgs(process.argv);
   if (options.help) {
-    printHelp()
-    return
+    printHelp();
+    return;
   }
-
-  const agents = detectAgents(getAgents())
+  const agents = detectAgents(getAgents());
   if (options.list) {
-    printList(agents)
-    return
+    printList(agents);
+    return;
   }
-
   const rl = createInterface({
     input: process.stdin,
     output: process.stdout,
-  })
-
+  });
   try {
-    const selectedIds = await resolveAgentsToInstall(rl, agents, options)
+    const selectedIds = await resolveAgentsToInstall(rl, agents, options);
     if (selectedIds.length === 0) {
-      console.log("Nothing to install.")
-      return
+      console.log("Nothing to install.");
+      return;
     }
-
-    const selectedAgents = agents.filter((agent) => selectedIds.includes(agent.id))
-    const results = selectedAgents.map((agent) => installSkill(agent, options.dryRun))
-
-    console.log("")
-    console.log(`${ANSI_BOLD}CascadeTUI skill installer${ANSI_RESET}`)
+    const selectedAgents = agents.filter((agent) =>
+      selectedIds.includes(agent.id)
+    );
+    const results = selectedAgents.map((agent) =>
+      installSkill(agent, options.dryRun)
+    );
+    console.log("");
+    console.log(`${ANSI_BOLD}CascadeTUI skill installer${ANSI_RESET}`);
     for (const result of results) {
-      const prefix = result.written ? `${ANSI_GREEN}installed${ANSI_RESET}` : `${ANSI_YELLOW}planned${ANSI_RESET}`
-      console.log(`- ${result.agent}: ${prefix} -> ${result.path}`)
+      const prefix = result.written
+        ? `${ANSI_GREEN}installed${ANSI_RESET}`
+        : `${ANSI_YELLOW}planned${ANSI_RESET}`;
+      console.log(
+        `- ${result.agent}: ${prefix} -> ${result.path}`
+      );
     }
-
     if (options.dryRun) {
-      console.log("")
-      console.log("Dry run complete. Re-run without --dry-run to write files.")
+      console.log("");
+      console.log(
+        "Dry run complete. Re-run without --dry-run to write files."
+      );
     }
   } finally {
-    rl.close()
+    rl.close();
   }
 }
 
 main().catch((error) => {
-  console.error(error instanceof Error ? error.message : String(error))
-  process.exit(1)
-})
+  console.error(
+    error instanceof Error ? error.message : String(error)
+  );
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-cascade-skill",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Install CascadeTUI skills for external coding agents",
   "type": "module",
   "license": "MIT",