mudra-skills 1.0.6 → 1.1.0

package/README.md

@@ -4,21 +4,30 @@ Claude Code skills for building [Mudra Band](https://wearabledevices.co.il) apps
 
 ## Install
 
+### Recommended
+
 ```bash
 npx mudra-skills
 ```
 
-Then restart Claude Code or run `/reload-plugins`.
+Installs directly to `~/.claude/skills/` — no global install needed. Then restart Claude Code.
+
+### Alternative: global install
+
+```bash
+npm install -g mudra-skills
+mudra-skills add
+```
 
 ## What You Get
 
-Three skills installed to `~/.claude/plugins/mudra/`:
+Three skills installed to `~/.claude/skills/`:
 
 | Skill | Invoke | Description |
 |---|---|---|
-| **mudra-master** | `/mudra:mudra-master` | Auto-router — classifies your prompt and hands off to 2D or 3D |
-| **mudra-preview** | `/mudra:mudra-preview` | Generates single-file HTML 2D apps |
-| **mudra-xr** | `/mudra:mudra-xr` | Generates single-file HTML 3D/XR apps using XR Blocks |
+| **mudra-master** | `/mudra-master` | Auto-router — classifies your prompt and hands off to 2D or 3D |
+| **mudra-preview** | `/mudra-preview` | Generates single-file HTML 2D apps |
+| **mudra-xr** | `/mudra-xr` | Generates single-file HTML 3D/XR apps using XR Blocks |
 
 ## Usage
 

package/bin/cli.js

@@ -7,12 +7,24 @@ import { execSync } from 'child_process';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const homeDir = process.env.HOME || process.env.USERPROFILE;
-const SKILLS_DIR = path.join(homeDir, '.claude', 'skills');
+const CLAUDE_SKILLS_DIR = path.join(homeDir, '.claude', 'skills');
+const CODEX_SKILLS_DIR = path.join(homeDir, '.agents', 'skills');
+const ANTIGRAVITY_SKILLS_DIR = path.join(homeDir, '.gemini', 'antigravity', 'skills');
 
-const [,, command, ...args] = process.argv;
+// Parse --llm flag before the command switch
+let llmFlag = null;
+const filteredArgv = [];
+for (let i = 2; i < process.argv.length; i++) {
+  if (process.argv[i] === '--llm' && process.argv[i + 1]) {
+    llmFlag = process.argv[++i].toLowerCase();
+  } else {
+    filteredArgv.push(process.argv[i]);
+  }
+}
+const [command, ...args] = filteredArgv;
 
 switch (command ?? 'add') {
-  case 'add':    await add(args[0]); break;
+  case 'add':    await add(args[0], llmFlag); break;
   case 'remove':
   case 'rm':     remove(args[0]); break;
   case 'list':
@@ -20,7 +32,7 @@ switch (command ?? 'add') {
   default:       printHelp(); break;
 }
 
-async function add(source) {
+async function add(source, llm) {
   let skillsSource;
   let tmpDir;
 
@@ -46,14 +58,80 @@ async function add(source) {
     }
   }
 
+  if (!llm) {
+    llm = await promptLLM();
+  }
+
   try {
-    copySkills(skillsSource);
+    if (llm === 'claude') {
+      installClaude(skillsSource);
+    } else if (llm === 'codex') {
+      installCodex(skillsSource);
+    } else if (llm === 'antigravity') {
+      installAntigravity(skillsSource);
+    } else {
+      console.error(`Unknown LLM: "${llm}". Valid options: claude, codex, antigravity`);
+      process.exit(1);
+    }
   } finally {
     if (tmpDir) fs.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 
-function copySkills(skillsSource) {
+function promptLLM() {
+  return new Promise((resolve) => {
+    const options = [
+      { label: 'Claude', value: 'claude' },
+      { label: 'Codex', value: 'codex' },
+      { label: 'Antigravity', value: 'antigravity' },
+    ];
+    let selected = 0;
+    let firstRender = true;
+
+    const render = () => {
+      if (!firstRender) {
+        process.stdout.write(`\x1B[${options.length}A`);
+      }
+      for (let i = 0; i < options.length; i++) {
+        const prefix = i === selected ? '❯ ' : '  ';
+        process.stdout.write(`\r\x1B[2K${prefix}${options[i].label}\n`);
+      }
+      firstRender = false;
+    };
+
+    process.stdout.write('\nWhich AI assistant are you using?\n');
+    process.stdout.write('(↑↓ to move, Enter to select)\n\n');
+    process.stdout.write('\x1B[?25l'); // hide cursor
+
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on('data', handler);
+    render();
+
+    function handler(key) {
+      if (key[0] === 0x1b && key[1] === 0x5b) {
+        if (key[2] === 0x41) { selected = (selected - 1 + options.length) % options.length; render(); }
+        else if (key[2] === 0x42) { selected = (selected + 1) % options.length; render(); }
+      } else if (key[0] === 0x0d || key[0] === 0x0a) {
+        process.stdin.removeListener('data', handler);
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write('\x1B[?25h'); // show cursor
+        process.stdout.write('\n');
+        resolve(options[selected].value);
+      } else if (key[0] === 0x03) { // Ctrl+C
+        process.stdin.removeListener('data', handler);
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write('\x1B[?25h');
+        process.stdout.write('\n');
+        process.exit(0);
+      }
+    }
+  });
+}
+
+function installClaude(skillsSource) {
   if (!fs.existsSync(skillsSource)) {
     console.error(`No skills directory found at: ${skillsSource}`);
     process.exit(1);
@@ -67,7 +145,7 @@ function copySkills(skillsSource) {
     process.exit(1);
   }
 
-  fs.mkdirSync(SKILLS_DIR, { recursive: true });
+  fs.mkdirSync(CLAUDE_SKILLS_DIR, { recursive: true });
 
   const installed = [];
   for (const entry of entries) {
@@ -75,7 +153,7 @@ function copySkills(skillsSource) {
     const skillFile = path.join(src, 'SKILL.md');
     if (!fs.existsSync(skillFile)) continue;
 
-    const dest = path.join(SKILLS_DIR, entry.name);
+    const dest = path.join(CLAUDE_SKILLS_DIR, entry.name);
     fs.mkdirSync(dest, { recursive: true });
     execSync(`cp -r "${src}/." "${dest}"`);
     installed.push(entry.name);
@@ -87,16 +165,98 @@ function copySkills(skillsSource) {
   }
 
   console.log('');
-  console.log(`Installed ${installed.length} skill(s) to ${SKILLS_DIR}`);
+  console.log(`Installed ${installed.length} skill(s) to ${CLAUDE_SKILLS_DIR}`);
   for (const name of installed) console.log(`  ✓ ${name}`);
   console.log('');
   console.log('Restart Claude Code (or run /reload-skills) to activate.');
   console.log('');
 }
 
+function installCodex(skillsSource) {
+  if (!fs.existsSync(skillsSource)) {
+    console.error(`No skills directory found at: ${skillsSource}`);
+    process.exit(1);
+  }
+
+  const entries = fs.readdirSync(skillsSource, { withFileTypes: true })
+    .filter(e => e.isDirectory() && !e.name.startsWith('.'));
+
+  if (entries.length === 0) {
+    console.error('No skill folders found.');
+    process.exit(1);
+  }
+
+  fs.mkdirSync(CODEX_SKILLS_DIR, { recursive: true });
+
+  const installed = [];
+  for (const entry of entries) {
+    const src = path.join(skillsSource, entry.name);
+    const skillFile = path.join(src, 'SKILL.md');
+    if (!fs.existsSync(skillFile)) continue;
+
+    const dest = path.join(CODEX_SKILLS_DIR, entry.name);
+    fs.mkdirSync(dest, { recursive: true });
+    execSync(`cp -r "${src}/." "${dest}"`);
+    installed.push(entry.name);
+  }
+
+  if (installed.length === 0) {
+    console.error('No valid skills found (each skill needs a SKILL.md).');
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log(`Installed ${installed.length} skill(s) to ${CODEX_SKILLS_DIR}`);
+  for (const name of installed) console.log(`  ✓ ${name}  →  use $${name}`);
+  console.log('');
+  console.log('Codex picks up skills automatically. Invoke them with $skill-name.');
+  console.log('');
+}
+
+function installAntigravity(skillsSource) {
+  if (!fs.existsSync(skillsSource)) {
+    console.error(`No skills directory found at: ${skillsSource}`);
+    process.exit(1);
+  }
+
+  const entries = fs.readdirSync(skillsSource, { withFileTypes: true })
+    .filter(e => e.isDirectory() && !e.name.startsWith('.'));
+
+  if (entries.length === 0) {
+    console.error('No skill folders found.');
+    process.exit(1);
+  }
+
+  fs.mkdirSync(ANTIGRAVITY_SKILLS_DIR, { recursive: true });
+
+  const installed = [];
+  for (const entry of entries) {
+    const src = path.join(skillsSource, entry.name);
+    const skillFile = path.join(src, 'SKILL.md');
+    if (!fs.existsSync(skillFile)) continue;
+
+    const dest = path.join(ANTIGRAVITY_SKILLS_DIR, entry.name);
+    fs.mkdirSync(dest, { recursive: true });
+    execSync(`cp -r "${src}/." "${dest}"`);
+    installed.push(entry.name);
+  }
+
+  if (installed.length === 0) {
+    console.error('No valid skills found (each skill needs a SKILL.md).');
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log(`Installed ${installed.length} skill(s) to ${ANTIGRAVITY_SKILLS_DIR}`);
+  for (const name of installed) console.log(`  ✓ ${name}  →  use @${name}`);
+  console.log('');
+  console.log('Antigravity picks up skills automatically. Invoke them with @skill-name or /skill-name.');
+  console.log('');
+}
+
 function remove(skillName) {
   if (!skillName) { console.error('Usage: mudra-skills remove <skill-name>'); process.exit(1); }
-  const target = path.join(SKILLS_DIR, skillName);
+  const target = path.join(CLAUDE_SKILLS_DIR, skillName);
   if (!fs.existsSync(target)) {
     console.error(`Skill not found: ${skillName}`);
     process.exit(1);
@@ -106,26 +266,27 @@ function remove(skillName) {
 }
 
 function list() {
-  if (!fs.existsSync(SKILLS_DIR)) {
+  if (!fs.existsSync(CLAUDE_SKILLS_DIR)) {
     console.log('No skills installed yet.');
     return;
   }
-  const skills = fs.readdirSync(SKILLS_DIR, { withFileTypes: true })
-    .filter(e => e.isDirectory() && !e.name.startsWith('.') && fs.existsSync(path.join(SKILLS_DIR, e.name, 'SKILL.md')));
+  const skills = fs.readdirSync(CLAUDE_SKILLS_DIR, { withFileTypes: true })
+    .filter(e => e.isDirectory() && !e.name.startsWith('.') && fs.existsSync(path.join(CLAUDE_SKILLS_DIR, e.name, 'SKILL.md')));
 
   if (skills.length === 0) {
     console.log('No skills installed yet.');
     return;
   }
-  console.log(`Skills in ${SKILLS_DIR}:`);
+  console.log(`Skills in ${CLAUDE_SKILLS_DIR}:`);
   for (const s of skills) console.log(`  ${s.name}`);
 }
 
 function printHelp() {
   console.log(`
 Usage:
-  npx mudra-skills add [<github-url>]  Install skills (default: bundled)
-  npx mudra-skills remove <name>       Remove a skill
-  npx mudra-skills list                List installed skills
+  npx mudra-skills [--llm claude|codex|antigravity]   Install skills (prompts if no --llm)
+  npx mudra-skills add [<github-url>] [--llm <name>]  Install from URL
+  npx mudra-skills remove <name>                       Remove a Claude skill
+  npx mudra-skills list                                List installed Claude skills
 `);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mudra-skills",
-  "version": "1.0.6",
-  "description": "Claude Code skills for building Mudra Band apps — 2D, 3D/XR, or auto-classified",
+  "version": "1.1.0",
+  "description": "Mudra Band skills for Claude Code, Codex, and Antigravity — 2D, 3D/XR, or auto-classified",
   "type": "module",
   "bin": {
     "mudra-skills": "bin/cli.js"

package/.claude-plugin/plugin.json

@@ -1,19 +0,0 @@
-{
-  "name": "mudra",
-  "description": "Claude Code skills for building Mudra Band apps — generate 2D flat/screen apps, 3D/XR experiences, or let the router auto-classify and hand off.",
-  "version": "1.0.4",
-  "author": {
-    "name": "Wearable Devices",
-    "email": "jabbour.d@wearabledevices.co.il"
-  },
-  "homepage": "https://github.com/wearable-devices/mudra-skills",
-  "repository": "https://github.com/wearable-devices/mudra-skills",
-  "license": "MIT",
-  "keywords": [
-    "mudra",
-    "wearable",
-    "gestures",
-    "xr",
-    "webxr"
-  ]
-}

package/CLAUDE.md

@@ -1,35 +0,0 @@
-# Mudra Plugin
-
-This plugin provides skills for generating Mudra Band apps.
-
-Use `/mudra-master` (or just describe an app idea) to build a 2D or 3D/XR app controlled by the Mudra Band wristband.
-
-## Skills
-
-- **mudra-master** — router: classifies prompt as 2D / 3D / ASK / DECLINE, then hands off
-- **mudra-preview** — generates single-file HTML 2D apps
-- **mudra-xr** — generates single-file HTML 3D/XR apps using XR Blocks
-
-## Canonical Nine-Signal Table
-
-| Signal | Type | Use for |
-|---|---|---|
-| `gesture` | discrete | finger pinches (index, middle, ring, little, thumb, grab) |
-| `button` | discrete | hardware button press/release |
-| `pressure` | analog | continuous squeeze force (0–1) |
-| `navigation` | pointer | 2D cursor delta (x, y) — Pointer mode |
-| `nav_direction` | discrete | swipe direction (up/down/left/right) — Direction mode |
-| `imu_acc` | analog | accelerometer (x, y, z) — IMU mode |
-| `imu_gyro` | analog | gyroscope (x, y, z) — IMU mode |
-| `snc` | analog | 3-channel bio signal, batched arrays per channel |
-| `battery` | discrete | battery level |
-
-**Motion-mode exclusivity (non-negotiable):** each app uses exactly one of `navigation` XOR `nav_direction` XOR `imu_acc`+`imu_gyro`. The additive signals (`gesture`, `pressure`, `snc`, `battery`) combine freely with any mode.
-
-## Protocol Rules
-
-- WebSocket at `ws://127.0.0.1:8766`
-- Subscribe one signal per command, key `signal` (singular): `{ "command": "subscribe", "signal": "<name>" }`
-- Never use `signals` (plural) or batch subscribe
-- Always wrap with `MudraWebSocket` class (includes mock fallback)
-- Every app must include: mock fallback, always-visible simulator panel, keyboard shortcuts, connection-status indicator

package/bin/install.js

@@ -1,75 +0,0 @@
-#!/usr/bin/env node
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const pluginSrc = path.resolve(__dirname, '..');
-const homeDir = process.env.HOME || process.env.USERPROFILE;
-const pluginsDir = path.join(homeDir, '.claude', 'plugins');
-
-const pkg = JSON.parse(fs.readFileSync(path.join(pluginSrc, 'package.json'), 'utf8'));
-const version = pkg.version;
-const MARKETPLACE = 'mudra-band';
-const PLUGIN_NAME = 'mudra';
-const PLUGIN_KEY = `${PLUGIN_NAME}@${MARKETPLACE}`;
-
-// Install to top-level plugins directory (Claude Code scans here directly)
-const target = path.join(pluginsDir, PLUGIN_NAME);
-fs.mkdirSync(target, { recursive: true });
-execSync(`cp -r "${pluginSrc}/." "${target}"`);
-
-// Register the marketplace in known_marketplaces.json if not already there
-const marketplacesFile = path.join(pluginsDir, 'known_marketplaces.json');
-let marketplaces = {};
-if (fs.existsSync(marketplacesFile)) {
-  marketplaces = JSON.parse(fs.readFileSync(marketplacesFile, 'utf8'));
-}
-if (!marketplaces[MARKETPLACE]) {
-  marketplaces[MARKETPLACE] = {
-    source: {
-      source: 'git',
-      url: 'https://github.com/jabbourWearable/mudra-skill.git',
-    },
-    installLocation: path.join(pluginsDir, 'marketplaces', MARKETPLACE),
-    lastUpdated: new Date().toISOString(),
-  };
-  fs.writeFileSync(marketplacesFile, JSON.stringify(marketplaces, null, 2));
-}
-
-// Register the plugin in installed_plugins.json with the correct marketplace key
-const installedFile = path.join(pluginsDir, 'installed_plugins.json');
-let installed = { version: 2, plugins: {} };
-if (fs.existsSync(installedFile)) {
-  installed = JSON.parse(fs.readFileSync(installedFile, 'utf8'));
-}
-
-// Remove stale npm entry from previous installs
-delete installed.plugins['mudra@npm'];
-
-const now = new Date().toISOString();
-const previousInstall = installed.plugins[PLUGIN_KEY]?.[0];
-installed.plugins[PLUGIN_KEY] = [
-  {
-    scope: 'user',
-    installPath: target,
-    version,
-    installedAt: previousInstall?.installedAt ?? now,
-    lastUpdated: now,
-  },
-];
-
-fs.writeFileSync(installedFile, JSON.stringify(installed, null, 2));
-
-console.log('');
-console.log('Mudra skills installed successfully!');
-console.log('');
-console.log('Next steps:');
-console.log('  1. Restart Claude Code, or run /reload-plugins');
-console.log('  2. Use the skills:');
-console.log('     /mudra:mudra-master  — auto-classify and route');
-console.log('     /mudra:mudra-preview — generate 2D app');
-console.log('     /mudra:mudra-xr      — generate 3D/XR app');
-console.log('');
-console.log(`Plugin location: ${target}`);