Add JS client Node.js troubleshooting skill

[peter-leonov-ch]

Source:

• https://github.com/ClickHouse/clickhouse-js/tree/main/skills/clickhouse-js-node-troubleshooting

[pjhampton]

I love this - but I'd like to know why this cannot be a more general skill? This could then apply to more language clients such as java, rust, go, etc? We could then write a judge harness for all clients. Curious your thoughts on this too @mshustov

I think I envision something like this. where all have similar rules, and more specific ones like you have here.

skills
  clickhouse-client-js
    - rule1
    - rule2 
  clickhouse-client-rust
    - rule1
    - rule2 
  clickhouse-client-go
    - rule1
    - rule2 
   ...etc

[peter-leonov-ch]

This is something to think about, thanks! The reason in short is simple: task focussed skills allow for more tokens in the index file.

[mshustov]

@pjhampton How would you suggest us to layout the skills?

skills
  usage
  troubleshooting
  clickhouse-client-js
    - usage
        - rule-1
        - rule-2
    - troubleshooting
        - rule-1
        - rule-2
        - ...

[Copilot]

Pull request overview

Adds a new “ClickHouse Node.js client troubleshooting” skill, providing ready-to-use guidance for diagnosing common @clickhouse/client issues (TLS, keep-alive/ECONNRESET, query params, compression, logging, etc.).

Changes:

• Introduces clickhouse-js-node-troubleshooting skill entrypoint with an issue index.
• Adds multiple reference pages covering common Node.js client failure modes and configuration pitfalls.
• Provides copy/paste examples and version-gated tips for @clickhouse/client.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
skills/clickhouse-js-node-troubleshooting/SKILL.md	Skill definition and issue index routing users to reference docs.
skills/clickhouse-js-node-troubleshooting/reference/tls.md	TLS/mTLS setup and common Node certificate errors.
skills/clickhouse-js-node-troubleshooting/reference/socket-hangup.md	ECONNRESET triage focused on dangling streams and keep-alive tuning.
skills/clickhouse-js-node-troubleshooting/reference/readonly-users.md	Explains readonly user limitation with response compression + fix.
skills/clickhouse-js-node-troubleshooting/reference/query-params.md	Parameter binding syntax guidance + SQL-injection warning.
skills/clickhouse-js-node-troubleshooting/reference/proxy-pathname.md	Correct pathname usage for reverse proxies / path prefixes.
skills/clickhouse-js-node-troubleshooting/reference/logging.md	Enabling logging and implementing a custom logger.
skills/clickhouse-js-node-troubleshooting/reference/data-types.md	Common JSON format type pitfalls + format selection table.
skills/clickhouse-js-node-troubleshooting/reference/compression.md	Request/response compression behavior, defaults, and pitfalls.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ peter-leonov-ch
❌ Copilot
_{You have signed the CLA already but the status is still pending? Let us recheck it.}