@toolbeltai/skills 0.1.3 → 0.2.0

package/README.md

@@ -10,8 +10,8 @@ npx @toolbeltai/skills install
 ```
 
 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`, …
+Restart Claude Code and you'll see them as slash commands: `/toolbelt-start`,
+`/toolbelt-geo`, …
 
 No account required; no network calls to Toolbelt. Skills work against any
 Toolbelt MCP server (cloud or self-hosted).
@@ -31,14 +31,13 @@ agent, and installs these skills — all at once.
 
 | Skill | Command | What it does |
 | --- | --- | --- |
-| [run-toolbelt](run-toolbelt/) | `/run-toolbelt` | Onboard, upload docs, connect data, ask questions |
-| [geo-analyst](geo-analyst/) | `/geo-analyst` | GPU-accelerated geospatial — queries and map rendering |
-| [knowledge-graph](knowledge-graph/) | `/knowledge-graph` | Auto-extract entities from docs, explore with Cypher |
-| [multi-agent-workspace](multi-agent-workspace/) | `/multi-agent-workspace` | Shareable MCP URL for multi-agent collaboration |
-| [sql-analyst](sql-analyst/) | `/sql-analyst` | Upload a CSV, ask plain English, get SQL + results |
-| [streaming-analyst](streaming-analyst/) | `/streaming-analyst` | Connect Kafka, aggregate, detect anomalies |
-| [vector-search](vector-search/) | `/vector-search` | Upload a document, retrieve semantically similar passages |
-| [data-blend](data-blend/) | `/data-blend` | Combine multiple tables with cross-table JOINs |
+| [toolbelt-start](toolbelt-start/) | `/toolbelt-start` | Onboard end-to-end — provision, ingest, first query |
+| [toolbelt-analyze](toolbelt-analyze/) | `/toolbelt-analyze` | Upload 1+ CSVs, ask in plain English, get SQL answers (single-table or multi-table JOIN) |
+| [toolbelt-find](toolbelt-find/) | `/toolbelt-find` | Upload a document, retrieve passages by semantic similarity |
+| [toolbelt-entities](toolbelt-entities/) | `/toolbelt-entities` | Auto-extract entities and relationships from docs, explore with Cypher |
+| [toolbelt-geo](toolbelt-geo/) | `/toolbelt-geo` | GPU-accelerated geospatial — distance, containment, routing, map rendering |
+| [toolbelt-stream](toolbelt-stream/) | `/toolbelt-stream` | Connect Kafka, aggregate over windows, detect anomalies |
+| [toolbelt-invite](toolbelt-invite/) | `/toolbelt-invite` | Emit a connection URL so another agent can join this workspace |
 
 ## Works with
 

package/assets/demos/{geo-analyst-demo.sh → toolbelt-geo-demo.sh}

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Simulates the geo-analyst skill running inside Claude Code
+# Simulates the toolbelt-geo skill running inside Claude Code
 
 G='\033[0;32m'   # green
 B='\033[0;34m'   # blue
@@ -10,7 +10,7 @@ W='\033[1;37m'   # bold white
 NC='\033[0m'
 
 printf "\n"
-printf "${D}> /geo-analyst${NC}\n"
+printf "${D}> /toolbelt-geo${NC}\n"
 sleep 0.8
 
 printf "\n"

package/assets/demos/{run-toolbelt-demo.sh → toolbelt-start-demo.sh}

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Simulates the run-toolbelt skill running inside Claude Code
+# Simulates the toolbelt-start skill running inside Claude Code
 
 G='\033[0;32m'   # green
 B='\033[0;34m'   # blue
@@ -10,7 +10,7 @@ W='\033[1;37m'   # bold white
 NC='\033[0m'
 
 printf "\n"
-printf "${D}> /run-toolbelt document_url=https://docs.toolbelt.ai/intro.pdf question=\"What is Toolbelt?\"${NC}\n"
+printf "${D}> /toolbelt-start document_url=https://docs.toolbelt.ai/intro.pdf question=\"What is Toolbelt?\"${NC}\n"
 sleep 0.8
 
 printf "\n"

package/bin/install.js

@@ -26,6 +26,21 @@ const PKG_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
 const TARGET = join(homedir(), '.claude', 'skills');
 const LEGACY_NESTED_DIR = join(TARGET, 'toolbelt');
 
+// Pre-0.2.0 skill folder names. Removed on install so upgraders don't
+// see ghost slash commands for skills that were renamed or merged.
+// Added 2026-04-23 with the toolbelt-* prefix rename; safe to drop this
+// list in a future major once the userbase has cycled.
+const LEGACY_SKILL_NAMES = [
+  'run-toolbelt',
+  'sql-analyst',
+  'data-blend',
+  'vector-search',
+  'knowledge-graph',
+  'geo-analyst',
+  'streaming-analyst',
+  'multi-agent-workspace',
+];
+
 /** Any top-level directory containing a SKILL.md is a skill. */
 function listSkills() {
   return readdirSync(PKG_ROOT, { withFileTypes: true })
@@ -39,6 +54,13 @@ function cleanupLegacy() {
     rmSync(LEGACY_NESTED_DIR, { recursive: true, force: true });
     console.log(`  migrated: removed legacy ~/.claude/skills/toolbelt/`);
   }
+  for (const name of LEGACY_SKILL_NAMES) {
+    const p = join(TARGET, name);
+    if (existsSync(p)) {
+      rmSync(p, { recursive: true, force: true });
+      console.log(`  migrated: removed legacy skill ${name}/`);
+    }
+  }
 }
 
 function cmdInstall() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@toolbeltai/skills",
-  "version": "0.1.3",
-  "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.",
+  "version": "0.2.0",
+  "description": "Official Toolbelt skills — named /toolbelt-* flows (start, analyze, find, entities, geo, stream, invite) that teach any MCP-capable agent to orchestrate Toolbelt's MCP tools end-to-end.",
   "license": "MIT",
   "homepage": "https://toolbelt.ai",
   "repository": {
@@ -14,14 +14,17 @@
   "author": "Toolbelt",
   "keywords": [
     "toolbelt",
-    "claude-code",
     "mcp",
-    "skills",
+    "agent-skills",
+    "claude-code",
     "openclaw",
+    "cursor",
+    "windsurf",
     "sql",
+    "rag",
     "knowledge-graph",
     "geospatial",
-    "vector-search"
+    "streaming"
   ],
   "bin": {
     "toolbelt-skills": "./bin/install.js"
@@ -29,14 +32,13 @@
   "files": [
     "bin",
     "assets",
-    "data-blend",
-    "geo-analyst",
-    "knowledge-graph",
-    "multi-agent-workspace",
-    "run-toolbelt",
-    "sql-analyst",
-    "streaming-analyst",
-    "vector-search",
+    "toolbelt-start",
+    "toolbelt-analyze",
+    "toolbelt-find",
+    "toolbelt-entities",
+    "toolbelt-geo",
+    "toolbelt-stream",
+    "toolbelt-invite",
     "LICENSE",
     "README.md"
   ],

package/{sql-analyst → toolbelt-analyze}/SKILL.md

@@ -1,13 +1,15 @@
 ---
-name: sql-analyst
+name: toolbelt-analyze
 description: >
-  Upload a CSV and answer natural-language questions by generating and executing
-  SQL. Covers totals, averages, group-by, filtering, and single-table joins on
-  tabular data. Use when an agent has structured rows/columns and needs analytical
-  answers — trends, breakdowns, comparisons, rankings. NOT for unstructured
-  documents (use knowledge-graph or vector-search), lat/lon or WKT data (use
-  geo-analyst), live streams (use streaming-analyst), or multi-table JOINs across
-  independent datasets (use data-blend).
+  Upload one or more CSV tables and answer natural-language questions by
+  generating and executing SQL. Handles single-table analytics (totals,
+  averages, group-by, filtering) AND multi-table JOINs across related
+  datasets (orders + customers, sensors + metadata, events + dimensions).
+  Use when an agent has structured rows/columns — one table or several
+  that share a key — and needs analytical answers: trends, breakdowns,
+  comparisons, rankings, correlations. NOT for unstructured documents
+  (use toolbelt-find or toolbelt-entities), lat/lon or WKT data (use
+  toolbelt-geo), or live streams (use toolbelt-stream).
 license: MIT
 compatibility: >
   Requires a Toolbelt account (provision free at https://toolbelt.ai) and an
@@ -20,15 +22,18 @@ metadata:
   homepage: "https://toolbelt.ai/docs/sql"
 ---
 
-Upload tabular data and answer natural language questions about it using
-Toolbelt MCP tools. Work through each phase in order without prompting for
-user input. On unrecoverable error, emit a structured failure and halt.
+Upload one or more CSV tables and answer natural-language questions about
+them using Toolbelt MCP tools. Handles both single-table queries and
+multi-table JOINs on related datasets — pick the right approach based on
+the uploaded data and the question. Work through each phase in order
+without prompting for user input. On unrecoverable error, emit a
+structured failure and halt.
 
 ## When Not To Use
 
-- For unstructured text or documents — use `knowledge-graph` to extract entities and relationships.
-- For real-time or streaming data — use `streaming-analyst` instead.
-- For spatial data with lat/lon coordinates — use `geo-analyst` instead.
+- For unstructured text or documents — use `toolbelt-find` (retrieval) or `toolbelt-entities` (entity/relationship extraction).
+- For real-time or streaming data — use `toolbelt-stream`.
+- For spatial data with lat/lon coordinates — use `toolbelt-geo`.
 
 ## Invocation Parameters
 
@@ -77,7 +82,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 +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. Upload CSV document | `toolbelt_save` |
 | 3. Poll for ingestion | `toolbelt_jobs` |

package/{knowledge-graph → toolbelt-entities}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: knowledge-graph
+name: toolbelt-entities
 description: >
   Upload a document; Toolbelt automatically extracts entities (people, orgs,
   places, concepts) and their relationships into a knowledge graph — no schema
@@ -7,7 +7,7 @@ description: >
   trace connections. Use when an agent needs to map who-relates-to-whom, surface
   hidden links across documents, answer multi-hop relationship questions, or
   identify central entities in a corpus. NOT for flat semantic passage retrieval
-  (use vector-search) or tabular analytics (use sql-analyst).
+  (use toolbelt-find) or tabular analytics (use toolbelt-analyze).
 license: MIT
 compatibility: >
   Requires a Toolbelt account (provision free at https://toolbelt.ai) and an
@@ -17,7 +17,7 @@ compatibility: >
 metadata:
   author: toolbeltai
   version: "1.0"
-  homepage: "https://toolbelt.ai/docs/knowledge-graph"
+  homepage: "https://toolbelt.ai/docs/toolbelt-entities"
 ---
 
 Extract a knowledge graph from a document and explore it autonomously using
@@ -26,8 +26,8 @@ user input. On unrecoverable error, emit a structured failure and halt.
 
 ## When Not To Use
 
-- For structured tabular data (CSV, SQL tables) — use `sql-analyst` instead.
-- When entity and relationship extraction is not needed — use `sql-analyst` or `streaming-analyst` for the appropriate data type.
+- For structured tabular data (CSV, SQL tables) — use `toolbelt-analyze` instead.
+- When entity and relationship extraction is not needed — use `toolbelt-analyze` or `toolbelt-stream` for the appropriate data type.
 
 ## Invocation Parameters
 
@@ -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/{vector-search → toolbelt-find}/SKILL.md

@@ -1,13 +1,13 @@
 ---
-name: vector-search
+name: toolbelt-find
 description: >
   Upload a document and retrieve passages by semantic similarity to a
   natural-language query. Ranks content by meaning, not keyword overlap. Use
   when an agent needs to ground answers in source documents (RAG), find related
   content, retrieve passages by concept, or answer "what does this doc say
   about X" where X isn't a verbatim phrase. NOT for exact keyword/regex search,
-  structured table queries (use sql-analyst), or entity-relationship extraction
-  (use knowledge-graph).
+  structured table queries (use toolbelt-analyze), or entity-relationship extraction
+  (use toolbelt-entities).
 license: MIT
 compatibility: >
   Requires a Toolbelt account (provision free at https://toolbelt.ai) and an
@@ -26,10 +26,10 @@ unrecoverable error, emit a structured failure and halt.
 
 ## When Not To Use
 
-- For structured tabular data (CSV, SQL tables) — use `sql-analyst` instead.
-- For aggregate queries, counts, or filtering by exact values — use `sql-analyst`; vector search ranks by meaning, not criteria.
-- For entity and relationship extraction — use `knowledge-graph` instead.
-- When you need a synthesized answer that may draw on SQL tables — use `sql-analyst` with `toolbelt_search` (hybrid routing) instead.
+- For structured tabular data (CSV, SQL tables) — use `toolbelt-analyze` instead.
+- For aggregate queries, counts, or filtering by exact values — use `toolbelt-analyze`; vector search ranks by meaning, not criteria.
+- For entity and relationship extraction — use `toolbelt-entities` instead.
+- When you need a synthesized answer that may draw on SQL tables — use `toolbelt-analyze` with `toolbelt_search` (hybrid routing) instead.
 
 ## How This Differs From `toolbelt_search`
 
@@ -46,7 +46,7 @@ Extract these from the args string or conversation context before starting:
 |---|---|---|
 | `namespace_id` | No | UUID of target namespace. Auto-select if omitted and only one exists; fail if ambiguous. |
 | `document_content` | No | Raw text to upload. Uses the embedded sample document if omitted. |
-| `document_name` | No | Name for the document asset. Defaults to `vector-search-sample`. |
+| `document_name` | No | Name for the document asset. Defaults to `toolbelt-find-sample`. |
 | `question` | No | Natural language query to search for. Defaults to `What are the effects on coastal ecosystems?` |
 | `skip_upload` | No | Set to `true` to skip Phases 2–3 and search existing namespace content. |
 
@@ -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.
@@ -142,7 +142,7 @@ Store the resolved `namespace_id` — pass it to every subsequent tool call.
 Skip this phase if `skip_upload` is `true`.
 
 Resolve `document_content` (use parameter value or default sample above).
-Resolve `document_name` (use parameter value or default `vector-search-sample`).
+Resolve `document_name` (use parameter value or default `toolbelt-find-sample`).
 
 Call `toolbelt_save`:
 
@@ -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` |

package/{geo-analyst → toolbelt-geo}/README.md

@@ -1,7 +1,7 @@
-# geo-analyst
+# toolbelt-geo
 
-![geo-analyst demo](../assets/geo-analyst-demo.gif)
+![toolbelt-geo demo](../assets/toolbelt-geo-demo.gif)
 
 GPU-accelerated geospatial analytics agent powered by Toolbelt MCP. Uploads lat/lon sensor data, runs geospatial SQL queries (distance, point-in-polygon, track creation), and emits structured results.
 
-Invoke via `/geo-analyst` in Claude Code, or via the `Skill` tool in any MCP-capable agent.
+Invoke via `/toolbelt-geo` in Claude Code, or via the `Skill` tool in any MCP-capable agent.

package/{geo-analyst → toolbelt-geo}/SKILL.md

@@ -1,13 +1,13 @@
 ---
-name: geo-analyst
+name: toolbelt-geo
 description: >
   GPU-accelerated geospatial analytics on Toolbelt — distance, point-in-polygon
   containment, nearest-neighbor, track creation, spatial joins. Upload lat/lon
   sensor readings or WKT geometries, then run spatial SQL queries. Use when an
   agent needs to answer geographic questions — how close is X to Y, which points
   fall inside a region, along which route, coverage overlap, or movement tracks
-  from raw GPS. NOT for non-spatial tabular analysis (use sql-analyst) or
-  document content (use vector-search).
+  from raw GPS. NOT for non-spatial tabular analysis (use toolbelt-analyze) or
+  document content (use toolbelt-find).
 license: MIT
 compatibility: >
   Requires a Toolbelt account (provision free at https://toolbelt.ai) and an
@@ -27,8 +27,8 @@ without confirmation. On unrecoverable error, emit a structured failure and halt
 
 ## When Not To Use
 
-- For tabular data without lat/lon coordinates — use `sql-analyst` instead.
-- For unstructured text or documents — use `knowledge-graph` instead.
+- For tabular data without lat/lon coordinates — use `toolbelt-analyze` instead.
+- For unstructured text or documents — use `toolbelt-entities` instead.
 
 ## Invocation Parameters
 
@@ -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/{multi-agent-workspace → toolbelt-invite}/SKILL.md

@@ -1,12 +1,12 @@
 ---
-name: multi-agent-workspace
+name: toolbelt-invite
 description: >
   Set up a Toolbelt namespace that multiple agents can share. Uploads a document,
   then emits a connection URL another agent can use to join the same workspace
   without re-ingesting. Use when handing off context between agents or sessions,
   when two agents need to collaborate on the same dataset, or when pre-staging
   data for a downstream agent. NOT needed for single-agent workflows — use
-  run-toolbelt instead.
+  toolbelt-start instead.
 license: MIT
 compatibility: >
   Requires a Toolbelt account (provision free at https://toolbelt.ai) and an
@@ -26,7 +26,7 @@ prompting for user input. On unrecoverable error, emit a structured failure and
 ## When Not To Use
 
 - For single-agent workflows where data sharing between agents is not needed.
-- When you only need to analyze data yourself — use `sql-analyst`, `streaming-analyst`, or `knowledge-graph` instead.
+- When you only need to analyze data yourself — use `toolbelt-analyze`, `toolbelt-stream`, or `toolbelt-entities` instead.
 
 ## Invocation Parameters
 
@@ -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/{run-toolbelt → toolbelt-start}/README.md

@@ -1,10 +1,10 @@
-# run-toolbelt
+# toolbelt-start
 
-![run-toolbelt demo](../assets/run-toolbelt-demo.gif)
+![toolbelt-start demo](../assets/toolbelt-start-demo.gif)
 
 Autonomous end-to-end Toolbelt agent. Provisions a namespace, ingests documents, connects streaming data sources, and answers questions — all without human interaction.
 
-Invoke via `/run-toolbelt` in Claude Code, or via the `Skill` tool in any MCP-capable agent.
+Invoke via `/toolbelt-start` in Claude Code, or via the `Skill` tool in any MCP-capable agent.
 
 ---
 
@@ -31,7 +31,7 @@ Invoke via `/run-toolbelt` in Claude Code, or via the `Skill` tool in any MCP-ca
 ### Smoke test — connection and namespace only
 
 ```
-/run-toolbelt
+/toolbelt-start
 ```
 
 Runs phases 0–2. Verifies the MCP connection is live and resolves your namespace. No data is written.
@@ -41,11 +41,11 @@ Runs phases 0–2. Verifies the MCP connection is live and resolves your namespa
 ### Ingest a document and ask a question
 
 ```
-/run-toolbelt document_url=https://example.com/report.pdf question="What are the key findings?"
+/toolbelt-start document_url=https://example.com/report.pdf question="What are the key findings?"
 ```
 
 ```
-/run-toolbelt document_content="Q1 revenue was $4.2M across three product lines." document_name="q1-summary" question="What was Q1 revenue?"
+/toolbelt-start document_content="Q1 revenue was $4.2M across three product lines." document_name="q1-summary" question="What was Q1 revenue?"
 ```
 
 ---
@@ -53,7 +53,7 @@ Runs phases 0–2. Verifies the MCP connection is live and resolves your namespa
 ### Target a specific namespace
 
 ```
-/run-toolbelt namespace_id=<uuid> document_url=https://example.com/report.pdf question="Summarize this."
+/toolbelt-start namespace_id=<uuid> document_url=https://example.com/report.pdf question="Summarize this."
 ```
 
 Required when your account has multiple namespaces. Omit to auto-select when only one exists.
@@ -63,7 +63,7 @@ Required when your account has multiple namespaces. Omit to auto-select when onl
 ### Connect a Kafka source
 
 ```
-/run-toolbelt kafka_broker=kafka-broker:9092 kafka_topic=events kafka_schema="id INTEGER, event VARCHAR(256), ts TIMESTAMP"
+/toolbelt-start kafka_broker=kafka-broker:9092 kafka_topic=events kafka_schema="id INTEGER, event VARCHAR(256), ts TIMESTAMP"
 ```
 
 Connects the topic and verifies it is queryable. Combine with `question` to search over streaming data.
@@ -73,7 +73,7 @@ Connects the topic and verifies it is queryable. Combine with `question` to sear
 ### Full pipeline
 
 ```
-/run-toolbelt \
+/toolbelt-start \
   namespace_id=<uuid> \
   document_url=https://example.com/report.pdf \
   kafka_broker=kafka-broker:9092 \
@@ -89,7 +89,7 @@ Runs all phases: document ingestion, Kafka connection, and cross-source search.
 ### From another agent (Skill tool)
 
 ```javascript
-{ skill: "run-toolbelt", args: "namespace_id=<uuid> document_url=https://... question=..." }
+{ skill: "toolbelt-start", args: "namespace_id=<uuid> document_url=https://... question=..." }
 ```
 
 The skill emits a structured `RESULT:` block — parseable by the calling agent without human interpretation.

package/{run-toolbelt → toolbelt-start}/SKILL.md

@@ -1,12 +1,12 @@
 ---
-name: run-toolbelt
+name: toolbelt-start
 description: >
   Provision a Toolbelt namespace, ingest a document or Kafka stream, and answer
   a question end-to-end — autonomously, without human steps. Use when an agent
   needs to set up a fresh Toolbelt workspace, add assets from scratch, connect a
   streaming source, or run a complete ingest→query pipeline. NOT for querying
-  data that is already ingested — use sql-analyst, vector-search, or
-  knowledge-graph for that.
+  data that is already ingested — use toolbelt-analyze, toolbelt-find, or
+  toolbelt-entities for that.
 license: MIT
 compatibility: >
   Requires a Toolbelt account (provision free at https://toolbelt.ai) and an
@@ -27,8 +27,8 @@ without confirmation. On unrecoverable error, emit a structured failure and halt
 ## When Not To Use
 
 - When the Toolbelt MCP connection is not yet established — the connection must exist before invocation.
-- When you only need to query data already in Toolbelt — use `sql-analyst` instead.
-- When you only need to upload and analyze a CSV — use `sql-analyst` instead.
+- When you only need to query data already in Toolbelt — use `toolbelt-analyze` instead.
+- When you only need to upload and analyze a CSV — use `toolbelt-analyze` instead.
 
 ## Invocation Parameters
 
@@ -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/{streaming-analyst → toolbelt-stream}/SKILL.md

@@ -1,12 +1,12 @@
 ---
-name: streaming-analyst
+name: toolbelt-stream
 description: >
   Connect a live Kafka topic (or use built-in simulated data) and run windowed
   aggregations plus standard-deviation anomaly detection on the stream. Use when
   an agent needs to analyze real-time or time-series data — IoT sensor readings,
   event logs, security events, fleet telemetry, transaction feeds — and answer
   questions about rates, trends, and outliers over time windows. NOT for static
-  tabular files (use sql-analyst) or document content (use vector-search).
+  tabular files (use toolbelt-analyze) or document content (use toolbelt-find).
 license: MIT
 compatibility: >
   Requires a Toolbelt account (provision free at https://toolbelt.ai) and an
@@ -27,7 +27,7 @@ failure and halt.
 
 ## When Not To Use
 
-- For static batch tabular data — use `sql-analyst` instead.
+- For static batch tabular data — use `toolbelt-analyze` instead.
 - When real-time monitoring, windowed aggregation, or anomaly detection is not the goal.
 
 ## Invocation Parameters
@@ -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/data-blend/SKILL.md

@@ -1,280 +0,0 @@
----
-name: data-blend
-description: >
-  Upload two or more CSV tables into one Toolbelt namespace and run cross-table
-  JOIN queries to correlate them. Use when an agent has related datasets that
-  need to be combined — orders + customers, sensors + metadata, events +
-  dimensions, transactions + accounts — and questions span multiple tables that
-  share a key. NOT for single-table analysis (use sql-analyst), unstructured
-  text (use knowledge-graph), or entity-level relationship mapping across free
-  text (use knowledge-graph).
-license: MIT
-compatibility: >
-  Requires a Toolbelt account (provision free at https://toolbelt.ai) and an
-  MCP-compatible AI agent (Claude Code, Claude Desktop, OpenClaw, or any client
-  that supports MCP server connections). MCP connection must be pre-established
-  before invocation.
-metadata:
-  author: toolbeltai
-  version: "1.0"
-  homepage: "https://toolbelt.ai/docs/sql"
----
-
-Upload multiple tables and run cross-table JOIN queries using Toolbelt MCP tools.
-Work through each phase in order without prompting for user input. On
-unrecoverable error, emit a structured failure and halt.
-
-## When Not To Use
-
-- For a single table — use `sql-analyst` instead.
-- For unstructured text or documents — use `knowledge-graph` instead.
-- For streaming/real-time data — use `streaming-analyst` instead.
-- For spatial data with lat/lon — use `geo-analyst` instead.
-
-## Invocation Parameters
-
-Extract these from the args string or conversation context before starting:
-
-| Parameter | Required | Description |
-|---|---|---|
-| `namespace_id` | No | UUID of target namespace. Auto-select if omitted and only one exists; fail if ambiguous. |
-| `table_a_content` | No | Raw CSV for the first table. Uses default `orders` sample if omitted. |
-| `table_a_name` | No | Asset name for the first table. Defaults to `orders`. |
-| `table_b_content` | No | Raw CSV for the second table. Uses default `customers` sample if omitted. |
-| `table_b_name` | No | Asset name for the second table. Defaults to `customers`. |
-| `join_query` | No | Custom SQL JOIN to execute in Phase 5. Uses default query if omitted. |
-| `skip_upload` | No | Set to `true` to skip Phases 2–4 and query tables already in the namespace. |
-
----
-
-## Default Sample Data
-
-If no `table_a_content` is provided, use this orders dataset verbatim:
-
-```
-order_id,customer_id,product,category,quantity,amount,order_date
-1001,C001,Widget Pro,Hardware,12,599.88,2024-01-05
-1002,C003,Gadget Basic,Software,5,149.95,2024-01-08
-1003,C002,Widget Pro,Hardware,8,399.92,2024-01-12
-1004,C004,Service Plan,Services,3,597.00,2024-01-15
-1005,C001,Gadget Basic,Software,20,599.80,2024-01-19
-1006,C005,Widget Pro,Hardware,6,299.94,2024-01-22
-1007,C003,Service Plan,Services,2,398.00,2024-02-03
-1008,C002,Gadget Plus,Software,15,1199.85,2024-02-07
-1009,C001,Widget Pro,Hardware,10,499.90,2024-02-11
-1010,C004,Gadget Basic,Software,8,239.92,2024-02-14
-1011,C005,Gadget Plus,Software,4,319.96,2024-02-18
-1012,C002,Service Plan,Services,1,199.00,2024-02-21
-1013,C001,Service Plan,Services,5,995.00,2024-03-02
-1014,C005,Gadget Plus,Software,9,719.91,2024-03-06
-1015,C003,Widget Pro,Hardware,7,349.93,2024-03-10
-1016,C002,Gadget Basic,Software,11,329.89,2024-03-14
-1017,C004,Gadget Plus,Software,6,479.94,2024-03-18
-1018,C005,Service Plan,Services,4,796.00,2024-03-22
-1019,C003,Widget Pro,Hardware,3,149.97,2024-03-25
-1020,C002,Widget Pro,Hardware,14,699.86,2024-03-28
-```
-
-If no `table_b_content` is provided, use this customers dataset verbatim:
-
-```
-customer_id,name,region,segment,account_manager
-C001,Meridian Corp,Northeast,Enterprise,Alice Chen
-C002,Delta Systems,Midwest,Enterprise,Carol Singh
-C003,Apex Solutions,Southeast,Mid-Market,Bob Martinez
-C004,Crest Industries,West,Mid-Market,David Park
-C005,Solaris Group,West,SMB,Emma Lopez
-```
-
-Default `join_query`:
-```sql
-SELECT
-  c.segment,
-  c.region,
-  COUNT(o.order_id) AS order_count,
-  ROUND(SUM(o.amount), 2) AS total_amount,
-  ROUND(AVG(o.amount), 2) AS avg_order_value
-FROM <orders_table> o
-JOIN <customers_table> c ON o.customer_id = c.customer_id
-GROUP BY c.segment, c.region
-ORDER BY total_amount DESC
-```
-
----
-
-## Phase 0: Verify Connection
-
-Call `get_semantic_names` (no arguments) immediately.
-
-- **If it succeeds:** proceed to Phase 1 using the returned namespaces.
-- **If it fails:** emit structured failure and halt.
-
-```
-FAILURE: Toolbelt MCP connection is not established.
-The MCP server must be connected before invoking this skill.
-See: https://toolbelt.ai/docs/mcp for setup instructions.
-```
-
----
-
-## Phase 1: Resolve Namespace
-
-Use the namespaces returned from Phase 0.
-
-Resolution order:
-1. If `namespace_id` was provided as a parameter, use it directly.
-2. If only one namespace exists, use it.
-3. If multiple exist and no `namespace_id` was specified, emit structured failure and halt.
-
-```
-FAILURE: Multiple namespaces found and none specified.
-Available: [<list namespace display names and IDs>]
-Re-invoke with namespace_id=<uuid>.
-```
-
-Store the resolved `namespace_id` — pass it to every subsequent tool call.
-
----
-
-## Phase 2: Inspect Existing Tables
-
-Skip this phase if `skip_upload` is `true` — go directly to Phase 5.
-
-Call `toolbelt_context` with `{ "namespace_id": "<namespace_id>" }`.
-
-Check whether tables matching `table_a_name` and `table_b_name` already exist:
-- If both exist: skip Phases 3–4 and proceed to Phase 5 using their existing table names.
-- If one or both are missing: upload the missing ones in Phase 3.
-
-Store all resolved table names for use in Phase 5.
-
----
-
-## Phase 3: Upload Missing Tables
-
-For each table that does not already exist, call `toolbelt_save`:
-
-```json
-{
-  "asset_type": "document",
-  "namespace_id": "<namespace_id>",
-  "name": "<table_a_name or table_b_name>",
-  "file_name": "<name>.csv",
-  "content": "<csv_content>",
-  "content_encoding": "text",
-  "data_format": "csv"
-}
-```
-
-Record each returned `asset_id`.
-
----
-
-## Phase 4: Poll for Ingestion
-
-Call `toolbelt_jobs` with `{ "namespace_id": "<namespace_id>" }` every 10 seconds.
-
-Wait for the `ingest` job for each uploaded asset to reach `completed`. Typical duration: 15–60 seconds per table. Maximum wait: 3 minutes.
-
-If any job reaches `failed` or the timeout elapses, emit structured failure and halt:
-```
-FAILURE: Table ingestion did not complete.
-Asset: <table name>
-Job status: <last observed status>
-```
-
-After all jobs complete, call `toolbelt_context` to retrieve the final SQL table names for all assets. Store as `table_a` and `table_b`.
-
----
-
-## Phase 5: Run Blend Queries
-
-Substitute `<orders_table>` and `<customers_table>` (or equivalent names) in all queries with the resolved table names from Phase 4 (or Phase 2 if skip_upload).
-
-### Query 1 — Join summary (default or custom)
-
-If `join_query` was provided, execute it directly. Otherwise execute the default query, substituting the resolved table names:
-
-```json
-{
-  "namespace_id": "<namespace_id>",
-  "query": "<join_query with table names substituted>"
-}
-```
-
-Use `toolbelt_sql` for this call. Record:
-- `join_rows`: number of rows returned
-- `join_results`: up to 10 rows
-
-### Query 2 — Row counts
-
-Confirm both tables are populated:
-
-```sql
-SELECT '<table_a>' AS table_name, COUNT(*) AS row_count FROM <table_a>
-UNION ALL
-SELECT '<table_b>' AS table_name, COUNT(*) AS row_count FROM <table_b>
-```
-
-Record `row_counts` for each table.
-
-### Query 3 — Unmatched rows check
-
-Identify rows in table A with no match in table B (join integrity check):
-
-```sql
-SELECT COUNT(*) AS unmatched_count
-FROM <table_a> a
-LEFT JOIN <table_b> b ON a.<join_key> = b.<join_key>
-WHERE b.<join_key> IS NULL
-```
-
-Infer `<join_key>` from the shared column names visible in the schema context. If no shared key can be inferred, skip this query and note it in the RESULT.
-
-Record `unmatched_count`.
-
----
-
-## Phase 6: Structured Output
-
-After all phases complete, emit a single structured result:
-
-```
-RESULT:
-  namespace_id: <uuid>
-  phases_run: [0, 1, 2, 3, 4, 5]
-
-  tables:
-    table_a: <sql table name>
-    table_b: <sql table name>
-    row_counts:
-      <table_a>: <count>
-      <table_b>: <count>
-    unmatched_rows: <count or "skipped — no shared key inferred">
-
-  blend_query:
-    sql: |
-      <query executed>
-    row_count: <join_rows>
-    results:
-      - <row 1>
-      - <row 2>
-      ... (up to 10 rows)
-```
-
-If any Phase 5 query fails, include `query_error: "<error>"` under that query's
-section and continue. Only halt on Phase 0–3 failures.
-
----
-
-## Tool Reference
-
-| Phase | Tool(s) |
-|---|---|
-| 0. Verify connection | `get_semantic_names` |
-| 1. Resolve namespace | (from Phase 0 result) |
-| 2. Inspect existing tables | `toolbelt_context` |
-| 3. Upload missing tables | `toolbelt_save` |
-| 4. Poll for ingestion | `toolbelt_jobs`, `toolbelt_context` |
-| 5. Run blend queries | `toolbelt_sql`, `toolbelt_execute` |
-| 6. Emit result | (structured output) |