Skip to content

Commit 759cef1

Browse files
committed
docs(skills): fix CLI drift + consolidate hotdata-search into the core skill
Two changes to the bundled agent skills: 1. Drift fixes (audited against `hotdata … --help` on v0.21.0): - hotdata-geospatial: `tables list --connection-id <id>` (3 occurrences) used a flag that does not exist and errored on the first discovery step — replaced with real `tables list` / `tables show` / `databases tables list`. - hotdata-analytics: dropped the phantom `connections` command from prerequisites. - hotdata (core): added `managed_load` to `jobs --job-type`; added `--result-id` to the `databases load` / `tables load` synopses; documented `query status` exit codes (0/1/2/3). 2. Consolidated `hotdata-search` into the core `hotdata` skill: - Merged the search / indexes / embedding-providers content into a new "Search & retrieval indexes" section in `skills/hotdata/SKILL.md`; moved `references/INDEXES.md` under the core skill. - Removed `hotdata-search` from `SKILL_NAMES` (src/commands/skill.rs) and the cargo-release version-bump list (Cargo.toml); updated the core frontmatter, sub-skill table, decision tree, and all cross-references in the analytics / geospatial skills and reference docs; deleted `skills/hotdata-search/`. Tradeoff: the always-loaded core skill grows ~80 lines; search is now discoverable without loading a separate skill. `cargo build` clean; `hotdata skills list` now lists 3 skills.
1 parent 2dc678e commit 759cef1

11 files changed

Lines changed: 85 additions & 133 deletions

File tree

‎Cargo.toml‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,6 @@ pre-release-hook = ["git-cliff", "--unreleased", "--tag", "v{{version}}", "--pre
7676
publish = false
7777
pre-release-replacements = [
7878
{ file = "skills/hotdata/SKILL.md", search = "^version: .+", replace = "version: {{version}}", exactly = 1 },
79-
{ file = "skills/hotdata-search/SKILL.md", search = "^version: .+", replace = "version: {{version}}", exactly = 1 },
8079
{ file = "skills/hotdata-analytics/SKILL.md", search = "^version: .+", replace = "version: {{version}}", exactly = 1 },
8180
{ file = "skills/hotdata-geospatial/SKILL.md", search = "^version: .+", replace = "version: {{version}}", exactly = 1 },
8281
# README.md no longer carries a hardcoded version badge — it tracks GitHub releases.

‎skills/hotdata-analytics/SKILL.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
name: hotdata-analytics
3-
description: Use this skill when the user wants OLAP-style SQL analytics in Hotdata — aggregations, GROUP BY, JOINs, reporting, exploratory queries, query run history, stored results, or materialized follow-up tables (Chain into managed databases). Activate for "analyze", "aggregate", "rollup", "pivot", "report", "metrics", "GROUP BY", "query history", "past queries", "query runs", "stored results", "materialize", "chain", "intermediate table", or sorted indexes for filters/range scans. Do not load for BM25/vector search or geospatial SQL — use hotdata-search or hotdata-geospatial. Requires the core hotdata skill for tables and auth.
3+
description: Use this skill when the user wants OLAP-style SQL analytics in Hotdata — aggregations, GROUP BY, JOINs, reporting, exploratory queries, query run history, stored results, or materialized follow-up tables (Chain into managed databases). Activate for "analyze", "aggregate", "rollup", "pivot", "report", "metrics", "GROUP BY", "query history", "past queries", "query runs", "stored results", "materialize", "chain", "intermediate table", or sorted indexes for filters/range scans. Do not load for BM25/vector search or geospatial SQL — use the core hotdata skill (search section) or hotdata-geospatial. Requires the core hotdata skill for tables and auth.
44
version: 0.21.0
55
---
66

77
# Hotdata Analytics Skill
88

99
**OLAP-style analytics** in Hotdata: PostgreSQL-dialect SQL, query execution, run history, stored results, **Chain** materializations, and **sorted** indexes for filters and joins.
1010

11-
**Prerequisites:** Authenticate, workspace, and catalog discovery via the **`hotdata`** skill (`connections`, `tables`, `databases`).
11+
**Prerequisites:** Authenticate, workspace, and catalog discovery via the **`hotdata`** skill (`tables`, `databases`; attach a connection as a queryable catalog with `databases attach`).
1212

13-
**Related skills:** **`hotdata-search`** (BM25, vector, retrieval indexes), **`hotdata-geospatial`** (spatial SQL).
13+
**Related skills:** the core **`hotdata`** skill (BM25/vector search + retrieval indexes), **`hotdata-geospatial`** (spatial SQL).
1414

1515
---
1616

@@ -103,7 +103,7 @@ Full procedure: [references/WORKFLOWS.md](references/WORKFLOWS.md).
103103

104104
## Sorted indexes (filters and range scans)
105105

106-
For equality, range, and sort-heavy OLAP — not full-text or vector (see **`hotdata-search`**):
106+
For equality, range, and sort-heavy OLAP — not full-text or vector (see the core **`hotdata`** skill → Search & retrieval indexes):
107107

108108
```bash
109109
hotdata indexes create --catalog <catalog-alias> --schema <schema> --table <table> \

‎skills/hotdata-analytics/references/WORKFLOWS.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
OLAP-style SQL, **History** (query runs and stored results), and **Chain** (materialized follow-ups). Requires **`hotdata`** for auth, workspaces, and catalog commands.
44

5-
**Related:** **`hotdata-search`** for BM25/vector indexes and `hotdata search`; **`hotdata`** [WORKFLOWS.md](../../hotdata/references/WORKFLOWS.md) for managed databases.
5+
**Related:** the core **`hotdata`** skill for BM25/vector indexes and `hotdata search`; **`hotdata`** [WORKFLOWS.md](../../hotdata/references/WORKFLOWS.md) for managed databases.
66

77
---
88

@@ -24,7 +24,7 @@ hotdata queries <query_run_id>
2424
- `<query_run_id>` — full metadata (timings, `result_id`, snapshot, hashes) and formatted SQL.
2525
- If a run has a `result_id`, fetch rows with `hotdata results <result_id>` below.
2626

27-
Use history to spot recurring `WHERE`, `JOIN`, `GROUP BY`, or search-style SQL before adding indexes (**`hotdata-search`**) or new Chain tables.
27+
Use history to spot recurring `WHERE`, `JOIN`, `GROUP BY`, or search-style SQL before adding indexes (core **`hotdata`** skill) or new Chain tables.
2828

2929
### Stored results
3030

‎skills/hotdata-geospatial/SKILL.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ version: 0.21.0
88

99
Hotdata supports a subset of PostGIS-style functions in **PostgreSQL-dialect SQL**. This skill is data-agnostic — apply it to any table with geometry columns.
1010

11-
**Requires the core `hotdata` skill** for auth, workspace, and table discovery. **Related:** **`hotdata-analytics`** (OLAP SQL), **`hotdata-search`** (BM25/vector).
11+
**Requires the core `hotdata` skill** for auth, workspace, table discovery, and **search/retrieval indexes** (BM25/vector). **Related:** **`hotdata-analytics`** (OLAP SQL).
1212

1313
## Running these queries
1414

@@ -20,7 +20,7 @@ hotdata query "<sql>" [--workspace-id <id>] [--database <db>] [--output table|js
2020

2121
- **Fully qualify tables** as `<connection>.<schema>.<table>` (or `<catalog>.<schema>.<table>` for a managed database) — every `<table>` placeholder below means a qualified name.
2222
- **PostgreSQL dialect:** double-quote any non-lowercase identifier (e.g. `"GeoID"`).
23-
- Discover candidate tables/columns with **`hotdata tables list --connection-id <id>`** (connection tables) or **`hotdata databases tables`** (tables inside a managed database) — see core skill.
23+
- Discover candidate tables/columns with **`hotdata tables list`** (all workspace tables; narrow with `--schema`/`--table` wildcards) or **`hotdata databases tables list`** (tables inside a managed database), then inspect column types with **`hotdata tables show <catalog.schema.table>`** — see core skill.
2424

2525
---
2626

@@ -46,7 +46,7 @@ wkb_geometry_bbox['xmin'] -- ✓ works
4646
(wkb_geometry_bbox).xmin -- ✗ not supported
4747
```
4848

49-
Find these columns by their `Binary` / `Struct` types in `hotdata tables list --connection-id <id>`.
49+
Find these columns by their `Binary` / `Struct` types with `hotdata tables show <catalog.schema.table>` (or scan `hotdata tables list`).
5050

5151
---
5252

@@ -155,7 +155,7 @@ SELECT <id_col>, ST_AsText(ST_Simplify(ST_GeomFromWKB(wkb_geometry), 0.0001)) AS
155155

156156
## Workflow: explore a new geospatial table
157157

158-
1. **Find geometry columns** — `hotdata tables list --connection-id <id>`; look for `Binary` (WKB) / `Struct` (bbox) types.
158+
1. **Find geometry columns** — `hotdata tables list`, then `hotdata tables show <catalog.schema.table>`; look for `Binary` (WKB) / `Struct` (bbox) types.
159159
2. **Geometry types** — run the "Geometry types in a table" pattern above.
160160
3. **Coverage / extent** — aggregate the bbox struct:
161161
```sql

‎skills/hotdata-search/SKILL.md‎

Lines changed: 0 additions & 96 deletions
This file was deleted.

0 commit comments

Comments
 (0)