Skills
.Work. You
Rest

debug-clickhouse-queries

Official

Debug ClickHouse query failures.

Software Engineering#knowledge graph#data pipeline#sql#synthetic data#clickhouse#query debugging
Authorgitlabhq
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps diagnose and resolve issues when ClickHouse queries fail or produce unexpected results within the Knowledge Graph synthetic data pipeline.

Core Features & Use Cases

  • Inspect Generated SQL: View the SQL produced by the query engine for debugging.
  • Analyze Data: Directly query ClickHouse to examine table schemas, data values, and edge types.
  • Distinguish Bug Types: Differentiate between data generation, sampling, and query engine bugs.
  • Hypothesis Testing: Systematically test and isolate the cause of query failures by removing predicates.
  • Use Case: When a synthetic data pipeline reports empty results for a specific query, use this Skill to inspect the generated SQL, check the actual data in ClickHouse, and pinpoint whether the issue lies in data generation, sampling logic, or the query itself.

Quick Start

Use the debug-clickhouse-queries skill to investigate why a query is returning empty results by inspecting the generated SQL and checking the data directly in ClickHouse.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: debug-clickhouse-queries
Download link: https://github.com/gitlabhq/orbit-knowledge-graph/archive/main.zip#debug-clickhouse-queries

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.