Agent Skills

Agent skills are machine-readable instructions that teach coding assistants — Claude Code, Cursor, and others — how to use the Hotdata CLI on your behalf. Once installed, your agent can list workspaces, run queries, create managed databases, and manage connections without you copying commands by hand.

Claude Code integration (YouTube):

Install

Skills ship inside hotdata-cli. Install or refresh them with:

hotdata skills install

This writes skill files into the directories that Claude Code, Cursor, and other supported agents watch for instructions. Check which skills are present:

hotdata skills status

How it works

Skills are structured Markdown files (under skills/hotdata-cli in the CLI repo) that describe:

What the CLI can do — commands, flags, and expected output
When to use each command — context and preconditions
How to chain commands — multi-step workflows like create → load → query

The agent reads these files at startup and uses them to decide which hotdata commands to run in response to your natural-language requests.

You stay in control: the CLI and API rules still apply. The skill teaches the agent how to call them — it does not grant any new permissions.

Example: ask your agent to query data

After installation, open Claude Code (or Cursor) in a project and ask:

List my workspaces, then run SELECT COUNT(*) FROM default.public.orders
using the mydb managed database.

The agent will:

Run hotdata workspaces list to find the active workspace
Run hotdata query "SELECT COUNT(*) FROM default.public.orders" --database mydb
Return the result inline in the chat

Supported agents

Agent	Supported
Claude Code	yes
Cursor	yes
Other agents that read skill files	yes

Configuration

Skills use your existing login and workspace config at ~/.hotdata/config.yml. No additional setup is needed after hotdata auth and hotdata workspaces set.

To re-install after updating the CLI: