ClickHouse Agent Skills

Официальные скиллы ClickHouse: правила схем и запросов, архитектурные решения, chDB для Python и работа с ClickHouse Cloud

562 ★ репозитория
Последний коммит 19 окт. 2026
Apache-2.0

СкиллВыбор редакции

clickhouse/agent-skillsАвтор:ClickHouse

Установка

Работает в: Claude Code
Cursor
Windsurf
GitHub Copilot
Gemini CLI
Cline
Codex
Goose
Roo Code
Amp
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/clickhouse-agent-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

Скиллы chdb-sql и chdb-datastore просят агента запустить scripts/verify_install.py
Облачные сценарии ведут агента через команды clickhousectl к аккаунту ClickHouse Cloud

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

Что делает

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

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

Подходит, если

Проектируете таблицу и выбираете ORDER BY и типы колонок
Медленные запросы или JOIN в ClickHouse
Нужно быстро посчитать данные из Parquet или CSV в Python через chDB
Разворачиваете ClickHouse локально или в ClickHouse Cloud через clickhousectl

Не подходит, если

Проект не использует ClickHouse или chDB
Нужен прямой доступ агента к базе: для этого есть отдельный MCP-сервер ClickHouse

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

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

Ограничения

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

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

Частые вопросы

Чем это отличается от MCP-сервера ClickHouse?

MCP-сервер дает агенту доступ к базе, а скиллы учат его правильно проектировать схемы и писать запросы. Их можно использовать вместе.

Нужен ли ClickHouse Cloud?

Нет, правила и chDB работают с открытым ClickHouse. Облако нужно только для облачных сценариев clickhousectl и ClickStack.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

ClickHouse MCP Server

Выбор редакции

Официальный MCP-сервер ClickHouse: агент смотрит базы и таблицы и выполняет SQL, по умолчанию только на чтение

MCP-серверРасширенный доступ898

Altinity MCP Server

MCP-сервер на Go для запросов к ClickHouse: схемы, SQL, инструменты из представлений, OAuth и развертывание в Kubernetes

MCP-серверШирокий доступ38

Tinybird Agent Skills

Официальные скиллы Tinybird: правила датафайлов и SQL, работа с CLI tb и SDK для TypeScript и Python

СкиллМинимальный доступ22

Elastic Agent Skills

Выбор редакции

Официальные скиллы Elastic для Elasticsearch, Kibana, Observability, Security и Elastic Cloud: ES|QL, индексы, дашборды, триаж алертов

ПлагинШирокий доступ602

Databricks AI Dev Kit

Нужен VPN

Набор Databricks Field Engineering для агентов: установщик скиллов Databricks, MCP-сервер и визуальный Builder App

ПлагинШирокий доступ2 тыс.

Lieflat Charts

Скилл визуализации данных для агентов: превращает данные в аккуратные интерактивные HTML-графики и целые отчеты с единым визуальным языком

СкиллМинимальный доступ6,5 тыс.

Коротко о 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.

Бейдж для README

Исходный 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
```

Сообщить о проблеме