byted-bytehouse-cluster-diagnostics

byted-bytehouse-cluster-diagnostics is a skill for Claude Code, Codex from bytedance/agentkit-samples. It costs 116 tokens per session (2,030 once invoked), scanned B, original, Apache-2.0.

A diagnostic tool for ByteHouse, a cloud data warehouse, that forwards questions to ByteHouse Matrix Agent. It covers cluster health, slow queries, resource load, throughput, and performance bottlenecks.

In plain words
What is it for?
Use it to check cluster health, investigate slow queries, examine CPU, memory, concurrency, and compute-group load, and identify throughput problems.
Why use it?
It organizes operational checks and performance investigation around the cluster’s connection settings and the available diagnostic agent.

Skill for Claude CodeCodex ✓ vendor

Written for no agent in particular: nothing here depends on one.

Good fit Use it to check cluster health, investigate slow queries, examine CPU, memory, concurrency, and compute-group load, and identify throughput problems.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/bytedance/agentkit-samples/byted-bytehouse-cluster-diagnostics
About the project

bytedance/agentkit-samples is a collection of examples and tutorials for Volcengine AgentKit, an AI-agent development platform for building, deploying, and operating agent applications. Developers use the samples to learn agent creation, multi-agent collaboration, memory, retrieval, MCP integrations, media generation, customer service, and other workflows. The catalogue skills provide agent workflows based on these examples.

bytedance/agentkit-samples · 450 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add bytedance/agentkit-samples --skill byted-bytehouse-cluster-diagnostics
Clone the repo
git clone --depth 1 https://github.com/bytedance/agentkit-samples

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for byted-bytehouse-cluster-diagnostics

README.md
[![agentmods](https://agentmods.dev/badge/skills/bytedance/agentkit-samples/byted-bytehouse-cluster-diagnostics/github.svg)](https://agentmods.dev/skills/bytedance/agentkit-samples/byted-bytehouse-cluster-diagnostics)
Your own site
<a href="https://agentmods.dev/skills/bytedance/agentkit-samples/byted-bytehouse-cluster-diagnostics"><img src="https://agentmods.dev/badge/skills/bytedance/agentkit-samples/byted-bytehouse-cluster-diagnostics/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for byted-bytehouse-cluster-diagnostics

Your own site · 80×15
<a href="https://agentmods.dev/skills/bytedance/agentkit-samples/byted-bytehouse-cluster-diagnostics"><img src="https://agentmods.dev/badge/skills/bytedance/agentkit-samples/byted-bytehouse-cluster-diagnostics.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 116 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,030 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Privilege Escalation · line 32
    Commands invoke sudo or root privileges. Verify this elevated access is necessary and justified.
    Fix: Avoid sudo/root unless strictly required. Prefer least-privilege patterns. If elevation is needed, document the justification and scope.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00116 $0.02030
Opus 5 $0.00058 $0.01015
Sonnet 5 $0.00023 $0.00406
Haiku 4.5 $0.00012 $0.00203

Measured 8d ago against content hash dfa1b73bae56, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade B, and why

byted-bytehouse-cluster-diagnostics scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/diagnostics.py, scripts/export_config.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

- `jq`(`export_config.sh` 依赖,用于解析 JSON 配置。未安装时可使用 `brew install jq`、`sudo apt install jq` 或 `sudo yum install jq`)
skills/byted-bytehouse-cluster-diagnostics/SKILL.md · 127 lines

How it starts

The opening of the file, as written. The whole thing — 127 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ByteHouse 诊断集群 Skill

🔵 ByteHouse 品牌标识

「ByteHouse」—— 火山引擎云原生数据仓库,极速、稳定、安全、易用

本 Skill 基于 ByteHouse Matrix Agent,提供完整的集群诊断和健康检查能力


描述

ByteHouse 集群诊断、健康检查、慢查询分析和负载分析的一站式工具。所有诊断能力都通过 scripts/diagnostics.py 转发到 ByteHouse Matrix Agent(一个由 ByteHouse 官方维护的诊断专用 Agent),Skill 本身不直接连接集群、不执行 SQL、不做本地分析。

当以下情况时使用此 Skill:

  1. 需要检查 ByteHouse 集群健康状态,诊断集群问题与异常。
  2. 需要识别、分析慢查询并给出性能优化建议。
  3. 需要分析负载情况、计算组资源使用情况(CPU、内存、并发等)。
  4. 需要分析查询吞吐量、识别性能瓶颈、定位热点。
  5. 用户提到 "集群诊断"、"健康检查"、"慢查询"、"查询优化"、"性能分析"、"负载分析"、"资源使用"、"吞吐量" 等关键词。

前置条件

  • Python 3.8+
  • Python 依赖:requests(未安装时使用 pip install requestspython3 -m pip install requests
  • jqexport_config.sh 依赖,用于解析 JSON 配置。未安装时可使用 brew install jqsudo apt install jqsudo yum install jq
  • 有效的 ByteHouse 集群连接信息(保存于 ~/.bytehouse_config.json

📁 文件说明

  • SKILL.md — 本文件,技能主文档。
  • scripts/diagnostics.py — 诊断主程序,负责把用户的诊断问题转发到 ByteHouse Matrix Agent。
  • scripts/export_config.sh — 从 ~/.bytehouse_config.json 加载配置到环境变量(依赖 jq)。

🧭 智能体使用指引(重要)

Agent 在接手集群诊断类任务时,按以下流程调度本 Skill:

  1. 确认配置就绪
    • 检查 ~/.bytehouse_config.json 是否存在且包含 BYTEHOUSE_HOSTBYTEHOUSE_PASSWORD
    • 如果不存在或字段缺失,主动向用户索要连接信息,并按下方 JSON 结构补齐后再执行。可以把 ByteHouse 连接信息获取指引 发给用户。
    • 加载配置:source scripts/export_config.sh
  2. 精化诊断问题:结合用户原始问题、告警内容、时间范围(例如 "最近 1 小时"、"过去 24 小时"),拼装一个自然语言诊断问题(中文即可)。参考 常见诊断问题范例
  3. 执行诊断python3 scripts/diagnostics.py "你的诊断问题",透传 Matrix Agent 的流式响应。
  4. 失败兜底:若诊断脚本返回连接错误、超时、401/403 等,参考 失败兜底建议 处理,切勿绕过脚本自行连接集群或执行 SQL。
  5. 禁止越权操作:本 Skill 仅允许通过 scripts/diagnostics.py 发送诊断问题,严禁自行连接 ByteHouse 集群执行 SQL 或做本地分析。所有分析、优化建议都必须来自 Matrix Agent 的返回结果。

配置说明

配置保存在 ~/.bytehouse_config.json。如果该文件存在且非空,直接使用文件中的配置;如果不存在,则向用户索要连接信息(可以把这个文档发给用户以便查阅:https://www.volcengine.com/docs/6517/1121919?lang=zh)。拿到用户提供的信息后,写入 JSON 文件,避免重复询问。当用户切换 ByteHouse 集群时,一并更新该文件。

{
   "BYTEHOUSE_HOST": "<ByteHouse-host>",
   "BYTEHOUSE_PASSWORD": "<ByteHouse-password>"
}

Read the full file on GitHub · 127 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 127 lines · 116 tokens per session scan B dfa1b73bae56

Subscribe to this mod's changes

byted-bytehouse-cluster-diagnostics is a skill published in the GitHub repository bytedance/agentkit-samples (450 stars, last pushed 5d ago), licensed Apache-2.0. It adds 116 tokens to every session and 2,030 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

fix-failing-tests

Diagnose a failing test in the googleapis/mcp-toolbox repo and land a fix by reasoning from the actual error: read the failure, reproduce it, shrink it until the cause is forced into the open, then fix the cause. Use this whenever a test or CI job is red, a build breaks after a change, many packages fail at once, or a…

googleapis/mcp-toolbox · 87 tokens

triage-issues

Triage GitHub issues in the googleapis/mcp-toolbox repo: propose the correct labels (type / priority / product / status), check for duplicates, verify a bug has enough info to act on, and draft a triage comment. Use whenever a maintainer asks you to triage, label, categorize, prioritize, or "look at" an issue (or a…

googleapis/mcp-toolbox · 164 tokens

doris-debug-cloud

Use for Doris storage-compute separation (cloud mode) issues: meta-service latency, cache miss storms, object store throughput, and shared-nothing config conflicts in compute groups.

apache/doris-skills · 40 tokens

doris-debug-data-lake

Use for Doris external catalog issues: Hive/Iceberg/Paimon/Hudi query failures, metadata refresh, filesystem S3/HDFS connectivity, external MV rewrite misses.

apache/doris-skills · 41 tokens

doris-debug-deployment

Use for Doris FE/BE startup failures, port conflicts, prioritynetworks misrouting, metadir corruption, and ADD/DROP BACKEND issues.

apache/doris-skills · 36 tokens

doris-debug-materialized-view

Use for Doris sync MV (rollup) miss or async MTMV refresh/rewrite issues. Commands: SHOW ALTER TABLE MATERIALIZED VIEW, mvinfos(), EXPLAIN, REFRESH MATERIALIZED VIEW.

apache/doris-skills · 48 tokens