ClickHouse Agent Skills

Установка

npx skills add clickhouse/agent-skills

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Набор скиллов от команды ClickHouse учит агента проектировать таблицы, выбирать ключи сортировки и типы данных, оптимизировать JOIN и настраивать загрузку данных. Отдельный скилл помогает принимать архитектурные решения для real-time нагрузок: стратегии вставки, партиционирование, апсерты и предагрегацию. Скиллы chdb-sql и chdb-datastore покрывают встроенный ClickHouse для Python, в том числе pandas-совместимый API и запросы к файлам и чужим базам. Есть сценарии для clickhousectl (локальная разработка и ClickHouse Cloud), управляемого Postgres, OpenTelemetry-коллектора в ClickStack и разбора ошибок Node.js-клиента.

Для кого. Для разработчиков и аналитиков, которые строят схемы, запросы и пайплайны на ClickHouse или chDB.

Пример запроса к агенту

Создай таблицу для событий пользователей с user_id, event_type, JSON-свойствами и временем, по правилам ClickHouse

Ограничения

Скиллы дают знания и инструкции, но сами к базе не подключаются. Сценарии для облака требуют аккаунта ClickHouse Cloud, управляемый Postgres находится в бете. chDB работает на macOS и Linux с Python 3.9+.

Как отключить. Удалите папки скиллов из каталога skills вашего агента или удалите плагин через /plugin.

Проверка безопасности

• Скиллы состоят из инструкций и справочников, облачные сценарии предлагают команды clickhousectl, которые агент выполняет с вашего согласия

Коротко о README

README перечисляет скиллы репозитория: свод правил по схемам, запросам и загрузке с приоритетами, архитектурный советник, chDB SQL и DataStore, сценарии clickhousectl для ClickHouse и Postgres, настройку OpenTelemetry для ClickStack и диагностику Node.js-клиента. Установка через npx skills add или через clickhousectl skills. Скиллы следуют спецификации agentskills.io и работают в Claude Code, Cursor, Windsurf, Copilot, Gemini CLI, Codex и других агентах. Лицензия Apache 2.0.

SKILL.md

---
name: chdb-datastore
description: >-
  Use when the user has tabular data (pandas DataFrame, parquet, csv,
  Arrow, json) and wants to filter, group, aggregate, join, or speed
  up slow pandas. Provides chDB DataStore — same pandas API,
  ClickHouse engine underneath. Also handles reading from S3, MySQL,
  PostgreSQL, MongoDB, ClickHouse Cloud, Iceberg, Delta Lake as
  DataFrames and joining across sources.
  TRIGGER when: user mentions DataFrame, parquet, csv, "fast pandas",
  "speed up pandas", or cross-source DataFrame joins; user imports
  `chdb.datastore` or `from datastore import DataStore`.
  SKIP this skill for raw SQL syntax (use chdb-sql instead),
  ClickHouse server administration, or non-Python DataStore API work.
license: Apache-2.0
compatibility: Requires Python 3.9+, macOS or Linux. pip install chdb.
metadata:
  author: chdb-io
  version: "4.1"
  homepage: https://clickhouse.com/docs/chdb
---

# chdb DataStore — It's Just Faster Pandas

## The Key Insight

```python
# Change this:
import pandas as pd
# To this:
import chdb.datastore as pd
# Everything else stays the same.
```

DataStore is a **lazy, ClickHouse-backed pandas replacement**. Your existing pandas code works unchanged — but operations compile to optimized SQL and execute only when results are needed (e.g., `print()`, `len()`, iteration).

```bash
pip install chdb
```

Похожие