CtrlK
BlogDocsLog inGet started
Tessl Logo

debug-clickhouse-queries

Investigate query evaluation failures in the Knowledge Graph synthetic data pipeline. Use when queries fail or return unexpected results after running the evaluate binary.

85

1.10x
Quality

82%

Does it follow best practices?

Impact

84%

1.10x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-organized, highly actionable debugging playbook with executable commands, a diagnostic checklist, and feedback loops. It is concise and assumes competence, with only minor trimming and validation-checkpoint gaps.

DimensionReasoningScore

Conciseness

Assumes Claude's knowledge of the codebase and avoids generic-concept padding, explaining only domain-specific semantics (traversal-path trie, edge-direction conventions); a few sections like the association-direction math could be trimmed slightly.

4 / 5

Actionability

Provides fully executable clickhouse and cargo commands plus concrete SQL with real table/column names and real file paths, covering the common debugging cases with intentional templated placeholders.

5 / 5

Workflow Clarity

A clear diagnostic flow, a 7-step debugging checklist, and feedback loops (predicate removal to narrow causes) are present, but it is a decision-tree workflow rather than a strict validate-gate pipeline and the regenerate sequence lacks an explicit checkpoint.

4 / 5

Progressive Disclosure

No bundle files exist so all content is inline, but it is well-organized into clear sections with logical one-level structure and only minor opportunities to split reference material into separate files.

4 / 5

Total

17

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is strong: it explicitly states both the skill's purpose and a concrete trigger condition in third person, and occupies a distinct, low-conflict niche. The only weakness is that it names a single action rather than enumerating several specific capabilities.

DimensionReasoningScore

Specificity

Names a specific domain and one concrete action ("Investigate query evaluation failures") but does not list multiple specific actions, matching the 1-2 concrete actions anchor.

3 / 5

Completeness

Explicitly answers both what (investigate query evaluation failures in the KG synthetic data pipeline) and when ("Use when queries fail or return unexpected results after running the evaluate binary") with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural trigger phrases a user would say ("queries fail", "unexpected results", "after running the evaluate binary") with good coverage, though a few synonyms are missing.

4 / 5

Distinctiveness Conflict Risk

Targets a highly specific internal niche (Knowledge Graph synthetic data pipeline, evaluate binary) with distinct triggers and minimal overlap with other skills.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
gitlabhq/orbit-knowledge-graph
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.