Официальные навыки агента для ClickHouse. Эти навыки помогают LLM и агентам внедрять лучшие практики при работе с ClickHouse и chdb (в процессе ClickHouse для Python).

Вы можете использовать эти навыки с открытым исходным кодом ClickHouse и управляемым ClickHouse Cloud. Попробуйте ClickHouse Cloud с бесплатными кредитами на $300.

Установка

NPX

CLI автоматически определяет установленные агенты и предлагает выбрать место установки.

clickhousectl

Используйте ClickHouse CLI clickhousectl для установки навыков агента:

Что это?

Агентские навыки — это комплектные инструкции, расширяющие агенты кодирования ИИ (Claude Code, Cursor, Copilot и др.) с помощью специализированной экспертизы. Этот репозиторий предоставляет навыки для баз данных ClickHouse и chdb — охватывая проектирование схем, оптимизацию запросов, шаблоны поглощения данных и аналитику в процессе на Python.

Когда агент загружает эти навыки, он получает знания о лучших практиках ClickHouse и chdb API и может применять их, помогая вам проектировать таблицы, писать запросы, анализировать данные или решать проблемы с производительностью.

Навыки соответствуют открытой спецификации agentskills.io.

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

Лучшие практики ClickHouse

ClickHouse Agent Skills

The official Agent Skills for ClickHouse. These skills help LLMs and agents to adopt best practices when working with ClickHouse and chdb (in-process ClickHouse for Python).

You can use these skills with open-source ClickHouse and managed ClickHouse Cloud. Try ClickHouse Cloud with $300 in free credits.

Installation

npx

npx skills add clickhouse/agent-skills

The CLI auto-detects installed agents and prompts you to select where to install.

clickhousectl

Use the ClickHouse CLI clickhousectl to install the agent skills:

clickhousectl skills

What is this?

Agent Skills are packaged instructions that extend AI coding agents (Claude Code, Cursor, Copilot, etc.) with domain-specific expertise. This repository provides skills for ClickHouse databases and chdb — covering schema design, query optimization, data ingestion patterns, and in-process analytics with Python.

When an agent loads these skills, it gains knowledge of ClickHouse best practices and chdb APIs, and can apply them while helping you design tables, write queries, analyze data, or troubleshoot performance issues.

Skills follow the open specification at agentskills.io.

Available Skills

ClickHouse Best Practices

28 rules covering schema design, query optimization, and data ingestion—prioritized by impact.

Location: skills/clickhouse-best-practices/

For humans: Read SKILL.md for an overview, or AGENTS.md for the complete compiled guide.

For agents: The skill activates automatically when you work with ClickHouse—creating tables, writing queries, or designing data pipelines.

ClickHouse Architecture Advisor

5 decision frameworks covering workload-aware architecture decisions for real-time ClickHouse deployments.