# diagnose

> Claude/Codex skill by [@zilliztech](https://omgskills.com/library/zilliztech/index.md) · 3 stars · Updated 2026-10-23

Use when the user reports that a Zilliz Cloud cluster or Milvus collection is unhealthy, slow, stuck, returning errors, hitting quotas, or otherwise misbehaving — or when they ask "what's wrong with...", "why is ... slow", "diagnose ...", "troubleshoot ...".

Tags: claude-code, claude-code-skill, codex, openai, plugin, skill, vector-database, zilliz, zilliz-cloud

## Install

```sh
git clone https://github.com/zilliztech/zilliz-plugin /tmp/zilliz-plugin && ln -s /tmp/zilliz-plugin/plugins/zilliz/skills/diagnose ~/.claude/skills/diagnose
```

## From README

Prerequisites CLI installed and logged in (see skill). For cluster diagnosis: a cluster context, or pass --cluster-id explicitly. For collection diagnosis: the cluster context must point at the cluster that owns the collection (see skill). Scope This skill performs read-only diagnosis using existing zilliz commands. It does NOT mutate clusters, collections, indexes, or data. Every recommendation is presented as a suggestion plus the exact next command the user can run themselves. Two entry points: | User says | Use section | |---|---| | "diagnose my cluster", "cluster is slow / stuck / unhealthy" | Cluster Diagnosis | | "diagnose this collection", "search is slow on X", "X won't load" | Collection Diagnosis | When the user's intent spans both (e.g. "everything is slow"), run cluster diagnosis first — a collection-level symptom often has a cluster-level cause. Cluster Diagnosis Follow this checklist in order.

## Links

- HTML page: https://omgskills.com/library/zilliztech/zilliz-plugin/plugins/zilliz/skills/diagnose/
- GitHub: https://github.com/zilliztech/zilliz-plugin
- Author: [@zilliztech](https://omgskills.com/library/zilliztech/index.md)

## More from this repo

- [acl](https://omgskills.com/library/zilliztech/zilliz-plugin/plugins/zilliz/skills/acl/index.md) — Used when the user wants to manage Zilliz Cloud access control -- custom org or project roles and their policies,...
   - [@zilliztech](https://omgskills.com/library/zilliztech/index.md) · 3 stars
- [ask-zilliz](https://omgskills.com/library/zilliztech/zilliz-plugin/plugins/zilliz/skills/ask-zilliz/index.md) — Zilliz Cloud onboarding and usage assistant.
   - [@zilliztech](https://omgskills.com/library/zilliztech/index.md) · 3 stars
- [backup](https://omgskills.com/library/zilliztech/zilliz-plugin/plugins/zilliz/skills/backup/index.md) — Used when the user wants to create, list, describe, delete, export, or restore backups, or manage backup policies on...
   - [@zilliztech](https://omgskills.com/library/zilliztech/index.md) · 3 stars