Claude Skills
The Quanton Operator ships two Claude Code skills (slash commands) that automate the full local setup and benchmarking workflow from your terminal.
Getting started
Install Claude Code, then start it in the root of the quanton-operator repo:
git clone https://github.com/onehouseinc/quanton-operator
cd quanton-operator
claude
You'll need onehouse-values.yaml from the Onehouse console to install the operator.
Available skills
/setup-and-run-example
Sets up a complete local Quanton environment from scratch and runs a sample SparkPi job end-to-end.
What it does:
- Checks for prerequisites (minikube, Helm, kubectl, Docker)
- Starts minikube if not running
- Installs the Kubeflow Spark Operator
- Installs the Quanton Operator using your
onehouse-values.yaml - Submits the example
QuantonSparkApplication - Streams logs until the job completes and prints the result
Usage:
/setup-and-run-example
Claude walks you through each step interactively, handles errors, and gives live progress updates as jobs run.
/run-tpcds-benchmark
Runs the full TPC-DS benchmark comparing OSS Apache Spark vs Quanton on your local minikube cluster.
What it does:
- Asks for scale factor (default: SF=1) and configuration options
- Builds the datagen Docker image in minikube's daemon
- Generates TPC-DS Parquet data
- Runs 99 TPC-DS queries on OSS Spark (baseline)
- Runs 99 TPC-DS queries on Quanton
- Produces a per-query comparison table with speedup multipliers
Usage:
/run-tpcds-benchmark
Claude gives live progress updates as each phase runs and summarizes the results when complete.
How skills work
Claude Code skills are slash commands defined in the repository's .claude/ directory. When you run /setup-and-run-example or /run-tpcds-benchmark, Claude Code expands the command into a full task prompt and executes it using the tools available in your terminal (kubectl, helm, docker, etc.).
Skills can:
- Run shell commands in your local environment
- Read and write files
- Stream output from long-running processes
- Ask clarifying questions and respond to errors interactively
Prerequisites for skills
| Skill | Requirements |
|---|---|
/setup-and-run-example | minikube, Helm, kubectl, Docker, onehouse-values.yaml |
/run-tpcds-benchmark | minikube (4+ CPU, 8+ GB, 50+ GB disk), Spark Operator, Quanton Operator already installed |
The default ARM Quanton build is optimized for AWS Graviton and may fail on older Apple Silicon Macs that don't support the latest ARM instruction sets. If you hit instruction set errors, use a cloud-based Spark cluster instead.