@cognite/dune 0.2.7 → 0.3.1

package/bin/cli.js

@@ -73,6 +73,7 @@ async function main() {
 
   // Handle different commands
   if (command === "create" || command === "new" || !command || command === ".") {
+    // TODO(DUNE-362): simplify directory resolution logic
     // Parse directory argument
     // Support: npx @cognite/dune create . or npx @cognite/dune .
     let dirArg;
@@ -132,7 +133,7 @@ ${deployLabel}
   ${deployCommand}
 `);
       } else {
-        const appDir = appName || "your-app";
+        const appDir = dirName || appName || "your-app";
         console.log(`
 ✅ App created successfully!
 
@@ -147,6 +148,21 @@ ${deployLabel}
   ${deployCommand}
 `);
       }
+
+      // Pull AI skills into the new app
+      try {
+        const { runSkillsCli, defaultPullArgs } = await import("./skills-command.js");
+        const skillsCwd = isCurrentDir ? process.cwd() : resolve(process.cwd(), dirName || appName);
+        console.log("🧠 Pulling Dune skills...");
+        runSkillsCli(defaultPullArgs(), {
+          cwd: skillsCwd,
+          timeout: 30_000,
+        });
+        console.log("✅ Skills installed successfully");
+      } catch (error) {
+        // Skills pull failure should never block app creation
+        console.warn("⚠️  Could not pull Dune skills:", error.message);
+      }
     } catch (error) {
       console.error("Error:", error.message);
       process.exit(1);
@@ -157,6 +173,9 @@ ${deployLabel}
   } else if (command === "deploy:interactive") {
     const { handleDeployInteractive } = await import("./deploy-interactive-command.js");
     await handleDeployInteractive(args.slice(1));
+  } else if (command === "skills") {
+    const { handleSkillsCommand } = await import("./skills-command.js");
+    handleSkillsCommand(args.slice(1));
   } else if (command === "help" || command === "--help" || command === "-h") {
     console.log(`
 @cognite/dune - Build and deploy React apps to Cognite Data Fusion
@@ -168,6 +187,7 @@ Commands:
   create, new        Create a new Dune application (default)
   deploy             Build and deploy using environment credentials
   deploy:interactive Build and deploy with browser-based login
+  skills             Manage AI agent skills (pull, push, list)
   help               Show this help message
 
 Examples:
@@ -177,6 +197,7 @@ Examples:
   npx @cognite/dune create .           # Create app in current directory (. is special)
   npx @cognite/dune deploy             # Deploy with env credentials
   npx @cognite/dune deploy:interactive # Deploy with browser login
+  npx @cognite/dune skills pull        # Pull AI skills into your project
 
 For programmatic usage:
   import { DuneAuthProvider, useDune } from "@cognite/dune/auth"

package/bin/skills-command.js

@@ -0,0 +1,188 @@
+/**
+ * Skills Command
+ *
+ * Manages AI agent skills for Dune apps. Uses the `skills` package (bundled
+ * dependency) for pull/list operations.
+ */
+
+import { execFileSync } from "node:child_process";
+import { createRequire } from "node:module";
+
+const SKILL_SOURCE = "cognitedata/dune-skills";
+const SUPPORTED_AGENTS = ["claude-code", "cursor"];
+const AGENT_FLAGS = SUPPORTED_AGENTS.flatMap((a) => ["-a", a]);
+
+const require = createRequire(import.meta.url);
+
+/**
+ * Run the bundled `skills` CLI with the given arguments.
+ * @param {string[]} args
+ * @param {import('child_process').ExecFileSyncOptions} [options]
+ */
+export function runSkillsCli(args, options = {}) {
+  const bin = require.resolve("skills/bin/cli.mjs");
+  execFileSync(process.execPath, [bin, ...args], {
+    stdio: "inherit",
+    cwd: process.cwd(),
+    ...options,
+  });
+}
+
+/**
+ * Print help message
+ */
+function printHelp() {
+  console.log(`
+🧠 Dune Skills — Manage AI agent skills for your Dune app
+
+Installs skills for: ${SUPPORTED_AGENTS.join(", ")}
+
+Usage:
+  npx @cognite/dune skills <command> [options]
+
+Commands:
+  pull     Pull all skills into your project
+  list     List installed skills
+  help     Show this help message
+
+Options for pull:
+  --source <owner/repo>   Skills repository (default: ${SKILL_SOURCE})
+  --skill <name>          Pull a specific skill by name
+  --interactive, -i       Interactively select which skills to install
+  --global                Install skills globally
+
+Examples:
+  npx @cognite/dune skills pull                          # Pull all skills
+  npx @cognite/dune skills pull --skill create-client-tool
+  npx @cognite/dune skills list                          # List installed skills
+`);
+}
+
+/**
+ * Build the default CLI args for pulling all skills.
+ *
+ * Invokes: skills add <source> -a claude-code -a cursor --skill '*' -y
+ *   - "add"        : skills CLI subcommand that fetches and installs skills
+ *   - SKILL_SOURCE : GitHub owner/repo hosting the skill definitions
+ *   - AGENT_FLAGS  : install for every supported AI agent (-a claude-code -a cursor)
+ *   - --skill '*'  : wildcard — pull every available skill
+ *   - -y           : auto-confirm all prompts (non-interactive / --yes)
+ *
+ * See: https://github.com/vercel-labs/skills
+ * @returns {string[]}
+ */
+export function defaultPullArgs() {
+  return ["add", SKILL_SOURCE, ...AGENT_FLAGS, "--skill", "*", "-y"];
+}
+
+/**
+ * Validate that a source string matches owner/repo format.
+ * @param {string} source
+ */
+function validateSource(source) {
+  if (!/^[\w.-]+\/[\w.-]+$/.test(source)) {
+    console.error(`❌ Invalid source format: ${source}`);
+    console.error("Expected: owner/repo (e.g., cognitedata/dune-skills)");
+    process.exit(1);
+  }
+}
+
+/**
+ * Handle `dune skills pull`
+ * @param {string[]} args
+ */
+// TODO(DUNE-362): replace manual arg parsing with node:util parseArgs
+function handlePull(args) {
+  let source = SKILL_SOURCE;
+  let skill_name = null;
+  let interactive = false;
+  // Flags forwarded verbatim to the skills CLI (e.g. --global)
+  const passthrough = [];
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--source") {
+      source = args[++i];
+      if (!source) {
+        console.error("❌ --source requires a value (e.g., cognitedata/dune-skills)");
+        process.exit(1);
+      }
+      validateSource(source);
+    } else if (arg === "--skill") {
+      skill_name = args[++i];
+      if (!skill_name) {
+        console.error("❌ --skill requires a name");
+        process.exit(1);
+      }
+    } else if (arg === "--interactive" || arg === "-i") {
+      interactive = true;
+    } else if (arg === "--global") {
+      // --global installs skills into ~/.claude/skills (user-wide) instead of project-local
+      passthrough.push(arg);
+    } else {
+      console.warn(`⚠️  Unknown option: ${arg}`);
+    }
+  }
+
+  // Build the skills CLI invocation:
+  //   skills add <source> -a claude-code -a cursor [--skill <name> | --skill * -y]
+  // See: https://github.com/vercel-labs/skills
+  const cliArgs = ["add", source, ...AGENT_FLAGS];
+  if (skill_name) {
+    cliArgs.push("--skill", skill_name);
+  } else if (!interactive) {
+    // Pull all skills and auto-confirm (-y / --yes) without interactive prompts
+    cliArgs.push("--skill", "*", "-y");
+  }
+  cliArgs.push(...passthrough);
+
+  console.log(`🔄 Pulling skills from ${source}...`);
+
+  runSkillsCli(cliArgs);
+  console.log("\n✅ Skills pulled successfully");
+}
+
+/**
+ * Handle `dune skills list`
+ */
+function handleList() {
+  try {
+    runSkillsCli(["list"]);
+  } catch (error) {
+    console.error("❌ Failed to list skills:", error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}
+
+/**
+ * Skills command handler
+ * @param {string[]} args
+ */
+export function handleSkillsCommand(args) {
+  const subcommand = args[0];
+  const subArgs = args.slice(1);
+
+  try {
+    switch (subcommand) {
+      case undefined:
+      case "help":
+      case "--help":
+      case "-h":
+        printHelp();
+        break;
+      case "pull":
+        handlePull(subArgs);
+        break;
+      case "list":
+        handleList();
+        break;
+      default:
+        console.error(`❌ Unknown skills command: ${subcommand}`);
+        printHelp();
+        process.exit(1);
+    }
+  } catch (error) {
+    console.error("❌ Skills command failed:", error.message);
+    process.exit(1);
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognite/dune",
-  "version": "0.2.7",
+  "version": "0.3.1",
   "description": "Build and deploy React apps to Cognite Data Fusion",
   "keywords": ["cognite", "dune", "cdf", "fusion", "react", "scaffold", "deploy"],
   "license": "Apache-2.0",
@@ -41,7 +41,7 @@
   "bin": {
     "dune": "./bin/cli.js"
   },
-  "files": ["bin/cli.js", "bin/deploy-command.js", "bin/deploy-interactive-command.js", "bin/auth", "bin/utils", "dist", "src", "_templates"],
+  "files": ["bin/cli.js", "bin/deploy-command.js", "bin/deploy-interactive-command.js", "bin/skills-command.js", "bin/auth", "bin/utils", "dist", "src", "_templates"],
   "scripts": {
     "build": "tsup",
     "prepare": "tsup",
@@ -55,7 +55,8 @@
     "enquirer": "^2.4.1",
     "execa": "^5.1.1",
     "hygen": "^6.2.11",
-    "open": "^10.1.0"
+    "open": "^10.1.0",
+    "skills": "^1.4.3"
   },
   "peerDependencies": {
     "@cognite/sdk": ">=9.0.0",