@toolbeltai/skills 0.1.2 → 0.1.4

package/README.md

@@ -9,8 +9,9 @@
 npx @toolbeltai/skills install
 ```
 
-Copies every skill to `~/.claude/skills/toolbelt/`. Restart Claude Code and
-you'll see them as slash commands: `/run-toolbelt`, `/geo-analyst`, …
+Copies every skill to `~/.claude/skills/` (flat, per the AgentSkills spec).
+Restart Claude Code and you'll see them as slash commands: `/run-toolbelt`,
+`/geo-analyst`, …
 
 No account required; no network calls to Toolbelt. Skills work against any
 Toolbelt MCP server (cloud or self-hosted).

package/bin/install.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * toolbelt-skills — install Toolbelt's Claude Code skills into ~/.claude/skills/toolbelt/
+ * toolbelt-skills — install Toolbelt's skills into ~/.claude/skills/
  *
  * Usage:
  *   npx @toolbeltai/skills install       # copy skills (default)
@@ -11,6 +11,11 @@
  * The @toolbeltai/cli package wraps this for its own install flow; this
  * CLI exists so the skills package stands on its own — anyone can install
  * without needing the Toolbelt CLI or hitting any Toolbelt-hosted service.
+ *
+ * Layout: skills install FLAT under ~/.claude/skills/ per AgentSkills spec
+ * (agentskills.io) and Claude Code docs. An earlier version nested them
+ * under ~/.claude/skills/toolbelt/; that broke discovery in OpenClaw and
+ * was non-standard for Claude Code. We clean up the legacy dir on install.
  */
 import { cpSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from 'node:fs';
 import { homedir } from 'node:os';
@@ -18,7 +23,8 @@ import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
-const TARGET = join(homedir(), '.claude', 'skills', 'toolbelt');
+const TARGET = join(homedir(), '.claude', 'skills');
+const LEGACY_NESTED_DIR = join(TARGET, 'toolbelt');
 
 /** Any top-level directory containing a SKILL.md is a skill. */
 function listSkills() {
@@ -28,6 +34,13 @@ function listSkills() {
     .filter((name) => existsSync(join(PKG_ROOT, name, 'SKILL.md')));
 }
 
+function cleanupLegacy() {
+  if (existsSync(LEGACY_NESTED_DIR)) {
+    rmSync(LEGACY_NESTED_DIR, { recursive: true, force: true });
+    console.log(`  migrated: removed legacy ~/.claude/skills/toolbelt/`);
+  }
+}
+
 function cmdInstall() {
   const skills = listSkills();
   if (skills.length === 0) {
@@ -36,12 +49,14 @@ function cmdInstall() {
   }
 
   mkdirSync(TARGET, { recursive: true });
+  cleanupLegacy();
+
   for (const name of skills) {
     const src = join(PKG_ROOT, name);
     const dst = join(TARGET, name);
     rmSync(dst, { recursive: true, force: true });
     cpSync(src, dst, { recursive: true });
-    console.log(`  \u2713 ${name}`);
+    console.log(`  ✓ ${name}`);
   }
   // Optional assets (icons, tapes) — copy if present so popups render right.
   const assetsSrc = join(PKG_ROOT, 'assets');
@@ -57,12 +72,26 @@ function cmdInstall() {
 }
 
 function cmdUninstall() {
-  if (!existsSync(TARGET)) {
+  // Remove installed skills and legacy nested dir.
+  cleanupLegacy();
+  const skills = listSkills();
+  let removed = 0;
+  for (const name of skills) {
+    const dst = join(TARGET, name);
+    if (existsSync(dst)) {
+      rmSync(dst, { recursive: true, force: true });
+      removed++;
+    }
+  }
+  const assetsDst = join(TARGET, 'assets');
+  if (existsSync(assetsDst)) {
+    rmSync(assetsDst, { recursive: true, force: true });
+  }
+  if (removed === 0) {
     console.log('  (nothing to remove)');
-    return;
+  } else {
+    console.log(`  Removed ${removed} skills from ${TARGET}`);
   }
-  rmSync(TARGET, { recursive: true, force: true });
-  console.log(`  Removed ${TARGET}`);
 }
 
 function cmdList() {
@@ -74,7 +103,7 @@ function cmdPath() {
 }
 
 function usage() {
-  console.log(`toolbelt-skills — install Toolbelt skills into ~/.claude/skills/toolbelt/
+  console.log(`toolbelt-skills — install Toolbelt skills into ~/.claude/skills/
 
 Usage:
   npx @toolbeltai/skills install       Install skills (default)

package/data-blend/SKILL.md

@@ -104,7 +104,7 @@ ORDER BY total_amount DESC
 
 ## Phase 0: Verify Connection
 
-Call `get_semantic_names` (no arguments) immediately.
+Call `toolbelt_list_namespaces` (no arguments) immediately.
 
 - **If it succeeds:** proceed to Phase 1 using the returned namespaces.
 - **If it fails:** emit structured failure and halt.
@@ -271,7 +271,7 @@ section and continue. Only halt on Phase 0–3 failures.
 
 | Phase | Tool(s) |
 |---|---|
-| 0. Verify connection | `get_semantic_names` |
+| 0. Verify connection | `toolbelt_list_namespaces` |
 | 1. Resolve namespace | (from Phase 0 result) |
 | 2. Inspect existing tables | `toolbelt_context` |
 | 3. Upload missing tables | `toolbelt_save` |

package/geo-analyst/SKILL.md

@@ -70,7 +70,7 @@ POLYGON((-82.4650 27.9400, -82.4350 27.9400, -82.4350 27.9700, -82.4650 27.9700,
 
 ## Phase 0: Verify Connection
 
-Call `get_semantic_names` (no arguments) immediately.
+Call `toolbelt_list_namespaces` (no arguments) immediately.
 
 - **If it succeeds:** proceed to Phase 1 using the returned namespaces.
 - **If it fails:** emit structured failure and halt.
@@ -232,7 +232,7 @@ and continue with remaining queries. Only halt on Phase 0–2 failures.
 
 | Phase | Tool(s) |
 |---|---|
-| 0. Verify connection | `get_semantic_names` |
+| 0. Verify connection | `toolbelt_list_namespaces` |
 | 1. Resolve namespace | (from Phase 0 result) |
 | 2. Upload sensor data | `toolbelt_save`, `toolbelt_jobs`, `toolbelt_context` |
 | 3. Run geospatial queries | `toolbelt_execute` × 3 |

package/knowledge-graph/SKILL.md

@@ -101,7 +101,7 @@ manufactured at a new facility in Round Rock, Texas.
 
 ## Phase 0: Verify Connection
 
-Call `get_semantic_names` (no arguments) immediately.
+Call `toolbelt_list_namespaces` (no arguments) immediately.
 
 - **If it succeeds:** proceed to Phase 1 using the returned namespaces.
 - **If it fails:** emit structured failure and halt.
@@ -339,7 +339,7 @@ what is available and note the gap. Only halt on Phase 0–3 failures.
 
 | Phase | Tool(s) |
 |---|---|
-| 0. Verify connection | `get_semantic_names` |
+| 0. Verify connection | `toolbelt_list_namespaces` |
 | 1. Resolve namespace | (from Phase 0 result) |
 | 2. Upload document | `toolbelt_save` |
 | 3. Poll for extraction | `toolbelt_jobs` (ingest + semantic) |

package/multi-agent-workspace/SKILL.md

@@ -80,7 +80,7 @@ Classification: Internal — Project Team Only
 
 ## Phase 0: Verify Connection
 
-Call `get_semantic_names` (no arguments) immediately.
+Call `toolbelt_list_namespaces` (no arguments) immediately.
 
 - **If it succeeds:** proceed to Phase 1 using the returned namespaces.
 - **If it fails:** emit structured failure and halt.
@@ -206,7 +206,7 @@ RESULT:
 
 | Phase | Tool(s) |
 |---|---|
-| 0. Verify connection | `get_semantic_names` |
+| 0. Verify connection | `toolbelt_list_namespaces` |
 | 1. Resolve namespace | (from Phase 0 result) |
 | 2. Upload document | `toolbelt_save` |
 | 3. Poll for ingestion | `toolbelt_jobs` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolbeltai/skills",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Official Toolbelt skills for Claude Code and MCP agents — run-toolbelt, geo-analyst, knowledge-graph, sql-analyst, vector-search, streaming-analyst, multi-agent-workspace, data-blend.",
   "license": "MIT",
   "homepage": "https://toolbelt.ai",

package/run-toolbelt/SKILL.md

@@ -54,7 +54,7 @@ Skip Phase 5 if `question` is absent.
 
 ## Phase 0: Verify Connection
 
-Call `get_semantic_names` (no arguments) immediately.
+Call `toolbelt_list_namespaces` (no arguments) immediately.
 
 - **If it succeeds:** proceed to Phase 1 using the returned namespaces.
 - **If it fails:** emit structured failure and halt.
@@ -227,7 +227,7 @@ RESULT:
 
 | Phase | Tool(s) |
 |---|---|
-| 0. Verify connection | `get_semantic_names` |
+| 0. Verify connection | `toolbelt_list_namespaces` |
 | 1. Resolve namespace | (from Phase 0 result) |
 | 2. Inspect state | `toolbelt_context` |
 | 3. Add document | `toolbelt_save`, `toolbelt_jobs`, `toolbelt_context` |

package/sql-analyst/SKILL.md

@@ -77,7 +77,7 @@ Default `question`: `What is the total sales amount by region?`
 
 ## Phase 0: Verify Connection
 
-Call `get_semantic_names` (no arguments) immediately.
+Call `toolbelt_list_namespaces` (no arguments) immediately.
 
 - **If it succeeds:** proceed to Phase 1 using the returned namespaces.
 - **If it fails:** emit structured failure and halt.
@@ -222,7 +222,7 @@ RESULT:
 
 | Phase | Tool(s) |
 |---|---|
-| 0. Verify connection | `get_semantic_names` |
+| 0. Verify connection | `toolbelt_list_namespaces` |
 | 1. Resolve namespace | (from Phase 0 result) |
 | 2. Upload CSV document | `toolbelt_save` |
 | 3. Poll for ingestion | `toolbelt_jobs` |

package/streaming-analyst/SKILL.md

@@ -96,7 +96,7 @@ sensor_id VARCHAR(64), ts TIMESTAMP, value DOUBLE, unit VARCHAR(32)
 
 ## Phase 0: Verify Connection
 
-Call `get_semantic_names` (no arguments) immediately.
+Call `toolbelt_list_namespaces` (no arguments) immediately.
 
 - **If it succeeds:** proceed to Phase 1 using the returned namespaces.
 - **If it fails:** emit structured failure and halt.
@@ -338,7 +338,7 @@ section and continue. Only halt on Phase 0–2 failures.
 
 | Phase | Tool(s) |
 |---|---|
-| 0. Verify connection | `get_semantic_names` |
+| 0. Verify connection | `toolbelt_list_namespaces` |
 | 1. Resolve namespace | (from Phase 0 result) |
 | 2. Connect stream | `toolbelt_connect` (Kafka) or `toolbelt_save` + `toolbelt_jobs` + `toolbelt_context` (simulated) |
 | 3. Confirm data arrival | `toolbelt_execute` × 1–2 |

package/vector-search/SKILL.md

@@ -105,7 +105,7 @@ Default `question`: `What are the effects on coastal ecosystems?`
 
 ## Phase 0: Verify Connection
 
-Call `get_semantic_names` (no arguments) immediately.
+Call `toolbelt_list_namespaces` (no arguments) immediately.
 
 - **If it succeeds:** proceed to Phase 1 using the returned namespaces.
 - **If it fails:** emit structured failure and halt.
@@ -249,7 +249,7 @@ RESULT:
 
 | Phase | Tool(s) |
 |---|---|
-| 0. Verify connection | `get_semantic_names` |
+| 0. Verify connection | `toolbelt_list_namespaces` |
 | 1. Resolve namespace | (from Phase 0 result) |
 | 2. Upload document | `toolbelt_save` |
 | 3. Poll for indexing | `toolbelt_jobs` |