[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-clickhouse-clickhouse-best-practices":3,"mdc--29yjpy-key":38,"related-org-clickhouse-clickhouse-best-practices":1976,"related-repo-clickhouse-clickhouse-best-practices":2171},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":26,"repoUrl":27,"updatedAt":28,"license":29,"forks":30,"topics":31,"repo":33,"sourceUrl":36,"mdContent":37},"clickhouse-best-practices","review ClickHouse schemas and queries","MUST USE when reviewing ClickHouse schemas, queries, or configurations. Contains 31 rules that MUST be checked before providing recommendations. Always read relevant rule files and cite specific rules in responses.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},"clickhouse","ClickHouse","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fclickhouse.png",[12,14,17,20,23],{"name":9,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"Performance","performance",{"name":18,"slug":19,"type":13},"Code Review","code-review",{"name":21,"slug":22,"type":13},"Database","database",{"name":24,"slug":25,"type":13},"SQL","sql",493,"https:\u002F\u002Fgithub.com\u002FClickHouse\u002Fagent-skills","2026-04-06T18:07:18.953931","Apache-2.0",32,[32,8],"agents",{"repoUrl":27,"stars":26,"forks":30,"topics":34,"description":35},[32,8],"The official Agent Skills for ClickHouse and ClickHouse Cloud","https:\u002F\u002Fgithub.com\u002FClickHouse\u002Fagent-skills\u002Ftree\u002FHEAD\u002Fskills\u002Fclickhouse-best-practices","---\nname: clickhouse-best-practices\ndescription: MUST USE when reviewing ClickHouse schemas, queries, or configurations. Contains 31 rules that MUST be checked before providing recommendations. Always read relevant rule files and cite specific rules in responses.\nlicense: Apache-2.0\nmetadata:\n  author: ClickHouse Inc\n  version: \"0.4.0\"\n---\n\n# ClickHouse Best Practices\n\nComprehensive guidance for ClickHouse covering schema design, query optimization, data ingestion, and AI agent connectivity. Contains 31 rules across 4 main categories (schema, query, insert, agent), prioritized by impact.\n\n> **Official docs:** [ClickHouse Best Practices](https:\u002F\u002Fclickhouse.com\u002Fdocs\u002Fbest-practices)\n\n## IMPORTANT: How to Apply This Skill\n\n**Before answering ClickHouse questions, follow this priority order:**\n\n1. **Check for applicable rules** in the `rules\u002F` directory\n2. **If rules exist:** Apply them and cite them in your response using \"Per `rule-name`...\"\n3. **If no rule exists:** Use the LLM's ClickHouse knowledge or search documentation\n4. **If uncertain:** Use web search for current best practices\n5. **Always cite your source:** rule name, \"general ClickHouse guidance\", or URL\n\n**Why rules take priority:** ClickHouse has specific behaviors (columnar storage, sparse indexes, merge tree mechanics) where general database intuition can be misleading. The rules encode validated, ClickHouse-specific guidance.\n\n---\n\n## Agent Connectivity & Query Workflow\n\nBefore querying ClickHouse, agents must establish a connection and follow the discovery workflow:\n\n1. `rules\u002Fagent-connect-mcp.md` - Connection setup (MCP + CLI), credential discovery, output format selection\n2. `rules\u002Fagent-discovery-schema.md` - **CRITICAL**: 7-step schema discovery workflow\n3. `rules\u002Fagent-query-safety.md` - **CRITICAL**: LIMIT, timeouts, progressive exploration\n\n**Every agent session should follow this sequence:**\n\n1. **Connect** — establish connection via MCP or CLI (see `agent-connect-mcp`)\n2. **Discover** — databases → tables → columns + comments → sort keys → skip indexes → sample → EXPLAIN\n3. **Plan** — use sort key and skip index knowledge to write efficient WHERE clauses\n4. **Execute** — run queries with LIMIT and timeouts\n5. **Recover** — on timeout\u002Fmemory errors, narrow filters and retry (see `agent-query-safety`)\n\n### Subagent architecture notes\n\nIf your system dispatches ClickHouse tasks to specialized subagents:\n- **Schema discovery + query execution**: any model — the steps are procedural\n- **EXPLAIN analysis + query optimization**: benefits from mid-tier reasoning\n- **Schema design review against all 28 rules**: benefits from mid-tier reasoning\n\n---\n\n## Review Procedures\n\n### For Schema Reviews (CREATE TABLE, ALTER TABLE)\n\n**Read these rule files in order:**\n\n1. `rules\u002Fschema-pk-plan-before-creation.md` - ORDER BY is immutable\n2. `rules\u002Fschema-pk-cardinality-order.md` - Column ordering in keys\n3. `rules\u002Fschema-pk-prioritize-filters.md` - Filter column inclusion\n4. `rules\u002Fschema-types-native-types.md` - Proper type selection\n5. `rules\u002Fschema-types-minimize-bitwidth.md` - Numeric type sizing\n6. `rules\u002Fschema-types-lowcardinality.md` - LowCardinality usage\n7. `rules\u002Fschema-types-avoid-nullable.md` - Nullable vs DEFAULT\n8. `rules\u002Fschema-partition-low-cardinality.md` - Partition count limits\n9. `rules\u002Fschema-partition-lifecycle.md` - Partitioning purpose\n\n**Check for:**\n- [ ] PRIMARY KEY \u002F ORDER BY column order (low-to-high cardinality)\n- [ ] Data types match actual data ranges\n- [ ] LowCardinality applied to appropriate string columns\n- [ ] Partition key cardinality bounded (100-1,000 values)\n- [ ] ReplacingMergeTree has version column if used\n\n### For Query Reviews (SELECT, JOIN, aggregations)\n\n**Read these rule files:**\n\n1. `rules\u002Fquery-join-choose-algorithm.md` - Algorithm selection\n2. `rules\u002Fquery-join-filter-before.md` - Pre-join filtering\n3. `rules\u002Fquery-join-use-any.md` - ANY vs regular JOIN\n4. `rules\u002Fquery-index-skipping-indices.md` - Secondary index usage\n5. `rules\u002Fschema-pk-filter-on-orderby.md` - Filter alignment with ORDER BY\n\n**Check for:**\n- [ ] Filters use ORDER BY prefix columns\n- [ ] JOINs filter tables before joining (not after)\n- [ ] Correct JOIN algorithm for table sizes\n- [ ] Skipping indices for non-ORDER BY filter columns\n\n### For Insert Strategy Reviews (data ingestion, updates, deletes)\n\n**Read these rule files:**\n\n1. `rules\u002Finsert-batch-size.md` - Batch sizing requirements\n2. `rules\u002Finsert-mutation-avoid-update.md` - UPDATE alternatives\n3. `rules\u002Finsert-mutation-avoid-delete.md` - DELETE alternatives\n4. `rules\u002Finsert-async-small-batches.md` - Async insert usage\n5. `rules\u002Finsert-optimize-avoid-final.md` - OPTIMIZE TABLE risks\n\n**Check for:**\n- [ ] Batch size 10K-100K rows per INSERT\n- [ ] No ALTER TABLE UPDATE for frequent changes\n- [ ] ReplacingMergeTree or CollapsingMergeTree for update patterns\n- [ ] Async inserts enabled for high-frequency small batches\n\n---\n\n## Output Format\n\nStructure your response as follows:\n\n```\n## Rules Checked\n- `rule-name-1` - Compliant \u002F Violation found\n- `rule-name-2` - Compliant \u002F Violation found\n...\n\n## Findings\n\n### Violations\n- **`rule-name`**: Description of the issue\n  - Current: [what the code does]\n  - Required: [what it should do]\n  - Fix: [specific correction]\n\n### Compliant\n- `rule-name`: Brief note on why it's correct\n\n## Recommendations\n[Prioritized list of changes, citing rules]\n```\n\n---\n\n## Rule Categories by Priority\n\n| Priority | Category | Impact | Prefix | Rule Count |\n|----------|----------|--------|--------|------------|\n| 1 | Primary Key Selection | CRITICAL | `schema-pk-` | 4 |\n| 2 | Data Type Selection | CRITICAL | `schema-types-` | 5 |\n| 3 | JOIN Optimization | CRITICAL | `query-join-` | 5 |\n| 4 | Insert Batching | CRITICAL | `insert-batch-` | 1 |\n| 5 | Mutation Avoidance | CRITICAL | `insert-mutation-` | 2 |\n| 6 | Partitioning Strategy | HIGH | `schema-partition-` | 4 |\n| 7 | Skipping Indices | HIGH | `query-index-` | 1 |\n| 8 | Materialized Views | HIGH | `query-mv-` | 2 |\n| 9 | Async Inserts | HIGH | `insert-async-` | 2 |\n| 10 | OPTIMIZE Avoidance | HIGH | `insert-optimize-` | 1 |\n| 11 | JSON Usage | MEDIUM | `schema-json-` | 1 |\n| 12 | Agent Schema Discovery | CRITICAL | `agent-discovery-` | 1 |\n| 13 | Agent Query Safety | CRITICAL | `agent-query-` | 1 |\n| 14 | Agent Connectivity + Formats | HIGH | `agent-connect-` | 1 |\n\n---\n\n## Quick Reference\n\n### Schema Design - Primary Key (CRITICAL)\n\n- `schema-pk-plan-before-creation` - Plan ORDER BY before table creation (immutable)\n- `schema-pk-cardinality-order` - Order columns low-to-high cardinality\n- `schema-pk-prioritize-filters` - Include frequently filtered columns\n- `schema-pk-filter-on-orderby` - Query filters must use ORDER BY prefix\n\n### Schema Design - Data Types (CRITICAL)\n\n- `schema-types-native-types` - Use native types, not String for everything\n- `schema-types-minimize-bitwidth` - Use smallest numeric type that fits\n- `schema-types-lowcardinality` - LowCardinality for \u003C10K unique strings\n- `schema-types-enum` - Enum for finite value sets with validation\n- `schema-types-avoid-nullable` - Avoid Nullable; use DEFAULT instead\n\n### Schema Design - Partitioning (HIGH)\n\n- `schema-partition-low-cardinality` - Keep partition count 100-1,000\n- `schema-partition-lifecycle` - Use partitioning for data lifecycle, not queries\n- `schema-partition-query-tradeoffs` - Understand partition pruning trade-offs\n- `schema-partition-start-without` - Consider starting without partitioning\n\n### Schema Design - JSON (MEDIUM)\n\n- `schema-json-when-to-use` - JSON for dynamic schemas; typed columns for known\n\n### Query Optimization - JOINs (CRITICAL)\n\n- `query-join-choose-algorithm` - Select algorithm based on table sizes\n- `query-join-use-any` - ANY JOIN when only one match needed\n- `query-join-filter-before` - Filter tables before joining\n- `query-join-consider-alternatives` - Dictionaries\u002Fdenormalization vs JOIN\n- `query-join-null-handling` - join_use_nulls=0 for default values\n\n### Query Optimization - Indices (HIGH)\n\n- `query-index-skipping-indices` - Skipping indices for non-ORDER BY filters\n\n### Query Optimization - Materialized Views (HIGH)\n\n- `query-mv-incremental` - Incremental MVs for real-time aggregations\n- `query-mv-refreshable` - Refreshable MVs for complex joins\n\n### Insert Strategy - Batching (CRITICAL)\n\n- `insert-batch-size` - Batch 10K-100K rows per INSERT\n\n### Insert Strategy - Async (HIGH)\n\n- `insert-async-small-batches` - Async inserts for high-frequency small batches\n- `insert-format-native` - Native format for best performance\n\n### Insert Strategy - Mutations (CRITICAL)\n\n- `insert-mutation-avoid-update` - ReplacingMergeTree instead of ALTER UPDATE\n- `insert-mutation-avoid-delete` - Lightweight DELETE or DROP PARTITION\n\n### Insert Strategy - Optimization (HIGH)\n\n- `insert-optimize-avoid-final` - Let background merges work\n\n### Agent Integration - Discovery (CRITICAL)\n\n- `agent-discovery-schema` - Always discover schema before querying\n\n### Agent Integration - Safety (CRITICAL)\n\n- `agent-query-safety` - LIMIT, timeouts, progressive exploration\n\n### Agent Integration - Connectivity + Formats (HIGH)\n\n- `agent-connect-mcp` - MCP + CLI setup, credential discovery, output format selection\n\n---\n\n## When to Apply\n\nThis skill activates when you encounter:\n\n- AI agent connecting to ClickHouse (MCP, CLI, HTTP)\n- Agent workflow design for ClickHouse\n- Schema discovery or exploration requests\n\n- `CREATE TABLE` statements\n- `ALTER TABLE` modifications\n- `ORDER BY` or `PRIMARY KEY` discussions\n- Data type selection questions\n- Slow query troubleshooting\n- JOIN optimization requests\n- Data ingestion pipeline design\n- Update\u002Fdelete strategy questions\n- ReplacingMergeTree or other specialized engine usage\n- Partitioning strategy decisions\n\n---\n\n## Rule File Structure\n\nEach rule file in `rules\u002F` contains:\n\n- **YAML frontmatter**: title, impact level, tags\n- **Brief explanation**: Why this rule matters\n- **Incorrect example**: Anti-pattern with explanation\n- **Correct example**: Best practice with explanation\n- **Additional context**: Trade-offs, when to apply, references\n\n---\n\n## Full Compiled Document\n\nFor the complete guide with all rules expanded inline: `AGENTS.md`\n\nUse `AGENTS.md` when you need to check multiple rules quickly without reading individual files.\n",{"data":39,"body":43},{"name":4,"description":6,"license":29,"metadata":40},{"author":41,"version":42},"ClickHouse Inc","0.4.0",{"type":44,"children":45},"root",[46,54,60,83,90,98,170,180,184,190,195,243,251,319,326,331,364,367,373,379,387,489,497,551,557,565,623,630,670,676,683,741,748,788,791,797,802,814,817,823,1288,1291,1297,1303,1350,1356,1414,1420,1467,1473,1487,1493,1551,1557,1571,1577,1602,1608,1622,1628,1653,1659,1684,1690,1704,1710,1724,1730,1743,1749,1762,1765,1771,1776,1870,1873,1879,1891,1944,1947,1953,1964],{"type":47,"tag":48,"props":49,"children":50},"element","h1",{"id":4},[51],{"type":52,"value":53},"text","ClickHouse Best Practices",{"type":47,"tag":55,"props":56,"children":57},"p",{},[58],{"type":52,"value":59},"Comprehensive guidance for ClickHouse covering schema design, query optimization, data ingestion, and AI agent connectivity. Contains 31 rules across 4 main categories (schema, query, insert, agent), prioritized by impact.",{"type":47,"tag":61,"props":62,"children":63},"blockquote",{},[64],{"type":47,"tag":55,"props":65,"children":66},{},[67,73,75],{"type":47,"tag":68,"props":69,"children":70},"strong",{},[71],{"type":52,"value":72},"Official docs:",{"type":52,"value":74}," ",{"type":47,"tag":76,"props":77,"children":81},"a",{"href":78,"rel":79},"https:\u002F\u002Fclickhouse.com\u002Fdocs\u002Fbest-practices",[80],"nofollow",[82],{"type":52,"value":53},{"type":47,"tag":84,"props":85,"children":87},"h2",{"id":86},"important-how-to-apply-this-skill",[88],{"type":52,"value":89},"IMPORTANT: How to Apply This Skill",{"type":47,"tag":55,"props":91,"children":92},{},[93],{"type":47,"tag":68,"props":94,"children":95},{},[96],{"type":52,"value":97},"Before answering ClickHouse questions, follow this priority order:",{"type":47,"tag":99,"props":100,"children":101},"ol",{},[102,122,140,150,160],{"type":47,"tag":103,"props":104,"children":105},"li",{},[106,111,113,120],{"type":47,"tag":68,"props":107,"children":108},{},[109],{"type":52,"value":110},"Check for applicable rules",{"type":52,"value":112}," in the ",{"type":47,"tag":114,"props":115,"children":117},"code",{"className":116},[],[118],{"type":52,"value":119},"rules\u002F",{"type":52,"value":121}," directory",{"type":47,"tag":103,"props":123,"children":124},{},[125,130,132,138],{"type":47,"tag":68,"props":126,"children":127},{},[128],{"type":52,"value":129},"If rules exist:",{"type":52,"value":131}," Apply them and cite them in your response using \"Per ",{"type":47,"tag":114,"props":133,"children":135},{"className":134},[],[136],{"type":52,"value":137},"rule-name",{"type":52,"value":139},"...\"",{"type":47,"tag":103,"props":141,"children":142},{},[143,148],{"type":47,"tag":68,"props":144,"children":145},{},[146],{"type":52,"value":147},"If no rule exists:",{"type":52,"value":149}," Use the LLM's ClickHouse knowledge or search documentation",{"type":47,"tag":103,"props":151,"children":152},{},[153,158],{"type":47,"tag":68,"props":154,"children":155},{},[156],{"type":52,"value":157},"If uncertain:",{"type":52,"value":159}," Use web search for current best practices",{"type":47,"tag":103,"props":161,"children":162},{},[163,168],{"type":47,"tag":68,"props":164,"children":165},{},[166],{"type":52,"value":167},"Always cite your source:",{"type":52,"value":169}," rule name, \"general ClickHouse guidance\", or URL",{"type":47,"tag":55,"props":171,"children":172},{},[173,178],{"type":47,"tag":68,"props":174,"children":175},{},[176],{"type":52,"value":177},"Why rules take priority:",{"type":52,"value":179}," ClickHouse has specific behaviors (columnar storage, sparse indexes, merge tree mechanics) where general database intuition can be misleading. The rules encode validated, ClickHouse-specific guidance.",{"type":47,"tag":181,"props":182,"children":183},"hr",{},[],{"type":47,"tag":84,"props":185,"children":187},{"id":186},"agent-connectivity-query-workflow",[188],{"type":52,"value":189},"Agent Connectivity & Query Workflow",{"type":47,"tag":55,"props":191,"children":192},{},[193],{"type":52,"value":194},"Before querying ClickHouse, agents must establish a connection and follow the discovery workflow:",{"type":47,"tag":99,"props":196,"children":197},{},[198,209,227],{"type":47,"tag":103,"props":199,"children":200},{},[201,207],{"type":47,"tag":114,"props":202,"children":204},{"className":203},[],[205],{"type":52,"value":206},"rules\u002Fagent-connect-mcp.md",{"type":52,"value":208}," - Connection setup (MCP + CLI), credential discovery, output format selection",{"type":47,"tag":103,"props":210,"children":211},{},[212,218,220,225],{"type":47,"tag":114,"props":213,"children":215},{"className":214},[],[216],{"type":52,"value":217},"rules\u002Fagent-discovery-schema.md",{"type":52,"value":219}," - ",{"type":47,"tag":68,"props":221,"children":222},{},[223],{"type":52,"value":224},"CRITICAL",{"type":52,"value":226},": 7-step schema discovery workflow",{"type":47,"tag":103,"props":228,"children":229},{},[230,236,237,241],{"type":47,"tag":114,"props":231,"children":233},{"className":232},[],[234],{"type":52,"value":235},"rules\u002Fagent-query-safety.md",{"type":52,"value":219},{"type":47,"tag":68,"props":238,"children":239},{},[240],{"type":52,"value":224},{"type":52,"value":242},": LIMIT, timeouts, progressive exploration",{"type":47,"tag":55,"props":244,"children":245},{},[246],{"type":47,"tag":68,"props":247,"children":248},{},[249],{"type":52,"value":250},"Every agent session should follow this sequence:",{"type":47,"tag":99,"props":252,"children":253},{},[254,272,282,292,302],{"type":47,"tag":103,"props":255,"children":256},{},[257,262,264,270],{"type":47,"tag":68,"props":258,"children":259},{},[260],{"type":52,"value":261},"Connect",{"type":52,"value":263}," — establish connection via MCP or CLI (see ",{"type":47,"tag":114,"props":265,"children":267},{"className":266},[],[268],{"type":52,"value":269},"agent-connect-mcp",{"type":52,"value":271},")",{"type":47,"tag":103,"props":273,"children":274},{},[275,280],{"type":47,"tag":68,"props":276,"children":277},{},[278],{"type":52,"value":279},"Discover",{"type":52,"value":281}," — databases → tables → columns + comments → sort keys → skip indexes → sample → EXPLAIN",{"type":47,"tag":103,"props":283,"children":284},{},[285,290],{"type":47,"tag":68,"props":286,"children":287},{},[288],{"type":52,"value":289},"Plan",{"type":52,"value":291}," — use sort key and skip index knowledge to write efficient WHERE clauses",{"type":47,"tag":103,"props":293,"children":294},{},[295,300],{"type":47,"tag":68,"props":296,"children":297},{},[298],{"type":52,"value":299},"Execute",{"type":52,"value":301}," — run queries with LIMIT and timeouts",{"type":47,"tag":103,"props":303,"children":304},{},[305,310,312,318],{"type":47,"tag":68,"props":306,"children":307},{},[308],{"type":52,"value":309},"Recover",{"type":52,"value":311}," — on timeout\u002Fmemory errors, narrow filters and retry (see ",{"type":47,"tag":114,"props":313,"children":315},{"className":314},[],[316],{"type":52,"value":317},"agent-query-safety",{"type":52,"value":271},{"type":47,"tag":320,"props":321,"children":323},"h3",{"id":322},"subagent-architecture-notes",[324],{"type":52,"value":325},"Subagent architecture notes",{"type":47,"tag":55,"props":327,"children":328},{},[329],{"type":52,"value":330},"If your system dispatches ClickHouse tasks to specialized subagents:",{"type":47,"tag":332,"props":333,"children":334},"ul",{},[335,345,355],{"type":47,"tag":103,"props":336,"children":337},{},[338,343],{"type":47,"tag":68,"props":339,"children":340},{},[341],{"type":52,"value":342},"Schema discovery + query execution",{"type":52,"value":344},": any model — the steps are procedural",{"type":47,"tag":103,"props":346,"children":347},{},[348,353],{"type":47,"tag":68,"props":349,"children":350},{},[351],{"type":52,"value":352},"EXPLAIN analysis + query optimization",{"type":52,"value":354},": benefits from mid-tier reasoning",{"type":47,"tag":103,"props":356,"children":357},{},[358,363],{"type":47,"tag":68,"props":359,"children":360},{},[361],{"type":52,"value":362},"Schema design review against all 28 rules",{"type":52,"value":354},{"type":47,"tag":181,"props":365,"children":366},{},[],{"type":47,"tag":84,"props":368,"children":370},{"id":369},"review-procedures",[371],{"type":52,"value":372},"Review Procedures",{"type":47,"tag":320,"props":374,"children":376},{"id":375},"for-schema-reviews-create-table-alter-table",[377],{"type":52,"value":378},"For Schema Reviews (CREATE TABLE, ALTER TABLE)",{"type":47,"tag":55,"props":380,"children":381},{},[382],{"type":47,"tag":68,"props":383,"children":384},{},[385],{"type":52,"value":386},"Read these rule files in order:",{"type":47,"tag":99,"props":388,"children":389},{},[390,401,412,423,434,445,456,467,478],{"type":47,"tag":103,"props":391,"children":392},{},[393,399],{"type":47,"tag":114,"props":394,"children":396},{"className":395},[],[397],{"type":52,"value":398},"rules\u002Fschema-pk-plan-before-creation.md",{"type":52,"value":400}," - ORDER BY is immutable",{"type":47,"tag":103,"props":402,"children":403},{},[404,410],{"type":47,"tag":114,"props":405,"children":407},{"className":406},[],[408],{"type":52,"value":409},"rules\u002Fschema-pk-cardinality-order.md",{"type":52,"value":411}," - Column ordering in keys",{"type":47,"tag":103,"props":413,"children":414},{},[415,421],{"type":47,"tag":114,"props":416,"children":418},{"className":417},[],[419],{"type":52,"value":420},"rules\u002Fschema-pk-prioritize-filters.md",{"type":52,"value":422}," - Filter column inclusion",{"type":47,"tag":103,"props":424,"children":425},{},[426,432],{"type":47,"tag":114,"props":427,"children":429},{"className":428},[],[430],{"type":52,"value":431},"rules\u002Fschema-types-native-types.md",{"type":52,"value":433}," - Proper type selection",{"type":47,"tag":103,"props":435,"children":436},{},[437,443],{"type":47,"tag":114,"props":438,"children":440},{"className":439},[],[441],{"type":52,"value":442},"rules\u002Fschema-types-minimize-bitwidth.md",{"type":52,"value":444}," - Numeric type sizing",{"type":47,"tag":103,"props":446,"children":447},{},[448,454],{"type":47,"tag":114,"props":449,"children":451},{"className":450},[],[452],{"type":52,"value":453},"rules\u002Fschema-types-lowcardinality.md",{"type":52,"value":455}," - LowCardinality usage",{"type":47,"tag":103,"props":457,"children":458},{},[459,465],{"type":47,"tag":114,"props":460,"children":462},{"className":461},[],[463],{"type":52,"value":464},"rules\u002Fschema-types-avoid-nullable.md",{"type":52,"value":466}," - Nullable vs DEFAULT",{"type":47,"tag":103,"props":468,"children":469},{},[470,476],{"type":47,"tag":114,"props":471,"children":473},{"className":472},[],[474],{"type":52,"value":475},"rules\u002Fschema-partition-low-cardinality.md",{"type":52,"value":477}," - Partition count limits",{"type":47,"tag":103,"props":479,"children":480},{},[481,487],{"type":47,"tag":114,"props":482,"children":484},{"className":483},[],[485],{"type":52,"value":486},"rules\u002Fschema-partition-lifecycle.md",{"type":52,"value":488}," - Partitioning purpose",{"type":47,"tag":55,"props":490,"children":491},{},[492],{"type":47,"tag":68,"props":493,"children":494},{},[495],{"type":52,"value":496},"Check for:",{"type":47,"tag":332,"props":498,"children":501},{"className":499},[500],"contains-task-list",[502,515,524,533,542],{"type":47,"tag":103,"props":503,"children":506},{"className":504},[505],"task-list-item",[507,513],{"type":47,"tag":508,"props":509,"children":512},"input",{"disabled":510,"type":511},true,"checkbox",[],{"type":52,"value":514}," PRIMARY KEY \u002F ORDER BY column order (low-to-high cardinality)",{"type":47,"tag":103,"props":516,"children":518},{"className":517},[505],[519,522],{"type":47,"tag":508,"props":520,"children":521},{"disabled":510,"type":511},[],{"type":52,"value":523}," Data types match actual data ranges",{"type":47,"tag":103,"props":525,"children":527},{"className":526},[505],[528,531],{"type":47,"tag":508,"props":529,"children":530},{"disabled":510,"type":511},[],{"type":52,"value":532}," LowCardinality applied to appropriate string columns",{"type":47,"tag":103,"props":534,"children":536},{"className":535},[505],[537,540],{"type":47,"tag":508,"props":538,"children":539},{"disabled":510,"type":511},[],{"type":52,"value":541}," Partition key cardinality bounded (100-1,000 values)",{"type":47,"tag":103,"props":543,"children":545},{"className":544},[505],[546,549],{"type":47,"tag":508,"props":547,"children":548},{"disabled":510,"type":511},[],{"type":52,"value":550}," ReplacingMergeTree has version column if used",{"type":47,"tag":320,"props":552,"children":554},{"id":553},"for-query-reviews-select-join-aggregations",[555],{"type":52,"value":556},"For Query Reviews (SELECT, JOIN, aggregations)",{"type":47,"tag":55,"props":558,"children":559},{},[560],{"type":47,"tag":68,"props":561,"children":562},{},[563],{"type":52,"value":564},"Read these rule files:",{"type":47,"tag":99,"props":566,"children":567},{},[568,579,590,601,612],{"type":47,"tag":103,"props":569,"children":570},{},[571,577],{"type":47,"tag":114,"props":572,"children":574},{"className":573},[],[575],{"type":52,"value":576},"rules\u002Fquery-join-choose-algorithm.md",{"type":52,"value":578}," - Algorithm selection",{"type":47,"tag":103,"props":580,"children":581},{},[582,588],{"type":47,"tag":114,"props":583,"children":585},{"className":584},[],[586],{"type":52,"value":587},"rules\u002Fquery-join-filter-before.md",{"type":52,"value":589}," - Pre-join filtering",{"type":47,"tag":103,"props":591,"children":592},{},[593,599],{"type":47,"tag":114,"props":594,"children":596},{"className":595},[],[597],{"type":52,"value":598},"rules\u002Fquery-join-use-any.md",{"type":52,"value":600}," - ANY vs regular JOIN",{"type":47,"tag":103,"props":602,"children":603},{},[604,610],{"type":47,"tag":114,"props":605,"children":607},{"className":606},[],[608],{"type":52,"value":609},"rules\u002Fquery-index-skipping-indices.md",{"type":52,"value":611}," - Secondary index usage",{"type":47,"tag":103,"props":613,"children":614},{},[615,621],{"type":47,"tag":114,"props":616,"children":618},{"className":617},[],[619],{"type":52,"value":620},"rules\u002Fschema-pk-filter-on-orderby.md",{"type":52,"value":622}," - Filter alignment with ORDER BY",{"type":47,"tag":55,"props":624,"children":625},{},[626],{"type":47,"tag":68,"props":627,"children":628},{},[629],{"type":52,"value":496},{"type":47,"tag":332,"props":631,"children":633},{"className":632},[500],[634,643,652,661],{"type":47,"tag":103,"props":635,"children":637},{"className":636},[505],[638,641],{"type":47,"tag":508,"props":639,"children":640},{"disabled":510,"type":511},[],{"type":52,"value":642}," Filters use ORDER BY prefix columns",{"type":47,"tag":103,"props":644,"children":646},{"className":645},[505],[647,650],{"type":47,"tag":508,"props":648,"children":649},{"disabled":510,"type":511},[],{"type":52,"value":651}," JOINs filter tables before joining (not after)",{"type":47,"tag":103,"props":653,"children":655},{"className":654},[505],[656,659],{"type":47,"tag":508,"props":657,"children":658},{"disabled":510,"type":511},[],{"type":52,"value":660}," Correct JOIN algorithm for table sizes",{"type":47,"tag":103,"props":662,"children":664},{"className":663},[505],[665,668],{"type":47,"tag":508,"props":666,"children":667},{"disabled":510,"type":511},[],{"type":52,"value":669}," Skipping indices for non-ORDER BY filter columns",{"type":47,"tag":320,"props":671,"children":673},{"id":672},"for-insert-strategy-reviews-data-ingestion-updates-deletes",[674],{"type":52,"value":675},"For Insert Strategy Reviews (data ingestion, updates, deletes)",{"type":47,"tag":55,"props":677,"children":678},{},[679],{"type":47,"tag":68,"props":680,"children":681},{},[682],{"type":52,"value":564},{"type":47,"tag":99,"props":684,"children":685},{},[686,697,708,719,730],{"type":47,"tag":103,"props":687,"children":688},{},[689,695],{"type":47,"tag":114,"props":690,"children":692},{"className":691},[],[693],{"type":52,"value":694},"rules\u002Finsert-batch-size.md",{"type":52,"value":696}," - Batch sizing requirements",{"type":47,"tag":103,"props":698,"children":699},{},[700,706],{"type":47,"tag":114,"props":701,"children":703},{"className":702},[],[704],{"type":52,"value":705},"rules\u002Finsert-mutation-avoid-update.md",{"type":52,"value":707}," - UPDATE alternatives",{"type":47,"tag":103,"props":709,"children":710},{},[711,717],{"type":47,"tag":114,"props":712,"children":714},{"className":713},[],[715],{"type":52,"value":716},"rules\u002Finsert-mutation-avoid-delete.md",{"type":52,"value":718}," - DELETE alternatives",{"type":47,"tag":103,"props":720,"children":721},{},[722,728],{"type":47,"tag":114,"props":723,"children":725},{"className":724},[],[726],{"type":52,"value":727},"rules\u002Finsert-async-small-batches.md",{"type":52,"value":729}," - Async insert usage",{"type":47,"tag":103,"props":731,"children":732},{},[733,739],{"type":47,"tag":114,"props":734,"children":736},{"className":735},[],[737],{"type":52,"value":738},"rules\u002Finsert-optimize-avoid-final.md",{"type":52,"value":740}," - OPTIMIZE TABLE risks",{"type":47,"tag":55,"props":742,"children":743},{},[744],{"type":47,"tag":68,"props":745,"children":746},{},[747],{"type":52,"value":496},{"type":47,"tag":332,"props":749,"children":751},{"className":750},[500],[752,761,770,779],{"type":47,"tag":103,"props":753,"children":755},{"className":754},[505],[756,759],{"type":47,"tag":508,"props":757,"children":758},{"disabled":510,"type":511},[],{"type":52,"value":760}," Batch size 10K-100K rows per INSERT",{"type":47,"tag":103,"props":762,"children":764},{"className":763},[505],[765,768],{"type":47,"tag":508,"props":766,"children":767},{"disabled":510,"type":511},[],{"type":52,"value":769}," No ALTER TABLE UPDATE for frequent changes",{"type":47,"tag":103,"props":771,"children":773},{"className":772},[505],[774,777],{"type":47,"tag":508,"props":775,"children":776},{"disabled":510,"type":511},[],{"type":52,"value":778}," ReplacingMergeTree or CollapsingMergeTree for update patterns",{"type":47,"tag":103,"props":780,"children":782},{"className":781},[505],[783,786],{"type":47,"tag":508,"props":784,"children":785},{"disabled":510,"type":511},[],{"type":52,"value":787}," Async inserts enabled for high-frequency small batches",{"type":47,"tag":181,"props":789,"children":790},{},[],{"type":47,"tag":84,"props":792,"children":794},{"id":793},"output-format",[795],{"type":52,"value":796},"Output Format",{"type":47,"tag":55,"props":798,"children":799},{},[800],{"type":52,"value":801},"Structure your response as follows:",{"type":47,"tag":803,"props":804,"children":808},"pre",{"className":805,"code":807,"language":52},[806],"language-text","## Rules Checked\n- `rule-name-1` - Compliant \u002F Violation found\n- `rule-name-2` - Compliant \u002F Violation found\n...\n\n## Findings\n\n### Violations\n- **`rule-name`**: Description of the issue\n  - Current: [what the code does]\n  - Required: [what it should do]\n  - Fix: [specific correction]\n\n### Compliant\n- `rule-name`: Brief note on why it's correct\n\n## Recommendations\n[Prioritized list of changes, citing rules]\n",[809],{"type":47,"tag":114,"props":810,"children":812},{"__ignoreMap":811},"",[813],{"type":52,"value":807},{"type":47,"tag":181,"props":815,"children":816},{},[],{"type":47,"tag":84,"props":818,"children":820},{"id":819},"rule-categories-by-priority",[821],{"type":52,"value":822},"Rule Categories by Priority",{"type":47,"tag":824,"props":825,"children":826},"table",{},[827,861],{"type":47,"tag":828,"props":829,"children":830},"thead",{},[831],{"type":47,"tag":832,"props":833,"children":834},"tr",{},[835,841,846,851,856],{"type":47,"tag":836,"props":837,"children":838},"th",{},[839],{"type":52,"value":840},"Priority",{"type":47,"tag":836,"props":842,"children":843},{},[844],{"type":52,"value":845},"Category",{"type":47,"tag":836,"props":847,"children":848},{},[849],{"type":52,"value":850},"Impact",{"type":47,"tag":836,"props":852,"children":853},{},[854],{"type":52,"value":855},"Prefix",{"type":47,"tag":836,"props":857,"children":858},{},[859],{"type":52,"value":860},"Rule Count",{"type":47,"tag":862,"props":863,"children":864},"tbody",{},[865,897,928,958,987,1016,1047,1077,1107,1137,1167,1198,1228,1258],{"type":47,"tag":832,"props":866,"children":867},{},[868,874,879,883,892],{"type":47,"tag":869,"props":870,"children":871},"td",{},[872],{"type":52,"value":873},"1",{"type":47,"tag":869,"props":875,"children":876},{},[877],{"type":52,"value":878},"Primary Key Selection",{"type":47,"tag":869,"props":880,"children":881},{},[882],{"type":52,"value":224},{"type":47,"tag":869,"props":884,"children":885},{},[886],{"type":47,"tag":114,"props":887,"children":889},{"className":888},[],[890],{"type":52,"value":891},"schema-pk-",{"type":47,"tag":869,"props":893,"children":894},{},[895],{"type":52,"value":896},"4",{"type":47,"tag":832,"props":898,"children":899},{},[900,905,910,914,923],{"type":47,"tag":869,"props":901,"children":902},{},[903],{"type":52,"value":904},"2",{"type":47,"tag":869,"props":906,"children":907},{},[908],{"type":52,"value":909},"Data Type Selection",{"type":47,"tag":869,"props":911,"children":912},{},[913],{"type":52,"value":224},{"type":47,"tag":869,"props":915,"children":916},{},[917],{"type":47,"tag":114,"props":918,"children":920},{"className":919},[],[921],{"type":52,"value":922},"schema-types-",{"type":47,"tag":869,"props":924,"children":925},{},[926],{"type":52,"value":927},"5",{"type":47,"tag":832,"props":929,"children":930},{},[931,936,941,945,954],{"type":47,"tag":869,"props":932,"children":933},{},[934],{"type":52,"value":935},"3",{"type":47,"tag":869,"props":937,"children":938},{},[939],{"type":52,"value":940},"JOIN Optimization",{"type":47,"tag":869,"props":942,"children":943},{},[944],{"type":52,"value":224},{"type":47,"tag":869,"props":946,"children":947},{},[948],{"type":47,"tag":114,"props":949,"children":951},{"className":950},[],[952],{"type":52,"value":953},"query-join-",{"type":47,"tag":869,"props":955,"children":956},{},[957],{"type":52,"value":927},{"type":47,"tag":832,"props":959,"children":960},{},[961,965,970,974,983],{"type":47,"tag":869,"props":962,"children":963},{},[964],{"type":52,"value":896},{"type":47,"tag":869,"props":966,"children":967},{},[968],{"type":52,"value":969},"Insert Batching",{"type":47,"tag":869,"props":971,"children":972},{},[973],{"type":52,"value":224},{"type":47,"tag":869,"props":975,"children":976},{},[977],{"type":47,"tag":114,"props":978,"children":980},{"className":979},[],[981],{"type":52,"value":982},"insert-batch-",{"type":47,"tag":869,"props":984,"children":985},{},[986],{"type":52,"value":873},{"type":47,"tag":832,"props":988,"children":989},{},[990,994,999,1003,1012],{"type":47,"tag":869,"props":991,"children":992},{},[993],{"type":52,"value":927},{"type":47,"tag":869,"props":995,"children":996},{},[997],{"type":52,"value":998},"Mutation Avoidance",{"type":47,"tag":869,"props":1000,"children":1001},{},[1002],{"type":52,"value":224},{"type":47,"tag":869,"props":1004,"children":1005},{},[1006],{"type":47,"tag":114,"props":1007,"children":1009},{"className":1008},[],[1010],{"type":52,"value":1011},"insert-mutation-",{"type":47,"tag":869,"props":1013,"children":1014},{},[1015],{"type":52,"value":904},{"type":47,"tag":832,"props":1017,"children":1018},{},[1019,1024,1029,1034,1043],{"type":47,"tag":869,"props":1020,"children":1021},{},[1022],{"type":52,"value":1023},"6",{"type":47,"tag":869,"props":1025,"children":1026},{},[1027],{"type":52,"value":1028},"Partitioning Strategy",{"type":47,"tag":869,"props":1030,"children":1031},{},[1032],{"type":52,"value":1033},"HIGH",{"type":47,"tag":869,"props":1035,"children":1036},{},[1037],{"type":47,"tag":114,"props":1038,"children":1040},{"className":1039},[],[1041],{"type":52,"value":1042},"schema-partition-",{"type":47,"tag":869,"props":1044,"children":1045},{},[1046],{"type":52,"value":896},{"type":47,"tag":832,"props":1048,"children":1049},{},[1050,1055,1060,1064,1073],{"type":47,"tag":869,"props":1051,"children":1052},{},[1053],{"type":52,"value":1054},"7",{"type":47,"tag":869,"props":1056,"children":1057},{},[1058],{"type":52,"value":1059},"Skipping Indices",{"type":47,"tag":869,"props":1061,"children":1062},{},[1063],{"type":52,"value":1033},{"type":47,"tag":869,"props":1065,"children":1066},{},[1067],{"type":47,"tag":114,"props":1068,"children":1070},{"className":1069},[],[1071],{"type":52,"value":1072},"query-index-",{"type":47,"tag":869,"props":1074,"children":1075},{},[1076],{"type":52,"value":873},{"type":47,"tag":832,"props":1078,"children":1079},{},[1080,1085,1090,1094,1103],{"type":47,"tag":869,"props":1081,"children":1082},{},[1083],{"type":52,"value":1084},"8",{"type":47,"tag":869,"props":1086,"children":1087},{},[1088],{"type":52,"value":1089},"Materialized Views",{"type":47,"tag":869,"props":1091,"children":1092},{},[1093],{"type":52,"value":1033},{"type":47,"tag":869,"props":1095,"children":1096},{},[1097],{"type":47,"tag":114,"props":1098,"children":1100},{"className":1099},[],[1101],{"type":52,"value":1102},"query-mv-",{"type":47,"tag":869,"props":1104,"children":1105},{},[1106],{"type":52,"value":904},{"type":47,"tag":832,"props":1108,"children":1109},{},[1110,1115,1120,1124,1133],{"type":47,"tag":869,"props":1111,"children":1112},{},[1113],{"type":52,"value":1114},"9",{"type":47,"tag":869,"props":1116,"children":1117},{},[1118],{"type":52,"value":1119},"Async Inserts",{"type":47,"tag":869,"props":1121,"children":1122},{},[1123],{"type":52,"value":1033},{"type":47,"tag":869,"props":1125,"children":1126},{},[1127],{"type":47,"tag":114,"props":1128,"children":1130},{"className":1129},[],[1131],{"type":52,"value":1132},"insert-async-",{"type":47,"tag":869,"props":1134,"children":1135},{},[1136],{"type":52,"value":904},{"type":47,"tag":832,"props":1138,"children":1139},{},[1140,1145,1150,1154,1163],{"type":47,"tag":869,"props":1141,"children":1142},{},[1143],{"type":52,"value":1144},"10",{"type":47,"tag":869,"props":1146,"children":1147},{},[1148],{"type":52,"value":1149},"OPTIMIZE Avoidance",{"type":47,"tag":869,"props":1151,"children":1152},{},[1153],{"type":52,"value":1033},{"type":47,"tag":869,"props":1155,"children":1156},{},[1157],{"type":47,"tag":114,"props":1158,"children":1160},{"className":1159},[],[1161],{"type":52,"value":1162},"insert-optimize-",{"type":47,"tag":869,"props":1164,"children":1165},{},[1166],{"type":52,"value":873},{"type":47,"tag":832,"props":1168,"children":1169},{},[1170,1175,1180,1185,1194],{"type":47,"tag":869,"props":1171,"children":1172},{},[1173],{"type":52,"value":1174},"11",{"type":47,"tag":869,"props":1176,"children":1177},{},[1178],{"type":52,"value":1179},"JSON Usage",{"type":47,"tag":869,"props":1181,"children":1182},{},[1183],{"type":52,"value":1184},"MEDIUM",{"type":47,"tag":869,"props":1186,"children":1187},{},[1188],{"type":47,"tag":114,"props":1189,"children":1191},{"className":1190},[],[1192],{"type":52,"value":1193},"schema-json-",{"type":47,"tag":869,"props":1195,"children":1196},{},[1197],{"type":52,"value":873},{"type":47,"tag":832,"props":1199,"children":1200},{},[1201,1206,1211,1215,1224],{"type":47,"tag":869,"props":1202,"children":1203},{},[1204],{"type":52,"value":1205},"12",{"type":47,"tag":869,"props":1207,"children":1208},{},[1209],{"type":52,"value":1210},"Agent Schema Discovery",{"type":47,"tag":869,"props":1212,"children":1213},{},[1214],{"type":52,"value":224},{"type":47,"tag":869,"props":1216,"children":1217},{},[1218],{"type":47,"tag":114,"props":1219,"children":1221},{"className":1220},[],[1222],{"type":52,"value":1223},"agent-discovery-",{"type":47,"tag":869,"props":1225,"children":1226},{},[1227],{"type":52,"value":873},{"type":47,"tag":832,"props":1229,"children":1230},{},[1231,1236,1241,1245,1254],{"type":47,"tag":869,"props":1232,"children":1233},{},[1234],{"type":52,"value":1235},"13",{"type":47,"tag":869,"props":1237,"children":1238},{},[1239],{"type":52,"value":1240},"Agent Query Safety",{"type":47,"tag":869,"props":1242,"children":1243},{},[1244],{"type":52,"value":224},{"type":47,"tag":869,"props":1246,"children":1247},{},[1248],{"type":47,"tag":114,"props":1249,"children":1251},{"className":1250},[],[1252],{"type":52,"value":1253},"agent-query-",{"type":47,"tag":869,"props":1255,"children":1256},{},[1257],{"type":52,"value":873},{"type":47,"tag":832,"props":1259,"children":1260},{},[1261,1266,1271,1275,1284],{"type":47,"tag":869,"props":1262,"children":1263},{},[1264],{"type":52,"value":1265},"14",{"type":47,"tag":869,"props":1267,"children":1268},{},[1269],{"type":52,"value":1270},"Agent Connectivity + Formats",{"type":47,"tag":869,"props":1272,"children":1273},{},[1274],{"type":52,"value":1033},{"type":47,"tag":869,"props":1276,"children":1277},{},[1278],{"type":47,"tag":114,"props":1279,"children":1281},{"className":1280},[],[1282],{"type":52,"value":1283},"agent-connect-",{"type":47,"tag":869,"props":1285,"children":1286},{},[1287],{"type":52,"value":873},{"type":47,"tag":181,"props":1289,"children":1290},{},[],{"type":47,"tag":84,"props":1292,"children":1294},{"id":1293},"quick-reference",[1295],{"type":52,"value":1296},"Quick Reference",{"type":47,"tag":320,"props":1298,"children":1300},{"id":1299},"schema-design-primary-key-critical",[1301],{"type":52,"value":1302},"Schema Design - Primary Key (CRITICAL)",{"type":47,"tag":332,"props":1304,"children":1305},{},[1306,1317,1328,1339],{"type":47,"tag":103,"props":1307,"children":1308},{},[1309,1315],{"type":47,"tag":114,"props":1310,"children":1312},{"className":1311},[],[1313],{"type":52,"value":1314},"schema-pk-plan-before-creation",{"type":52,"value":1316}," - Plan ORDER BY before table creation (immutable)",{"type":47,"tag":103,"props":1318,"children":1319},{},[1320,1326],{"type":47,"tag":114,"props":1321,"children":1323},{"className":1322},[],[1324],{"type":52,"value":1325},"schema-pk-cardinality-order",{"type":52,"value":1327}," - Order columns low-to-high cardinality",{"type":47,"tag":103,"props":1329,"children":1330},{},[1331,1337],{"type":47,"tag":114,"props":1332,"children":1334},{"className":1333},[],[1335],{"type":52,"value":1336},"schema-pk-prioritize-filters",{"type":52,"value":1338}," - Include frequently filtered columns",{"type":47,"tag":103,"props":1340,"children":1341},{},[1342,1348],{"type":47,"tag":114,"props":1343,"children":1345},{"className":1344},[],[1346],{"type":52,"value":1347},"schema-pk-filter-on-orderby",{"type":52,"value":1349}," - Query filters must use ORDER BY prefix",{"type":47,"tag":320,"props":1351,"children":1353},{"id":1352},"schema-design-data-types-critical",[1354],{"type":52,"value":1355},"Schema Design - Data Types (CRITICAL)",{"type":47,"tag":332,"props":1357,"children":1358},{},[1359,1370,1381,1392,1403],{"type":47,"tag":103,"props":1360,"children":1361},{},[1362,1368],{"type":47,"tag":114,"props":1363,"children":1365},{"className":1364},[],[1366],{"type":52,"value":1367},"schema-types-native-types",{"type":52,"value":1369}," - Use native types, not String for everything",{"type":47,"tag":103,"props":1371,"children":1372},{},[1373,1379],{"type":47,"tag":114,"props":1374,"children":1376},{"className":1375},[],[1377],{"type":52,"value":1378},"schema-types-minimize-bitwidth",{"type":52,"value":1380}," - Use smallest numeric type that fits",{"type":47,"tag":103,"props":1382,"children":1383},{},[1384,1390],{"type":47,"tag":114,"props":1385,"children":1387},{"className":1386},[],[1388],{"type":52,"value":1389},"schema-types-lowcardinality",{"type":52,"value":1391}," - LowCardinality for \u003C10K unique strings",{"type":47,"tag":103,"props":1393,"children":1394},{},[1395,1401],{"type":47,"tag":114,"props":1396,"children":1398},{"className":1397},[],[1399],{"type":52,"value":1400},"schema-types-enum",{"type":52,"value":1402}," - Enum for finite value sets with validation",{"type":47,"tag":103,"props":1404,"children":1405},{},[1406,1412],{"type":47,"tag":114,"props":1407,"children":1409},{"className":1408},[],[1410],{"type":52,"value":1411},"schema-types-avoid-nullable",{"type":52,"value":1413}," - Avoid Nullable; use DEFAULT instead",{"type":47,"tag":320,"props":1415,"children":1417},{"id":1416},"schema-design-partitioning-high",[1418],{"type":52,"value":1419},"Schema Design - Partitioning (HIGH)",{"type":47,"tag":332,"props":1421,"children":1422},{},[1423,1434,1445,1456],{"type":47,"tag":103,"props":1424,"children":1425},{},[1426,1432],{"type":47,"tag":114,"props":1427,"children":1429},{"className":1428},[],[1430],{"type":52,"value":1431},"schema-partition-low-cardinality",{"type":52,"value":1433}," - Keep partition count 100-1,000",{"type":47,"tag":103,"props":1435,"children":1436},{},[1437,1443],{"type":47,"tag":114,"props":1438,"children":1440},{"className":1439},[],[1441],{"type":52,"value":1442},"schema-partition-lifecycle",{"type":52,"value":1444}," - Use partitioning for data lifecycle, not queries",{"type":47,"tag":103,"props":1446,"children":1447},{},[1448,1454],{"type":47,"tag":114,"props":1449,"children":1451},{"className":1450},[],[1452],{"type":52,"value":1453},"schema-partition-query-tradeoffs",{"type":52,"value":1455}," - Understand partition pruning trade-offs",{"type":47,"tag":103,"props":1457,"children":1458},{},[1459,1465],{"type":47,"tag":114,"props":1460,"children":1462},{"className":1461},[],[1463],{"type":52,"value":1464},"schema-partition-start-without",{"type":52,"value":1466}," - Consider starting without partitioning",{"type":47,"tag":320,"props":1468,"children":1470},{"id":1469},"schema-design-json-medium",[1471],{"type":52,"value":1472},"Schema Design - JSON (MEDIUM)",{"type":47,"tag":332,"props":1474,"children":1475},{},[1476],{"type":47,"tag":103,"props":1477,"children":1478},{},[1479,1485],{"type":47,"tag":114,"props":1480,"children":1482},{"className":1481},[],[1483],{"type":52,"value":1484},"schema-json-when-to-use",{"type":52,"value":1486}," - JSON for dynamic schemas; typed columns for known",{"type":47,"tag":320,"props":1488,"children":1490},{"id":1489},"query-optimization-joins-critical",[1491],{"type":52,"value":1492},"Query Optimization - JOINs (CRITICAL)",{"type":47,"tag":332,"props":1494,"children":1495},{},[1496,1507,1518,1529,1540],{"type":47,"tag":103,"props":1497,"children":1498},{},[1499,1505],{"type":47,"tag":114,"props":1500,"children":1502},{"className":1501},[],[1503],{"type":52,"value":1504},"query-join-choose-algorithm",{"type":52,"value":1506}," - Select algorithm based on table sizes",{"type":47,"tag":103,"props":1508,"children":1509},{},[1510,1516],{"type":47,"tag":114,"props":1511,"children":1513},{"className":1512},[],[1514],{"type":52,"value":1515},"query-join-use-any",{"type":52,"value":1517}," - ANY JOIN when only one match needed",{"type":47,"tag":103,"props":1519,"children":1520},{},[1521,1527],{"type":47,"tag":114,"props":1522,"children":1524},{"className":1523},[],[1525],{"type":52,"value":1526},"query-join-filter-before",{"type":52,"value":1528}," - Filter tables before joining",{"type":47,"tag":103,"props":1530,"children":1531},{},[1532,1538],{"type":47,"tag":114,"props":1533,"children":1535},{"className":1534},[],[1536],{"type":52,"value":1537},"query-join-consider-alternatives",{"type":52,"value":1539}," - Dictionaries\u002Fdenormalization vs JOIN",{"type":47,"tag":103,"props":1541,"children":1542},{},[1543,1549],{"type":47,"tag":114,"props":1544,"children":1546},{"className":1545},[],[1547],{"type":52,"value":1548},"query-join-null-handling",{"type":52,"value":1550}," - join_use_nulls=0 for default values",{"type":47,"tag":320,"props":1552,"children":1554},{"id":1553},"query-optimization-indices-high",[1555],{"type":52,"value":1556},"Query Optimization - Indices (HIGH)",{"type":47,"tag":332,"props":1558,"children":1559},{},[1560],{"type":47,"tag":103,"props":1561,"children":1562},{},[1563,1569],{"type":47,"tag":114,"props":1564,"children":1566},{"className":1565},[],[1567],{"type":52,"value":1568},"query-index-skipping-indices",{"type":52,"value":1570}," - Skipping indices for non-ORDER BY filters",{"type":47,"tag":320,"props":1572,"children":1574},{"id":1573},"query-optimization-materialized-views-high",[1575],{"type":52,"value":1576},"Query Optimization - Materialized Views (HIGH)",{"type":47,"tag":332,"props":1578,"children":1579},{},[1580,1591],{"type":47,"tag":103,"props":1581,"children":1582},{},[1583,1589],{"type":47,"tag":114,"props":1584,"children":1586},{"className":1585},[],[1587],{"type":52,"value":1588},"query-mv-incremental",{"type":52,"value":1590}," - Incremental MVs for real-time aggregations",{"type":47,"tag":103,"props":1592,"children":1593},{},[1594,1600],{"type":47,"tag":114,"props":1595,"children":1597},{"className":1596},[],[1598],{"type":52,"value":1599},"query-mv-refreshable",{"type":52,"value":1601}," - Refreshable MVs for complex joins",{"type":47,"tag":320,"props":1603,"children":1605},{"id":1604},"insert-strategy-batching-critical",[1606],{"type":52,"value":1607},"Insert Strategy - Batching (CRITICAL)",{"type":47,"tag":332,"props":1609,"children":1610},{},[1611],{"type":47,"tag":103,"props":1612,"children":1613},{},[1614,1620],{"type":47,"tag":114,"props":1615,"children":1617},{"className":1616},[],[1618],{"type":52,"value":1619},"insert-batch-size",{"type":52,"value":1621}," - Batch 10K-100K rows per INSERT",{"type":47,"tag":320,"props":1623,"children":1625},{"id":1624},"insert-strategy-async-high",[1626],{"type":52,"value":1627},"Insert Strategy - Async (HIGH)",{"type":47,"tag":332,"props":1629,"children":1630},{},[1631,1642],{"type":47,"tag":103,"props":1632,"children":1633},{},[1634,1640],{"type":47,"tag":114,"props":1635,"children":1637},{"className":1636},[],[1638],{"type":52,"value":1639},"insert-async-small-batches",{"type":52,"value":1641}," - Async inserts for high-frequency small batches",{"type":47,"tag":103,"props":1643,"children":1644},{},[1645,1651],{"type":47,"tag":114,"props":1646,"children":1648},{"className":1647},[],[1649],{"type":52,"value":1650},"insert-format-native",{"type":52,"value":1652}," - Native format for best performance",{"type":47,"tag":320,"props":1654,"children":1656},{"id":1655},"insert-strategy-mutations-critical",[1657],{"type":52,"value":1658},"Insert Strategy - Mutations (CRITICAL)",{"type":47,"tag":332,"props":1660,"children":1661},{},[1662,1673],{"type":47,"tag":103,"props":1663,"children":1664},{},[1665,1671],{"type":47,"tag":114,"props":1666,"children":1668},{"className":1667},[],[1669],{"type":52,"value":1670},"insert-mutation-avoid-update",{"type":52,"value":1672}," - ReplacingMergeTree instead of ALTER UPDATE",{"type":47,"tag":103,"props":1674,"children":1675},{},[1676,1682],{"type":47,"tag":114,"props":1677,"children":1679},{"className":1678},[],[1680],{"type":52,"value":1681},"insert-mutation-avoid-delete",{"type":52,"value":1683}," - Lightweight DELETE or DROP PARTITION",{"type":47,"tag":320,"props":1685,"children":1687},{"id":1686},"insert-strategy-optimization-high",[1688],{"type":52,"value":1689},"Insert Strategy - Optimization (HIGH)",{"type":47,"tag":332,"props":1691,"children":1692},{},[1693],{"type":47,"tag":103,"props":1694,"children":1695},{},[1696,1702],{"type":47,"tag":114,"props":1697,"children":1699},{"className":1698},[],[1700],{"type":52,"value":1701},"insert-optimize-avoid-final",{"type":52,"value":1703}," - Let background merges work",{"type":47,"tag":320,"props":1705,"children":1707},{"id":1706},"agent-integration-discovery-critical",[1708],{"type":52,"value":1709},"Agent Integration - Discovery (CRITICAL)",{"type":47,"tag":332,"props":1711,"children":1712},{},[1713],{"type":47,"tag":103,"props":1714,"children":1715},{},[1716,1722],{"type":47,"tag":114,"props":1717,"children":1719},{"className":1718},[],[1720],{"type":52,"value":1721},"agent-discovery-schema",{"type":52,"value":1723}," - Always discover schema before querying",{"type":47,"tag":320,"props":1725,"children":1727},{"id":1726},"agent-integration-safety-critical",[1728],{"type":52,"value":1729},"Agent Integration - Safety (CRITICAL)",{"type":47,"tag":332,"props":1731,"children":1732},{},[1733],{"type":47,"tag":103,"props":1734,"children":1735},{},[1736,1741],{"type":47,"tag":114,"props":1737,"children":1739},{"className":1738},[],[1740],{"type":52,"value":317},{"type":52,"value":1742}," - LIMIT, timeouts, progressive exploration",{"type":47,"tag":320,"props":1744,"children":1746},{"id":1745},"agent-integration-connectivity-formats-high",[1747],{"type":52,"value":1748},"Agent Integration - Connectivity + Formats (HIGH)",{"type":47,"tag":332,"props":1750,"children":1751},{},[1752],{"type":47,"tag":103,"props":1753,"children":1754},{},[1755,1760],{"type":47,"tag":114,"props":1756,"children":1758},{"className":1757},[],[1759],{"type":52,"value":269},{"type":52,"value":1761}," - MCP + CLI setup, credential discovery, output format selection",{"type":47,"tag":181,"props":1763,"children":1764},{},[],{"type":47,"tag":84,"props":1766,"children":1768},{"id":1767},"when-to-apply",[1769],{"type":52,"value":1770},"When to Apply",{"type":47,"tag":55,"props":1772,"children":1773},{},[1774],{"type":52,"value":1775},"This skill activates when you encounter:",{"type":47,"tag":332,"props":1777,"children":1778},{},[1779,1784,1789,1794,1805,1816,1835,1840,1845,1850,1855,1860,1865],{"type":47,"tag":103,"props":1780,"children":1781},{},[1782],{"type":52,"value":1783},"AI agent connecting to ClickHouse (MCP, CLI, HTTP)",{"type":47,"tag":103,"props":1785,"children":1786},{},[1787],{"type":52,"value":1788},"Agent workflow design for ClickHouse",{"type":47,"tag":103,"props":1790,"children":1791},{},[1792],{"type":52,"value":1793},"Schema discovery or exploration requests",{"type":47,"tag":103,"props":1795,"children":1796},{},[1797,1803],{"type":47,"tag":114,"props":1798,"children":1800},{"className":1799},[],[1801],{"type":52,"value":1802},"CREATE TABLE",{"type":52,"value":1804}," statements",{"type":47,"tag":103,"props":1806,"children":1807},{},[1808,1814],{"type":47,"tag":114,"props":1809,"children":1811},{"className":1810},[],[1812],{"type":52,"value":1813},"ALTER TABLE",{"type":52,"value":1815}," modifications",{"type":47,"tag":103,"props":1817,"children":1818},{},[1819,1825,1827,1833],{"type":47,"tag":114,"props":1820,"children":1822},{"className":1821},[],[1823],{"type":52,"value":1824},"ORDER BY",{"type":52,"value":1826}," or ",{"type":47,"tag":114,"props":1828,"children":1830},{"className":1829},[],[1831],{"type":52,"value":1832},"PRIMARY KEY",{"type":52,"value":1834}," discussions",{"type":47,"tag":103,"props":1836,"children":1837},{},[1838],{"type":52,"value":1839},"Data type selection questions",{"type":47,"tag":103,"props":1841,"children":1842},{},[1843],{"type":52,"value":1844},"Slow query troubleshooting",{"type":47,"tag":103,"props":1846,"children":1847},{},[1848],{"type":52,"value":1849},"JOIN optimization requests",{"type":47,"tag":103,"props":1851,"children":1852},{},[1853],{"type":52,"value":1854},"Data ingestion pipeline design",{"type":47,"tag":103,"props":1856,"children":1857},{},[1858],{"type":52,"value":1859},"Update\u002Fdelete strategy questions",{"type":47,"tag":103,"props":1861,"children":1862},{},[1863],{"type":52,"value":1864},"ReplacingMergeTree or other specialized engine usage",{"type":47,"tag":103,"props":1866,"children":1867},{},[1868],{"type":52,"value":1869},"Partitioning strategy decisions",{"type":47,"tag":181,"props":1871,"children":1872},{},[],{"type":47,"tag":84,"props":1874,"children":1876},{"id":1875},"rule-file-structure",[1877],{"type":52,"value":1878},"Rule File Structure",{"type":47,"tag":55,"props":1880,"children":1881},{},[1882,1884,1889],{"type":52,"value":1883},"Each rule file in ",{"type":47,"tag":114,"props":1885,"children":1887},{"className":1886},[],[1888],{"type":52,"value":119},{"type":52,"value":1890}," contains:",{"type":47,"tag":332,"props":1892,"children":1893},{},[1894,1904,1914,1924,1934],{"type":47,"tag":103,"props":1895,"children":1896},{},[1897,1902],{"type":47,"tag":68,"props":1898,"children":1899},{},[1900],{"type":52,"value":1901},"YAML frontmatter",{"type":52,"value":1903},": title, impact level, tags",{"type":47,"tag":103,"props":1905,"children":1906},{},[1907,1912],{"type":47,"tag":68,"props":1908,"children":1909},{},[1910],{"type":52,"value":1911},"Brief explanation",{"type":52,"value":1913},": Why this rule matters",{"type":47,"tag":103,"props":1915,"children":1916},{},[1917,1922],{"type":47,"tag":68,"props":1918,"children":1919},{},[1920],{"type":52,"value":1921},"Incorrect example",{"type":52,"value":1923},": Anti-pattern with explanation",{"type":47,"tag":103,"props":1925,"children":1926},{},[1927,1932],{"type":47,"tag":68,"props":1928,"children":1929},{},[1930],{"type":52,"value":1931},"Correct example",{"type":52,"value":1933},": Best practice with explanation",{"type":47,"tag":103,"props":1935,"children":1936},{},[1937,1942],{"type":47,"tag":68,"props":1938,"children":1939},{},[1940],{"type":52,"value":1941},"Additional context",{"type":52,"value":1943},": Trade-offs, when to apply, references",{"type":47,"tag":181,"props":1945,"children":1946},{},[],{"type":47,"tag":84,"props":1948,"children":1950},{"id":1949},"full-compiled-document",[1951],{"type":52,"value":1952},"Full Compiled Document",{"type":47,"tag":55,"props":1954,"children":1955},{},[1956,1958],{"type":52,"value":1957},"For the complete guide with all rules expanded inline: ",{"type":47,"tag":114,"props":1959,"children":1961},{"className":1960},[],[1962],{"type":52,"value":1963},"AGENTS.md",{"type":47,"tag":55,"props":1965,"children":1966},{},[1967,1969,1974],{"type":52,"value":1968},"Use ",{"type":47,"tag":114,"props":1970,"children":1972},{"className":1971},[],[1973],{"type":52,"value":1963},{"type":52,"value":1975}," when you need to check multiple rules quickly without reading individual files.",{"items":1977,"total":2170},[1978,1996,2008,2022,2030,2048,2072,2090,2104,2121,2133,2153],{"slug":1979,"name":1979,"fn":1980,"description":1981,"org":1982,"tags":1983,"stars":26,"repoUrl":27,"updatedAt":1995},"chdb-datastore","accelerate pandas with chDB datastore","Use when the user has tabular data (pandas DataFrame, parquet, csv, Arrow, json) and wants to filter, group, aggregate, join, or speed up slow pandas. Provides chDB DataStore — same pandas API, ClickHouse engine underneath. Also handles reading from S3, MySQL, PostgreSQL, MongoDB, ClickHouse Cloud, Iceberg, Delta Lake as DataFrames and joining across sources. TRIGGER when: user mentions DataFrame, parquet, csv, \"fast pandas\", \"speed up pandas\", or cross-source DataFrame joins; user imports `chdb.datastore` or `from datastore import DataStore`. SKIP this skill for raw SQL syntax (use chdb-sql instead), ClickHouse server administration, or non-Python DataStore API work.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1984,1985,1988,1991,1992],{"name":9,"slug":8,"type":13},{"name":1986,"slug":1987,"type":13},"Data Analysis","data-analysis",{"name":1989,"slug":1990,"type":13},"Data Engineering","data-engineering",{"name":15,"slug":16,"type":13},{"name":1993,"slug":1994,"type":13},"Python","python","2026-04-15T04:56:32.0629",{"slug":1997,"name":1997,"fn":1998,"description":1999,"org":2000,"tags":2001,"stars":26,"repoUrl":27,"updatedAt":2007},"chdb-sql","run ClickHouse SQL queries in Python","Use when the user wants to run SQL — especially analytical SQL — on local files (parquet\u002Fcsv\u002Fjson), URLs, S3 paths, or remote databases (Postgres, MySQL, MongoDB, ClickHouse Cloud, Iceberg, Delta Lake) without setting up a server. Provides chDB — embedded ClickHouse SQL in Python with 1000+ functions, Session for stateful multi-step pipelines, parametrized queries, and cross-source joins via `s3()`, `mysql()`, `postgresql()`, `iceberg()`, `deltaLake()`, `remoteSecure()` table functions. TRIGGER when: user wants SQL on parquet\u002Fcsv\u002Ffiles or across remote analytical sources; uses ClickHouse SQL features (window functions, windowFunnel, geoToH3, JSON path ops, Session, parametrized queries); imports `chdb` or calls `chdb.query()`. SKIP this skill for pandas-style DataFrame method-chaining (use chdb-datastore instead) or ClickHouse server administration.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2002,2003,2004,2005,2006],{"name":9,"slug":8,"type":13},{"name":1986,"slug":1987,"type":13},{"name":1989,"slug":1990,"type":13},{"name":1993,"slug":1994,"type":13},{"name":24,"slug":25,"type":13},"2026-04-15T04:56:33.299509",{"slug":2009,"name":2009,"fn":2010,"description":2011,"org":2012,"tags":2013,"stars":26,"repoUrl":27,"updatedAt":2021},"clickhouse-architecture-advisor","advise on ClickHouse architectures","MUST USE when designing ClickHouse architectures, selecting between ingestion or modeling patterns, or translating best practices into workload-specific system designs. Complements clickhouse-best-practices with decision frameworks and explicit provenance labels.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2014,2017,2018,2019,2020],{"name":2015,"slug":2016,"type":13},"Architecture","architecture",{"name":9,"slug":8,"type":13},{"name":1989,"slug":1990,"type":13},{"name":21,"slug":22,"type":13},{"name":15,"slug":16,"type":13},"2026-04-15T04:56:34.534001",{"slug":4,"name":4,"fn":5,"description":6,"org":2023,"tags":2024,"stars":26,"repoUrl":27,"updatedAt":28},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2025,2026,2027,2028,2029],{"name":9,"slug":8,"type":13},{"name":18,"slug":19,"type":13},{"name":21,"slug":22,"type":13},{"name":15,"slug":16,"type":13},{"name":24,"slug":25,"type":13},{"slug":2031,"name":2031,"fn":2032,"description":2033,"org":2034,"tags":2035,"stars":26,"repoUrl":27,"updatedAt":2047},"clickhouse-js-node-rowbinary","encode and decode ClickHouse RowBinary streams","Generate TypeScript\u002FJavaScript code that reads\u002Fdecodes AND writes\u002Fencodes ClickHouse RowBinary streams for the ClickHouse HTTP server. Use this skill whenever a user wants to parse or produce `RowBinary`, `RowBinaryWithNames`, or `RowBinaryWithNamesAndTypes`. Node.js only, doesn't cover browsers.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2036,2039,2040,2041,2044],{"name":2037,"slug":2038,"type":13},"API Development","api-development",{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"name":2042,"slug":2043,"type":13},"JavaScript","javascript",{"name":2045,"slug":2046,"type":13},"TypeScript","typescript","2026-07-01T08:16:19.314713",{"slug":2049,"name":2049,"fn":2050,"description":2051,"org":2052,"tags":2053,"stars":26,"repoUrl":27,"updatedAt":2071},"clickhouse-managed-postgres-rca","diagnose performance issues on ClickHouse-managed Postgres","MUST USE when investigating performance issues on a ClickHouse-managed Postgres instance. Provides an evidence-based RCA workflow that scrapes the Prometheus endpoint for system signal, pulls per-digest evidence from the Slow Query Patterns API, and recommends (does not apply) a fix.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2054,2055,2058,2061,2064,2065,2068],{"name":9,"slug":8,"type":13},{"name":2056,"slug":2057,"type":13},"Debugging","debugging",{"name":2059,"slug":2060,"type":13},"Monitoring","monitoring",{"name":2062,"slug":2063,"type":13},"Observability","observability",{"name":15,"slug":16,"type":13},{"name":2066,"slug":2067,"type":13},"PostgreSQL","postgresql",{"name":2069,"slug":2070,"type":13},"Prometheus","prometheus","2026-06-08T08:19:31.589978",{"slug":2073,"name":2073,"fn":2074,"description":2075,"org":2076,"tags":2077,"stars":26,"repoUrl":27,"updatedAt":2089},"infra-clickhouse","manage ClickHouse server instances","Sets up and manages ClickHouse using the clickhousectl CLI — installs and runs a local ClickHouse server for development, and creates managed ClickHouse Cloud services for production (authentication, service creation, schema migration, application connection). Use when the user wants to build an application with ClickHouse, set up a local ClickHouse dev environment, create tables and start querying, deploy ClickHouse to production or ClickHouse Cloud, or migrate from a local setup to the cloud.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2078,2081,2082,2083,2086],{"name":2079,"slug":2080,"type":13},"CLI","cli",{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"name":2084,"slug":2085,"type":13},"Deployment","deployment",{"name":2087,"slug":2088,"type":13},"Infrastructure","infrastructure","2026-07-28T06:06:00.02089",{"slug":2091,"name":2091,"fn":2092,"description":2093,"org":2094,"tags":2095,"stars":26,"repoUrl":27,"updatedAt":2103},"infra-postgres","manage PostgreSQL database instances","Sets up and manages Postgres using the clickhousectl CLI — runs a local Docker-backed Postgres for development, and creates and operates managed ClickHouse Cloud Postgres services (connections, TLS, runtime config, read replicas, failover, point-in-time restore). Use when the user wants a Postgres or PostgreSQL database for their application, a local Postgres dev environment, psql access, or a managed\u002Fproduction Postgres in ClickHouse Cloud, or mentions moving a local Postgres to production.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2096,2097,2098,2101,2102],{"name":21,"slug":22,"type":13},{"name":2084,"slug":2085,"type":13},{"name":2099,"slug":2100,"type":13},"Docker","docker",{"name":2087,"slug":2088,"type":13},{"name":2066,"slug":2067,"type":13},"2026-07-28T06:06:07.151976",{"slug":2105,"name":2105,"fn":2106,"description":2107,"org":2108,"tags":2109,"stars":2118,"repoUrl":2119,"updatedAt":2120},"clickhouse-js-node-coding","build Node.js applications with ClickHouse","Write idiomatic application code with the ClickHouse Node.js client (`@clickhouse\u002Fclient`). Use this skill whenever a user is *building* against the Node.js client — configuring the client, pinging, inserting rows in JSON or raw formats, selecting and parsing results, binding query parameters, managing sessions and temporary tables, working with data types or customizing JSON parsing. Do NOT use for browser\u002FWeb client code.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2110,2113,2114,2115],{"name":2111,"slug":2112,"type":13},"Backend","backend",{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"name":2116,"slug":2117,"type":13},"Node.js","node-js",321,"https:\u002F\u002Fgithub.com\u002FClickHouse\u002Fclickhouse-js","2026-05-06T05:41:40.923776",{"slug":2122,"name":2122,"fn":2123,"description":2124,"org":2125,"tags":2126,"stars":2118,"repoUrl":2119,"updatedAt":2132},"clickhouse-js-node-troubleshooting","troubleshoot ClickHouse Node.js client","Troubleshoot and resolve common issues with the ClickHouse Node.js client (@clickhouse\u002Fclient). Use this skill whenever a user reports errors, unexpected behavior, or configuration questions involving the Node.js client specifically — including socket hang-up errors, Keep-Alive problems, stream handling issues, data type mismatches, read-only user restrictions, proxy\u002FTLS setup problems, or long-running query timeouts. Trigger even when the user hasn't precisely named the issue; vague symptoms like \"my inserts keep failing\" or \"connection drops randomly\" in a Node.js context are strong signals to use this skill. Do NOT use for browser\u002FWeb client issues.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2127,2128,2129,2131],{"name":9,"slug":8,"type":13},{"name":2056,"slug":2057,"type":13},{"name":2116,"slug":2130,"type":13},"nodejs",{"name":2045,"slug":2046,"type":13},"2026-04-14T04:56:39.447406",{"slug":2134,"name":2134,"fn":2135,"description":2136,"org":2137,"tags":2138,"stars":2150,"repoUrl":2151,"updatedAt":2152},"clickstack-otel-collector","set up OpenTelemetry collector for ClickHouse","Use when a user wants to wire an OpenTelemetry collector into a Managed ClickStack service on ClickHouse Cloud, either by deploying a new local collector (Docker run or Docker Compose) or by configuring their own existing collector, then send rich synthetic telemetry and verify it is visible in ClickStack.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2139,2140,2143,2146,2147],{"name":9,"slug":8,"type":13},{"name":2141,"slug":2142,"type":13},"Logs","logs",{"name":2144,"slug":2145,"type":13},"Metrics","metrics",{"name":2062,"slug":2063,"type":13},{"name":2148,"slug":2149,"type":13},"OpenTelemetry","opentelemetry",196,"https:\u002F\u002Fgithub.com\u002FClickHouse\u002Fclickhouse-docs","2026-06-11T08:25:17.959323",{"slug":2154,"name":2154,"fn":2155,"description":2156,"org":2157,"tags":2158,"stars":2167,"repoUrl":2168,"updatedAt":2169},"setup","set up ClickHouse MCP server connections","Guides users through setting up the ClickHouse MCP server connection bundled with this plugin. Use when the user first installs the plugin or has trouble connecting to ClickHouse.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2159,2160,2161,2164],{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"name":2162,"slug":2163,"type":13},"Local Development","local-development",{"name":2165,"slug":2166,"type":13},"MCP","mcp",4,"https:\u002F\u002Fgithub.com\u002FClickHouse\u002Fclickhouse-claude-code-plugin","2026-04-19T04:59:29.849185",12,{"items":2172,"total":2231},[2173,2181,2189,2197,2205,2213,2223],{"slug":1979,"name":1979,"fn":1980,"description":1981,"org":2174,"tags":2175,"stars":26,"repoUrl":27,"updatedAt":1995},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2176,2177,2178,2179,2180],{"name":9,"slug":8,"type":13},{"name":1986,"slug":1987,"type":13},{"name":1989,"slug":1990,"type":13},{"name":15,"slug":16,"type":13},{"name":1993,"slug":1994,"type":13},{"slug":1997,"name":1997,"fn":1998,"description":1999,"org":2182,"tags":2183,"stars":26,"repoUrl":27,"updatedAt":2007},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2184,2185,2186,2187,2188],{"name":9,"slug":8,"type":13},{"name":1986,"slug":1987,"type":13},{"name":1989,"slug":1990,"type":13},{"name":1993,"slug":1994,"type":13},{"name":24,"slug":25,"type":13},{"slug":2009,"name":2009,"fn":2010,"description":2011,"org":2190,"tags":2191,"stars":26,"repoUrl":27,"updatedAt":2021},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2192,2193,2194,2195,2196],{"name":2015,"slug":2016,"type":13},{"name":9,"slug":8,"type":13},{"name":1989,"slug":1990,"type":13},{"name":21,"slug":22,"type":13},{"name":15,"slug":16,"type":13},{"slug":4,"name":4,"fn":5,"description":6,"org":2198,"tags":2199,"stars":26,"repoUrl":27,"updatedAt":28},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2200,2201,2202,2203,2204],{"name":9,"slug":8,"type":13},{"name":18,"slug":19,"type":13},{"name":21,"slug":22,"type":13},{"name":15,"slug":16,"type":13},{"name":24,"slug":25,"type":13},{"slug":2031,"name":2031,"fn":2032,"description":2033,"org":2206,"tags":2207,"stars":26,"repoUrl":27,"updatedAt":2047},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2208,2209,2210,2211,2212],{"name":2037,"slug":2038,"type":13},{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"name":2042,"slug":2043,"type":13},{"name":2045,"slug":2046,"type":13},{"slug":2049,"name":2049,"fn":2050,"description":2051,"org":2214,"tags":2215,"stars":26,"repoUrl":27,"updatedAt":2071},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2216,2217,2218,2219,2220,2221,2222],{"name":9,"slug":8,"type":13},{"name":2056,"slug":2057,"type":13},{"name":2059,"slug":2060,"type":13},{"name":2062,"slug":2063,"type":13},{"name":15,"slug":16,"type":13},{"name":2066,"slug":2067,"type":13},{"name":2069,"slug":2070,"type":13},{"slug":2073,"name":2073,"fn":2074,"description":2075,"org":2224,"tags":2225,"stars":26,"repoUrl":27,"updatedAt":2089},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2226,2227,2228,2229,2230],{"name":2079,"slug":2080,"type":13},{"name":9,"slug":8,"type":13},{"name":21,"slug":22,"type":13},{"name":2084,"slug":2085,"type":13},{"name":2087,"slug":2088,"type":13},8]