clickhouse-js-node-coding
Application development guide for the Node.js ClickHouse client.
Developer Setup
Setup & Installation
npx skills add https://github.com/ClickHouse/agent-skills --skill clickhouse-js-node-codingnpx skills add https://github.com/ClickHouse/agent-skills --skill clickhouse-js-node-codingOverview
What This Skill Does
Provides helper guides, configuration parameters, and query execution scripts for the ClickHouse Node.js client (@clickhouse/client).
Application
When to use this Skill
- Writing application code using the official ClickHouse Node.js client.
- Inserting data rows into ClickHouse in JSON or raw formats.
- Querying and parsing result sets using streaming interfaces.
- Managing query parameters and connection endpoints programmatically.
- Configuring temporary table bindings in Node.js applications.
Documentation
Show Skills.md file
ClickHouse Node.js Client — Coding
Reference: https://clickhouse.com/docs/integrations/javascript
⚠️ Node.js runtime only. This skill covers the
@clickhouse/clientpackage running in a Node.js runtime exclusively — including Next.js Node runtime API routes, React Server Components, Server Actions, and standard Node.js processes. Do not apply this skill to browser client components, Web Workers, Next.js Edge runtime, Cloudflare Workers, or any usage of@clickhouse/client-web. For browser/edge environments, the correct package is@clickhouse/client-web.
How to Use This Skill
- Match the user's intent to a row in the Task Index below and read the corresponding reference file before writing code. After reading it, scan any Answer checklist in that reference and make sure the final answer covers each relevant item; those checklists capture details users usually need but are easy to omit in short answers.
- Always import from
@clickhouse/client(never@clickhouse/client-web) and create a client withcreateClient({ url })or rely on supported defaults when appropriate. Close it withawait client.close()preferably when it's no longer needed or during graceful shutdown for global resources.
Recommendations
Explore other random skills
land-and-deploy
Merge the PR, wait for CI and deploy, verify production health
canary
SRE post-deploy monitoring: watches for console errors, performance regressions, and page failures
benchmark
Performance Engineer: baseline page load times, Core Web Vitals, and resource sizes