ClickHouse best practices: 31 rules for schema design, query tuning, ingestion and agent connectivity
La discipline de revue officielle ClickHouse : 31 règles classées par impact avec checklists pour schémas, requêtes, inserts, plus un workflow sûr connecter → découvrir → interroger pour les agents
- Quoi
- La discipline de revue officielle ClickHouse : 31 règles classées par impact avec checklists pour schémas, requêtes, inserts, plus un workflow sûr connecter → découvrir → interroger pour les agents
- Coût
- Gratuit
- Prérequis
- une instance ClickHouse accessible à l'agent (serveur MCP ou CLI avec identifiants — accès à configurer vous-même) ; ClickHouse Cloud a un niveau gratuit et l'auto-hébergement est gratuit
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — la discipline de revue officielle @clickhouse pour les schémas, requêtes et configurations ClickHouse : 31 règles en 4 catégories (schéma, requête, insert, agent), classées par impact, avec des fichiers par règle que les agents DOIVENT lire avant de répondre. Les revues de schéma vérifient la planification du ORDER BY immuable, l'ordre des colonnes par cardinalité, les types natifs, la largeur de bits minimale, LowCardinality pour les colonnes texte, l'évitement de Nullable et les bornes de partition (100–1 000 valeurs) ; les revues de requêtes imposent le choix d'algorithme de JOIN, le filtrage avant jointure, les indices secondaires et l'alignement sur le préfixe ORDER BY ; les revues d'insertion exigent des lots de 10K–100K lignes, les inserts asynchrones pour les petites écritures fréquentes, et ReplacingMergeTree plutôt que ALTER UPDATE. Les agents reçoivent aussi un workflow de connectivité et de sécurité : connexion via MCP ou CLI, découverte de schéma en 7 étapes (bases → tables → colonnes → clés de tri → indices → échantillon → EXPLAIN), puis exécution avec LIMITs et timeouts, filtres resserrés en cas d'erreur de timeout ou mémoire. Format de sortie standard (règles vérifiées → violations → conformes → recommandations) avec citations « Per rule-name... ». Bémols honnêtes : un corpus de règles exhaustif — les revues complètes coûtent cher en tokens sur de grands patrimoines ; le skill suppose que l'agent peut joindre une instance ClickHouse (identifiants MCP/CLI), à configurer vous-même. Licence Apache-2.0. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage. Découvert via skills.sh.
Version :
Réponse rapide
ClickHouse best practices: 31 rules for schema design, query tuning, ingestion and agent connectivity est un skill gratuit pour Muse qui donne la discipline de revue officielle ClickHouse: 31 règles classées par impact avec checklists pour schémas, requêtes et inserts, plus un workflow sûr connecter, découvrir et interroger pour les agents, pour que les revues suivent la priorité, pas l'habitude.
Installation
Copiez le dossier d’installation ci-dessous, puis collez-le dans Muse🧪 Installation exécutée dans notre sandbox de test · 11 nov. 2026📌 Version épinglée : commit 356a8c1Étape 0 — avant d'installer quoi que ce soit : lis ce prompt d'installation, résume en quelques lignes ce que ce build fait et ce que l'installation implique, puis demande-moi de confirmer avant de continuer. Prérequis : une instance ClickHouse accessible à l'agent (serveur MCP ou CLI avec identifiants — accès à configurer vous-même) ; ClickHouse Cloud a un niveau gratuit et l'auto-hébergement est gratuit Installe-moi « Bonnes pratiques ClickHouse : 31 règles de conception de schéma, optimisation de requêtes, ingestion et connectivité d'agents ». Il donne à mon agent la discipline de revue officielle ClickHouse : 31 règles classées par impact (planification de la clé primaire, types de données, partitionnement, optimisation des JOINs, indices secondaires, batch d'inserts, inserts async, évitement des mutations), des checklists procédurales de revue de schéma/requête/insert avec un format de sortie Règles vérifiées → Violations → Recommandations, plus le workflow de connectivité agent (connexion via MCP/CLI, découverte de schéma en 7 étapes, planification avec les clés de tri, exécution avec LIMITs et timeouts, récupération en resserrant les filtres). Les fichiers de règles sont cités « Per rule-name... » dans les réponses. Licence Apache-2.0. Dépôt : https://raw.githubusercontent.com/clickhouse/agent-skills/356a8c1b9a7392adb389a132f5ad3fec38532a03/skills/clickhouse-best-practices/SKILL.md Version épinglée : installe le code au commit 356a8c1b9a7392adb389a132f5ad3fec38532a03 exactement (Skill Harbor a testé cette version). Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Récupère le fichier SKILL.md (et les fichiers d'aide éventuels) depuis le chemin du dépôt dans un dossier temporaire 2. Vérification de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants). Ce dépôt ne devrait contenir aucun secret en dur, les identifiants uniquement via le coffre sécurisé, les hôtes autorisés déclarés dans le SKILL.md. Vérifie que c'est bien le cas ici ; STOP sur tout signal d'alerte et dis-le-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers d'aide dans le répertoire des skills de l'agent, dans un dossier nommé « clickhouse-best-practices ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (p. ex. configurer mon accès ClickHouse MCP ou CLI avec identifiants, puis demander à l'agent de suivre le workflow connecter → découvrir → interroger du skill). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.
Enregistré dans vos installs récentes. Retrouvez-le à tout moment sur /connect.
🔒 Sécurité, provenance et ce que ça touche
Le prompt d'installation ci-dessous inclut déjà les étapes de vérification : votre agent suit la checklist communautaire avant d'installer tout ce qui contient du code exécutable. Vous en voulez plus ?
Certificat de vérification
Faits datés sur ce qui a été vérifié pour cette fiche, et comment. Ce n’est pas une certification de sécurité.
- Version épinglée
- 356a8c1 · 2026-10-13
- Test d’installation en sandbox
- Installation exécutée dans notre sandbox de test · 11 nov. 2026 · Observé pendant le test d’installation: registry.npmjs.org
- Identité du créateur
- Non vérifiée
- Veille d’empreinte
- Dernière vérification · 19 nov. 2026 : aucun changement détecté dans les fichiers liés par ce prompt d’installation
- Analyse du prompt d’installation
- 2026-10-13 : Aucune commande, appel réseau, paquet, écriture de fichier ni clé API détecté.
Skill Harbor ne révise jamais le code des skills listés. Ce sont des faits datés sur le prompt d’installation et notre test d’installation, pas une certification de sécurité. Révisez un skill vous-même avant de l’installer. Comment nous vérifions
Questions
Comment installer un skill ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe le skill pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours un skill avant de l’installer.