debug-run 0.5.2 → 0.5.4

package/README.md

@@ -34,22 +34,41 @@ npx debug-run --help
 
 ### Claude Code Skill (Recommended)
 
-To enable Claude Code to use debug-run effectively, copy the skill to your skills directory:
+To enable AI coding assistants to use debug-run effectively, install the skill:
 
 ```bash
-# Create skills directory if it doesn't exist
-mkdir -p ~/.claude/skills
+# Install for Claude Code (default)
+npx debug-run install-skill
 
-# Copy the debug-run skill
-cp -r node_modules/debug-run/.claude/skills/debug-run ~/.claude/skills/
+# Install for GitHub Copilot
+npx debug-run install-skill --copilot
+
+# Install for both Claude Code and GitHub Copilot
+npx debug-run install-skill --claude --copilot
+
+# Install to project directory (for team sharing)
+npx debug-run install-skill --project              # Claude: .claude/skills/
+npx debug-run install-skill --copilot --project    # Copilot: .github/skills/
+
+# Install to custom directory
+npx debug-run install-skill --dir /path/to/skills
 ```
 
-This installs the skill which teaches Claude how to use debug-run for debugging .NET, Python, and TypeScript applications. The skill includes:
+| Option | Description |
+|--------|-------------|
+| `--claude` | Install to Claude Code (`~/.claude/skills/`) - default |
+| `--copilot` | Install to GitHub Copilot (`~/.copilot/skills/`) |
+| `--project` | Install to project directory instead of user home |
+| `--dir <path>` | Install to custom directory |
+
+This copies skill files teaching AI assistants how to use debug-run for debugging .NET, Python, and TypeScript applications:
 - `SKILL.md` - Main skill with options reference and best practices
 - `DOTNET.md` - .NET-specific guide (vsdbg, ASP.NET, NUnit)
 - `PYTHON.md` - Python-specific guide (debugpy)
 - `TYPESCRIPT.md` - TypeScript/JavaScript guide (js-debug)
 
+**Note**: For GitHub Copilot, enable the `chat.useAgentSkills` setting in VS Code for Agent Skills support.
+
 ### Development Setup
 
 ```bash

package/dist/index.cjs

@@ -6959,6 +6959,11 @@ function createCli() {
   program2.command("install-adapter <name>").description("Download and install a debug adapter").action(async (name) => {
     await installAdapter(name);
   });
+  program2.command("install-skill").description("Install the debug-run skill for AI coding assistants").option("--claude", "Install to Claude Code (~/.claude/skills/)").option("--copilot", "Install to GitHub Copilot (~/.copilot/skills/)").option("--project", "Install to project directory instead of user home").option("--dir <path>", "Install to custom directory").action(
+    async (options) => {
+      await installSkill(options);
+    }
+  );
   return program2;
 }
 async function runTestDebugSession(options) {
@@ -7160,6 +7165,108 @@ Successfully installed js-debug!`);
     process.exit(1);
   }
 }
+function getSkillTargets(options) {
+  const os4 = require("node:os");
+  const path12 = require("node:path");
+  const homeDir = os4.homedir();
+  const projectDir = process.cwd();
+  const targets = [];
+  if (options.dir) {
+    targets.push({
+      name: "custom",
+      directory: path12.resolve(options.dir, "debug-run")
+    });
+    return targets;
+  }
+  const installClaude = options.claude || !options.copilot && !options.dir;
+  const installCopilot = options.copilot;
+  if (installClaude) {
+    if (options.project) {
+      targets.push({
+        name: "Claude Code (project)",
+        directory: path12.join(projectDir, ".claude", "skills", "debug-run")
+      });
+    } else {
+      targets.push({
+        name: "Claude Code",
+        directory: path12.join(homeDir, ".claude", "skills", "debug-run")
+      });
+    }
+  }
+  if (installCopilot) {
+    if (options.project) {
+      targets.push({
+        name: "GitHub Copilot (project)",
+        directory: path12.join(projectDir, ".github", "skills", "debug-run")
+      });
+    } else {
+      targets.push({
+        name: "GitHub Copilot",
+        directory: path12.join(homeDir, ".copilot", "skills", "debug-run")
+      });
+    }
+  }
+  return targets;
+}
+async function installSkill(options = {}) {
+  const path12 = await import("node:path");
+  const moduleDir = path12.dirname(new URL(__importMetaUrl).pathname);
+  const possibleSources = [
+    path12.join(moduleDir, "..", ".claude", "skills", "debug-run"),
+    path12.join(moduleDir, ".claude", "skills", "debug-run"),
+    path12.join(process.cwd(), ".claude", "skills", "debug-run")
+  ];
+  let sourceDir = null;
+  for (const src of possibleSources) {
+    if (fs2.existsSync(path12.join(src, "SKILL.md"))) {
+      sourceDir = src;
+      break;
+    }
+  }
+  if (!sourceDir) {
+    console.error("Error: Could not find skill files.");
+    console.error("Expected to find SKILL.md in .claude/skills/debug-run/");
+    process.exit(1);
+  }
+  const targets = getSkillTargets(options);
+  if (targets.length === 0) {
+    console.error("Error: No installation target specified.");
+    console.error("Use --claude, --copilot, --project, or --dir <path>");
+    process.exit(1);
+  }
+  const files = ["SKILL.md", "DOTNET.md", "PYTHON.md", "TYPESCRIPT.md"];
+  for (const target of targets) {
+    fs2.mkdirSync(target.directory, { recursive: true });
+    let copiedCount = 0;
+    for (const file of files) {
+      const srcPath = path12.join(sourceDir, file);
+      const destPath = path12.join(target.directory, file);
+      if (fs2.existsSync(srcPath)) {
+        fs2.copyFileSync(srcPath, destPath);
+        copiedCount++;
+      }
+    }
+    console.log(`Installed debug-run skill for ${target.name}:`);
+    console.log(`  Directory: ${target.directory}`);
+    console.log(`  Files copied: ${copiedCount}`);
+    for (const file of files) {
+      if (fs2.existsSync(path12.join(target.directory, file))) {
+        console.log(`    - ${file}`);
+      }
+    }
+    console.log();
+  }
+  const targetNames = targets.map((t) => t.name);
+  if (targetNames.some((n) => n.includes("Claude"))) {
+    console.log("Claude Code will now use this skill when debugging.");
+  }
+  if (targetNames.some((n) => n.includes("Copilot"))) {
+    console.log("GitHub Copilot will now use this skill when debugging.");
+    console.log(
+      "Note: Enable the chat.useAgentSkills setting in VS Code for Agent Skills support."
+    );
+  }
+}
 
 // src/index.ts
 var cli = createCli();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "debug-run",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "CLI tool enabling AI agents to programmatically debug code via DAP",
   "type": "module",
   "main": "dist/index.cjs",