{"id":44715942,"url":"https://github.com/ClickHouse/agent-skills","last_synced_at":"2026-03-03T09:00:39.164Z","repository":{"id":336433393,"uuid":"1135104451","full_name":"ClickHouse/agent-skills","owner":"ClickHouse","description":"The official Agent Skills for ClickHouse and ClickHouse Cloud","archived":false,"fork":false,"pushed_at":"2026-02-26T09:11:41.000Z","size":74,"stargazers_count":323,"open_issues_count":1,"forks_count":10,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-26T14:53:44.076Z","etag":null,"topics":["agents","clickhouse"],"latest_commit_sha":null,"homepage":"https://clickhouse.ai","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ClickHouse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-15T16:36:20.000Z","updated_at":"2026-02-26T11:38:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ClickHouse/agent-skills","commit_stats":null,"previous_names":["clickhouse/agent-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ClickHouse/agent-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickHouse%2Fagent-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickHouse%2Fagent-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickHouse%2Fagent-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickHouse%2Fagent-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ClickHouse","download_url":"https://codeload.github.com/ClickHouse/agent-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ClickHouse%2Fagent-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30038546,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-03T06:58:30.252Z","status":"ssl_error","status_checked_at":"2026-03-03T06:58:15.329Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","clickhouse"],"created_at":"2026-02-15T14:00:29.945Z","updated_at":"2026-03-03T09:00:39.155Z","avatar_url":"https://github.com/ClickHouse.png","language":"JavaScript","readme":"# ClickHouse Agent Skills\n\nThe official Agent Skills for [ClickHouse](https://clickhouse.com/). These skills help LLMs and agents to adopt best practices when working with ClickHouse.\n\nYou can use these skills with open-source ClickHouse and managed ClickHouse Cloud. [Try ClickHouse Cloud with $300 in free credits](https://clickhouse.com/cloud?utm_medium=github\u0026utm_source=github\u0026utm_ref=agent-skills).\n\n## Installation\n\n```bash\nnpx skills add clickhouse/agent-skills\n```\n\nThe CLI auto-detects installed agents and prompts you to select where to install.\n\n## What is this?\n\nAgent Skills are packaged instructions that extend AI coding agents (Claude Code, Cursor, Copilot, etc.) with domain-specific expertise. This repository provides skills for ClickHouse databases—covering schema design, query optimization, and data ingestion patterns.\n\nWhen an agent loads these skills, it gains knowledge of ClickHouse best practices and can apply them while helping you design tables, write queries, or troubleshoot performance issues.\n\nSkills follow the open specification at [agentskills.io](https://agentskills.io).\n\n## Available Skills\n\n### ClickHouse Best Practices\n\n**28 rules** covering schema design, query optimization, and data ingestion—prioritized by impact.\n\n| Category | Rules | Impact |\n|----------|-------|--------|\n| Primary Key Selection | 4 | CRITICAL |\n| Data Type Selection | 5 | CRITICAL |\n| JOIN Optimization | 5 | CRITICAL |\n| Insert Batching | 1 | CRITICAL |\n| Mutation Avoidance | 2 | CRITICAL |\n| Partitioning Strategy | 4 | HIGH |\n| Skipping Indices | 1 | HIGH |\n| Materialized Views | 2 | HIGH |\n| Async Inserts | 2 | HIGH |\n| OPTIMIZE Avoidance | 1 | HIGH |\n| JSON Usage | 1 | MEDIUM |\n\n**Location:** [`skills/clickhouse-best-practices/`](./skills/clickhouse-best-practices/)\n\n**For humans:** Read [SKILL.md](./skills/clickhouse-best-practices/SKILL.md) for an overview, or [AGENTS.md](./skills/clickhouse-best-practices/AGENTS.md) for the complete compiled guide.\n\n**For agents:** The skill activates automatically when you work with ClickHouse—creating tables, writing queries, or designing data pipelines.\n\n## Quick Start\n\nAfter installation, your AI agent will reference these best practices when:\n\n- Creating new tables with `CREATE TABLE`\n- Choosing `ORDER BY` / `PRIMARY KEY` columns\n- Selecting data types for columns\n- Optimizing slow queries\n- Writing or tuning JOINs\n- Designing data ingestion pipelines\n- Handling updates or deletes\n\nExample prompt:\n\u003e \"Create a table for storing user events with fields for user_id, event_type, properties (JSON), and timestamp\"\n\nThe agent will apply relevant rules like proper column ordering in the primary key, appropriate data types, and partitioning strategy.\n\n## Supported Agents\n\nSkills are **agent-agnostic**—the same skill works across all supported AI coding assistants:\n\n| Agent | Config Directory |\n|-------|------------------|\n| [Claude Code](https://claude.ai/code) | `.claude/skills/` |\n| [Cursor](https://cursor.sh) | `.cursor/skills/` |\n| [Windsurf](https://codeium.com/windsurf) | `.windsurf/skills/` |\n| [GitHub Copilot](https://github.com/features/copilot) | `.github/skills/` |\n| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `.gemini/skills/` |\n| [Cline](https://github.com/cline/cline) | `.cline/skills/` |\n| [Codex](https://openai.com/codex) | `.codex/skills/` |\n| [Goose](https://github.com/block/goose) | `.goose/skills/` |\n| [Roo Code](https://roo.ai) | `.roo/skills/` |\n| [OpenHands](https://github.com/All-Hands-AI/OpenHands) | `.openhands/skills/` |\n\nAnd 13 more including Amp, Kiro CLI, Trae, Zencoder, and others.\n\nThe installer detects which agents you have by checking for their configuration directories. If an agent isn't listed, either install it first or create its config directory manually (e.g., `mkdir -p ~/.cursor`).\n\n## License\n\nApache 2.0 — see [LICENSE](./LICENSE) for details.\n","funding_links":[],"categories":["精选技能","Table of Contents"],"sub_categories":["技术开发","Skill by ClickHouse"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FClickHouse%2Fagent-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FClickHouse%2Fagent-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FClickHouse%2Fagent-skills/lists"}