Agent skill

Clickhouse JS Node Troubleshooting

by vemetric in vemetric/vemetric

Troubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse/client).

AGPL-3.0Auto-check passedDatabases

Install Clickhouse JS Node Troubleshooting

skills CLI
$ npx skills add vemetric/vemetric --skill clickhouse-js-node-troubleshooting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vemetric/vemetric clickhouse-js-node-troubleshooting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vemetric/vemetric.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/clickhouse-js-node-troubleshooting .claude/skills/clickhouse-js-node-troubleshooting && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clickhouse-js-node-troubleshooting
GitHub stars
394
Used in
1 other repo
Token cost
~1.3k tokens
SKILL.md length
319 words
Files
10
Skills in repo
6
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Troubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse/client).

  • Works in 4 steps: Identify the issue — match symptoms to… → Lead with the diagnosis — explain what's… → Note version constraints — flag if a fix… → …
  • A user reports errors
  • SKILL.md covers How to Use This Skill, Issue Index and Still Stuck?
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Clickhouse JS Node Troubleshooting is an agent skill from vemetric/vemetric. Troubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse/client). Use this skill whenever a user reports errors, unexpected behavior, or configuration questions involving the Node.js client specifically — including socket hang-up errors, Keep-Alive problems, stream handling issues, data type mismatches, read-only user restrictions, proxy/TLS setup problems, or long-running query timeouts. Trigger even when the user hasn't precisely named the issue; vague symptoms like "my inserts…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files (for example `reference/compression.md`, `reference/data-types.md` and `reference/logging.md`).

It sits in Databases, covering Data warehousing. It works with ClickHouse and Node.js. The repository describes itself as: Simple, yet powerful Web- & Product Analytics. The licence is AGPL-3.0.

When your agent uses it

  • A user reports errors
  • Unexpected behavior
  • Configuration questions involving the Node.js client specifically — including socket hang-up errors
  • Keep-Alive problems

Example prompts

  • “t precisely named the issue; vague symptoms like”
  • “connection drops randomly”
  • “/clickhouse-js-node-troubleshooting”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Identify the issue — match symptoms to the Issue Index below and read the corresponding reference file.
  2. Lead with the diagnosis — explain what's likely causing the issue before giving the fix.
  3. Note version constraints — flag if a fix requires a minimum client version and check it against what the user provided.
  4. Ask only what's missing — if the fix is version-dependent and you don't know their version, ask; otherwise help immediately.

What it can do on your machine

Read from SKILL.md and the folder at commit 6b7b01a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • clickhouse.com
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clickhouse JS Node Troubleshooting loads about 1.3k tokens when it runs. Until then it costs about 174 tokens; SKILL.md has 319 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~174
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vemetric/vemetric at commit 6b7b01a, republished under its AGPL-3.0 licence (© vemetric). 319 words, ~1,281 tokens.

Download SKILL.mdSave it as .claude/skills/clickhouse-js-node-troubleshooting/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
clickhouse-js-node-troubleshooting
description
Troubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse/client). Use this skill whenever a user reports errors, unexpected behavior, or configuration questions involving the Node.js client specifically — including socket hang-up errors, Keep-Alive problems, stream handling issues, data type mismatches, read-only user restrictions, proxy/TLS setup problems, or long-running query timeouts. Trigger even when the user hasn't precisely named the issue; vague symptoms like "my inserts keep failing" or "connection drops randomly" in a Node.js context are strong signals to use this skill. Do NOT use for browser/Web client issues.

ClickHouse Node.js Client Troubleshooting

Reference: https://clickhouse.com/docs/integrations/javascript

⚠️ Node.js runtime only. This skill covers the @clickhouse/client package 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

  1. Identify the issue — match symptoms to the Issue Index below and read the corresponding reference file.
  2. Lead with the diagnosis — explain what's likely causing the issue before giving the fix.
  3. Note version constraints — flag if a fix requires a minimum client version and check it against what the user provided.
  4. Ask only what's missing — if the fix is version-dependent and you don't know their version, ask; otherwise help immediately.

Issue Index

Identify the user's issue from the list below and read the corresponding reference file for detailed troubleshooting steps.

IssueSymptomsReference file
Socket Hang-Up / ECONNRESETsocket hang up, ECONNRESET, intermittent connection drops, long-running queries timing outreference/socket-hangup.md
Data Type MismatchesLarge integers returned as strings, decimal precision loss, Date/DateTime insertion failures, CANNOT_PARSE_INPUT_ASSERTION_FAILED inserting a UUID into a UInt128 columnreference/data-types.md
Read-Only User ErrorsErrors when using response compression with readonly=1 usersreference/readonly-users.md
Proxy / Pathname URL ConfusionWrong database selected, requests failing behind a proxy with a path prefixreference/proxy-pathname.md
TLS / Certificate ErrorsTLS handshake failures, certificate verification issues, mutual TLS setupreference/tls.md
Compression Not WorkingGZIP compression not activating for requests or responsesreference/compression.md
Logging Not Showing AnythingNo log output, need custom logger integrationreference/logging.md
Query Parameters Not InterpolatedParameterized queries not working, SQL injection concernsreference/query-params.md
FORMAT Clause / SHOW POLICIES ErrorsSyntax error from a duplicate FORMAT, or SHOW [ROW] POLICIES failing even with a format providedreference/query-format-clause.md

Still Stuck?

© vemetric, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files in .agents/skills/clickhouse-js-node-troubleshooting of vemetric/vemetric.

  • SKILL.md
  • reference/compression.md
  • reference/data-types.md
  • reference/logging.md
  • reference/proxy-pathname.md
  • reference/query-format-clause.md
  • reference/query-params.md
  • reference/readonly-users.md
  • reference/socket-hangup.md
  • reference/tls.md

Open the folder on GitHubat commit 6b7b01a

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in vemetric/vemetric, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Clickhouse JS Node Troubleshooting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clickhouse JS Node Troubleshooting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clickhouse JS Node Troubleshooting this skillvemetric/vemetric3941 repos~1.3kAutomated safety check: PassAGPL-3.0
ClickHouse RowBinary for Node.jsClickHouse/agent-skills544—~1.3kAutomated safety check: PassApache-2.0
Adding Ingestion WarningsPostHog/posthog40k—~3.7kAutomated safety check: PassCustom licence
Clickhouse Install Authjeremylongshore/tons-of-skills-marketplace2.8k—~1.2kAutomated safety check: NotesMIT
Ar Io Gateway Operatorar-io/ar-io-node127—~8.2kAutomated safety check: NotesAGPL-3.0
Monitoring Ingestion PipelinePostHog/posthog40k—~9.1kAutomated safety check: PassCustom licence

Similar skills

  • ClickHouse RowBinary for Node.js

    ClickHouse/agent-skills

    Generates TypeScript or JavaScript readers and writers for ClickHouse's RowBinary formats over HTTP in Node.js, after checking that RowBinary suits the data.

    544 GitHub stars~1.3k tokensUpdated 9 days ago
    DatabasesAuto-check passed
  • Official

    How to add a new ingestion warning type to the event ingestion pipeline.

    40k GitHub stars~3.7k tokensUpdated today
    DatabasesAuto-check passed
  • Clickhouse Install Auth

    jeremylongshore/tons-of-skills-marketplace

    Install @clickhouse/client and configure authentication to ClickHouse Cloud or self-hosted.

    2.8k GitHub stars~1.2k tokensUpdated today
    DatabasesAuto-check: notes
  • Ar Io Gateway Operator

    ar-io/ar-io-node

    Operate any AR.IO node deployment — architecture, daily ops, diagnostics, and recurring pitfalls that apply to every operator.

    127 GitHub stars~8.2k tokensUpdated today
    Backend & APIsAuto-check: notes
  • Official

    Guide for using the Grafana MCP to monitor and diagnose the Node.js ingestion pipeline workers in production.

    40k GitHub stars~9.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Testing

    ar-io/ar-io-node

    Decision guide for testing in the ar-io-node repo — which test layer to use, how to run it, and which helpers to reach for.

    127 GitHub stars~2.6k tokensUpdated today
    Testing & QAAuto-check: notes

More from vemetric/vemetric

  • Chdb Datastore

    vemetric/vemetric

    A skill your agent uses when the user has tabular data (pandas DataFrame, parquet, csv, Arrow, json) and wants to filter, group, aggregate, join, or speed up slow pandas.

    394 GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • Chdb SQL

    vemetric/vemetric

    A skill your agent uses when the user wants to run SQL — especially analytical SQL — on local files (parquet/csv/json), URLs, S3 paths, or remote databases (Postgres, MySQL, MongoDB, ClickHouse…

    394 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • MUST USE when designing ClickHouse architectures, selecting between ingestion or modeling patterns, or translating best practices into workload-specific system designs.

    394 GitHub starsUsed in 2 repos~791 tokens
    Auto-check passed
  • Clickhouse Best Practices

    vemetric/vemetric

    MUST USE when reviewing ClickHouse schemas, queries, or configurations.

    394 GitHub starsUsed in 2 repos~2.6k tokens
    Auto-check passed
  • Clickhouse JS Node Coding

    vemetric/vemetric

    Write idiomatic application code with the ClickHouse Node.js client (@clickhouse/client).

    394 GitHub starsUsed in 1 repo~2.8k tokens
    Auto-check passed

Categories

Questions about Clickhouse JS Node Troubleshooting

What does Clickhouse JS Node Troubleshooting do?

Troubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse/client). Clickhouse JS Node Troubleshooting is an agent skill from vemetric/vemetric.js client (@clickhouse/client).

When should I use Clickhouse JS Node Troubleshooting?

Clickhouse JS Node Troubleshooting fits situations like: A user reports errors; unexpected behavior; configuration questions involving the Node.js client specifically — including socket hang-up errors; keep-Alive problems.

How do I install Clickhouse JS Node Troubleshooting in Claude Code?

Run `npx skills add vemetric/vemetric --skill clickhouse-js-node-troubleshooting -a claude-code`. Or copy the skill folder (.agents/skills/clickhouse-js-node-troubleshooting in vemetric/vemetric) into .claude/skills/clickhouse-js-node-troubleshooting in your project. Claude Code loads it when a task matches its description.

How do I install Clickhouse JS Node Troubleshooting in Codex?

Run `npx skills add vemetric/vemetric --skill clickhouse-js-node-troubleshooting -a codex`. Or copy the skill folder (.agents/skills/clickhouse-js-node-troubleshooting in vemetric/vemetric) into .agents/skills/clickhouse-js-node-troubleshooting in your project. Codex loads it when a task matches its description.

Can I use Clickhouse JS Node Troubleshooting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vemetric/vemetric --skill clickhouse-js-node-troubleshooting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clickhouse-js-node-troubleshooting, .gemini/skills/clickhouse-js-node-troubleshooting, .github/skills/clickhouse-js-node-troubleshooting and .opencode/skills/clickhouse-js-node-troubleshooting in your project.

What does Clickhouse JS Node Troubleshooting need to run?

SKILL.md names no scripts, command-line tools or credentials: Clickhouse JS Node Troubleshooting is instructions for the agent only. Our summary lists: Node.js.

Does Clickhouse JS Node Troubleshooting access the network?

SKILL.md names 2 domains. As links in the text: clickhouse.com and github.com. This is read from the text; nothing was executed.

Is Clickhouse JS Node Troubleshooting safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clickhouse JS Node Troubleshooting use?

Clickhouse JS Node Troubleshooting is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clickhouse JS Node Troubleshooting use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Clickhouse JS Node Troubleshooting?

Skills that share tags, products or a category with Clickhouse JS Node Troubleshooting: ClickHouse RowBinary for Node.js (ClickHouse/agent-skills, 544 stars), Adding Ingestion Warnings (PostHog/posthog, 40k stars), Clickhouse Install Auth (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Ar Io Gateway Operator (ar-io/ar-io-node, 127 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clickhouse JS Node Troubleshooting?

vemetric (a GitHub organization) maintains it in vemetric/vemetric, which has 394 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 7, 2026.

Source: vemetric/vemetric on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.