# Kubeeye

Use when deploying KubeEye for cluster inspection, creating InspectRule/InspectPlan...

- Repository: https://github.com/kubesphere/kubesphere (17074 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-07-15
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add kubesphere/kubesphere --skill kubeeye -g -a claude-code -y`
Codex: `npx skills add kubesphere/kubesphere --skill kubeeye -g -a codex -y`
Cursor: `npx skills add kubesphere/kubesphere --skill kubeeye -g -a cursor -y`
Gemini CLI: `npx skills add kubesphere/kubesphere --skill kubeeye -g -a gemini-cli -y`

## Description

Use when deploying KubeEye for cluster inspection, creating InspectRule/InspectPlan resources, or retrieving inspection results. Covers InstallPlan-based deployment, OPA/PromQL/FileChange/Sysctl/Systemd/NodeInfo/FileFilter/ServiceConnect/CustomCommand rule types, and report retrieval. Always consult this skill when the user mentions KubeEye, cluster inspection, InspectRule, InspectPlan, or inspection reports.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# KubeEye

## Overview

KubeEye is a Kubernetes cluster inspection tool for KubeSphere. It detects issues in workloads, nodes, configurations, and components through OPA/Rego policies, PromQL queries, file integrity checks, kernel parameter validation, and systemd health checks. It is installed as a KubeSphere extension.

## When to Use

- Installing or configuring the KubeEye cluster inspection extension in KubeSphere
- Writing cluster inspection rules (OPA, PromQL, file checks, etc.)
- Configuring periodic or one-shot inspection tasks
- Viewing or downloading cluster inspection reports

## Architecture

### Extension Installation Flow

```
kspublish (push extension to KubeSphere)
    |
    v
Extension available in KubeSphere marketplace
    |
    v
kubectl apply -f installplan.yaml
    |
    v
KubeEye deployed (3 components)
```

### Runtime Architecture

The rest: https://github.com/kubesphere/kubesphere/blob/HEAD/skills/kubeeye/SKILL.md