ClickHouse Agent Skills — Install & Live Demo

Name: ClickHouse Agent Skills (Claude Skill)
Author: ClickHouse

Why use it

Key features

Official ClickHouse skills - schema design, MergeTree tuning, and SQL performance for analytics.
Maintained by ClickHouse (official)
Written in JavaScript
442+ GitHub stars at last check
Open source on GitHub

Live Demo

What it looks like in practice

clickhouse-agent-skills.replay ▶ ready

0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "clickhouse-agent-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ClickHouse/agent-skills",
        "~/.claude/skills/clickhouse-agent-skills"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "clickhouse-agent-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ClickHouse/agent-skills",
        "~/.claude/skills/clickhouse-agent-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "clickhouse-agent-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ClickHouse/agent-skills",
        "~/.claude/skills/clickhouse-agent-skills"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "clickhouse-agent-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ClickHouse/agent-skills",
        "~/.claude/skills/clickhouse-agent-skills"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "clickhouse-agent-skills",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/ClickHouse/agent-skills",
        "~/.claude/skills/clickhouse-agent-skills"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json

{
  "context_servers": {
    "clickhouse-agent-skills": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/ClickHouse/agent-skills",
          "~/.claude/skills/clickhouse-agent-skills"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add clickhouse-agent-skills -- git clone https://github.com/ClickHouse/agent-skills ~/.claude/skills/clickhouse-agent-skills

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use ClickHouse Agent Skills

Use ClickHouse Agent Skills for its primary workflow

👤 Developers using AI coding agents ⏱ ~10 min beginner

When to use: You need the capability: Official ClickHouse skills - schema design, MergeTree tuning, and SQL performance for analytics.

Prerequisites

Skill installed — git clone https://github.com/ClickHouse/agent-skills ~/.claude/skills/clickhouse-agent-skills

Flow

Install

Install ClickHouse Agent Skills following the README at https://github.com/ClickHouse/agent-skills✓ Copied

→ Skill appears in your client's available tools/skills
Invoke

Use ClickHouse Agent Skills to complete the task described in its docs.✓ Copied

→ Agent calls the relevant tool/skill and returns a result

Outcome: Working integration with the capabilities advertised by the project.

Pitfalls

README is the source of truth; details here may lag upstream — Check https://github.com/ClickHouse/agent-skills for the latest setup steps and tool list

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills